تختلف طرق الوصول إلى Gmail (تسجيل الدخول عبر الويب، IMAP، وAPI) في آلية عملها وحالات الاستخدام. إليك الفروقات الرئيسية:

عندما يحاول سكريبت قراءة رسالة تحقق بشكل تلقائي، وتُدخل اسم المستخدم وكلمة المرور في عميل IMAP، قد تفاجأ برسالة خطأ في تسجيل الدخول — المشكلة ليست في بيانات الحساب، بل في اختيار طريقة الاتصال الخاطئة. حساب Gmail يمكن استخدامه بأكثر من طريقة: تسجيل الدخول عبر الويب، IMAP/SMTP، وGmail API. كل طريقة لها متطلباتها وإمكانياتها المختلفة، واختيار الطريقة الخاطئة لا يعني أن الحساب معطل، بل أن طريقة الاتصال غير مناسبة.

ما هي طرق الاتصال الثلاث؟

الطريقة	الجوهر	ما يحتاجه الحساب
تسجيل الدخول عبر الويب	فتح gmail.com في المتصفح واتباع عملية تسجيل الدخول العادية	كلمة المرور + التحقق بخطوتين (إذا كان مفعّلاً)، قد يظهر رمز تحقق أو كشف تسجيل دخول غير عادي
IMAP/SMTP	عميل البريد (Outlook، Thunderbird، مكتبات السكريبتات) يستخدم بروتوكولات البريد لإرسال واستقبال الرسائل	يجب تفعيل التحقق بخطوتين أولاً، ثم إنشاء "كلمة مرور تطبيق" مخصصة، واستخدامها بدلاً من كلمة مرور الحساب الأساسية
Gmail API	واجهة برمجية رسمية من Google تستخدم OAuth2 للحصول على رمز وصول، ويستخدمه البرنامج لقراءة وكتابة البريد	يتطلب إنشاء مشروع في Google Cloud، وإعداد عميل OAuth، واتباع عملية موافقة للحصول على الرمز

تسجيل الدخول عبر الويب: الأكثر وضوحاً، لكنه غير مناسب للأتمتة

التشغيل اليدوي لا مشكلة فيه، لكن محاكاة السكريبت لتسجيل الدخول عبر الويب ستواجه باستمرار رموز تحقق، رسائل تسجيل دخول غير عادي، وحتى طلب التحقق عبر الهاتف — Google لديها نظام حماية خاص بها ضد السلوك الذي يبدو "آلياً" في تسجيل الدخول، وهذه ليست مشكلة في الحساب، بل عدم توافق طريقة الدخول مع الاستخدام.

IMAP/SMTP: مناسب لعملاء البريد والسكريبتات الخفيفة

هذه هي الطريقة الأقرب إلى "إرسال واستقبال البريد التقليدي"، وتدعمها معظم عملاء البريد ومكتبات Python/Node. النقطة الأساسية: يجب تفعيل التحقق بخطوتين أولاً، ثم استخدام "كلمة مرور التطبيق" الناتجة عنه لتسجيل الدخول إلى IMAP، ولا يمكن استخدام كلمة مرور الحساب الأساسية مباشرة — Google تطلب هذه الخطوة حالياً لمعظم حسابات المستهلكين، ومحاولة استخدام كلمة المرور الأساسية مع IMAP ستؤدي على الأرجح إلى الرفض.

إذا رأيت حقل "كلمة مرور التطبيق" في قائمة الحساب، فهذا يعني أن الحساب قد أعدّ كلمة مرور التطبيق مسبقاً، ويمكنك استخدامها مباشرة مع IMAP دون الحاجة إلى تفعيل التحقق بخطوتين وإنشاء كلمة مرور جديدة بنفسك.

Gmail API: مناسب للتكامل البرمجي الرسمي

Gmail API يعمل عبر تفويض OAuth2، حيث يحصل البرنامج على رمز وصول بنطاق صلاحيات محدد، وليس على كلمة مرور الحساب نفسها. الميزة هي أن الصلاحيات يمكن التحكم بها بدقة (مثل القراءة فقط دون تعديل)، ويمكن إلغاء الرمز بشكل منفصل دون التأثير على كلمة مرور الحساب، مما يجعله مناسباً للتشغيل الطويل والمستقر وللحالات التي تتطلب إدارة صلاحيات دقيقة. الثمن هو تكلفة إعداد أعلى، حيث يتطلب تسجيل تطبيق في Google Cloud وإعداد بيانات الاعتماد، ولا يمكن استخدامه مباشرة بمجرد الحصول على الحساب.

كيف تختار بين الثلاث؟

• للاستخدام اليدوي العرضي فقط: تسجيل الدخول عبر الويب كافٍ، لا داعي لتعقيد الأمور.
• لسكريبت يقرأ رموز التحقق أو يرسل رسائل بشكل دوري وبسيط: IMAP/SMTP + كلمة مرور التطبيق، وإذا كان الحساب يحتوي على هذا الحقل، يمكن استخدامه مباشرة.
• للتكامل في منتج رسمي، تشغيل طويل، وتحكم دقيق في الصلاحيات: Gmail API، الإعداد الأولي أكثر تعقيداً لكن التشغيل اللاحق أكثر استقراراً.

المشاكل الشائعة

• استخدام كلمة مرور الحساب مباشرة مع IMAP يؤدي إلى خطأ. على الأرجح الحساب لم يفعل التحقق بخطوتين أو لم ينشئ كلمة مرور تطبيق. سجل الدخول عبر الويب، فعّل التحقق بخطوتين، ثم أنشئ كلمة مرور تطبيق وحاول مرة أخرى.
• محاكاة السكريبت لتسجيل الدخول عبر الويب تؤدي إلى طلب تحقق غير عادي. استخدم IMAP أو Gmail API بدلاً من ذلك، ولا تحاول اختراق عملية تسجيل الدخول عبر الويب بالسكريبت.
• انتهاء صلاحية رمز Gmail API أو عدم كفاية الصلاحيات. تحقق من نطاق الصلاحيات الذي اخترته عند الطلب ليشمل الواجهات التي تريد استخدامها. إذا انتهت صلاحية الرمز، استخدم رمز التحديث (refresh token) للحصول على رمز جديد، وليس لأن الحساب نفسه به مشكلة.

القيود التي يجب معرفتها قبل الشراء

• إمكانية استخدام طرق الاتصال الثلاث بنجاح لا تعتمد فقط على اكتمال حقول الحساب، بل أيضاً على سياسات Google المتغيرة، ولا يمكن ضمان ثباتها على المدى الطويل.
• كلمة مرور التطبيق ورمز OAuth قد يبطلان بسبب تغيير كلمة المرور أو فحص أمان الحساب، وعندها يجب إعادة إنشائهما.
• طريقة الاتصال التي يدعمها حساب معين، يعتمد على الوصف في صفحة المنتج.

الأسئلة الشائعة

هل يمكنني تفعيل كلمة مرور التطبيق بنفسي إذا لم يكن الحساب يحتوي على هذا الحقل؟ نعم، بشرط أن تتمكن من تسجيل الدخول عبر الويب بشكل طبيعي وتفعيل التحقق بخطوتين. بعد تفعيله، يمكنك إنشاء كلمة مرور تطبيق في إعدادات أمان الحساب، وهي نفس آلية التحقق بخطوتين المذكورة في مقال العلاقة بين حساب Google وحساب Gmail.

هل يمكن استخدام IMAP وGmail API في نفس الوقت على حساب واحد؟ نعم، لا يتعارضان، حيث يستخدم كل منهما بيانات اعتماد مختلفة (كلمة مرور تطبيق مقابل رمز OAuth)، ولا يؤثر أحدهما على الآخر.

لماذا تحتاج صلاحيات Gmail API إلى إعادة تفويض بعد فترة؟ رموز OAuth لها صلاحية محدودة. الإجراء الطبيعي هو استخدام رمز التحديث (refresh token) للحصول على رمز وصول جديد بشكل تلقائي. إذا أصبح رمز التحديث غير صالح أيضاً (مثل تغيير كلمة مرور الحساب)، عندها سيحتاج المستخدم إلى إعادة عملية الموافقة مرة أخرى.