ضبط إعدادات POP وIMAP باستخدام Gmail API

يوضّح هذا المستند كيفية إدارة بروتوكولَي POP وIMAP باستخدام Gmail API.

بروتوكولا POP وIMAP هما طريقتان لقراءة رسائل Gmail في برامج البريد الإلكتروني الأخرى. بروتوكول POP هو بروتوكول قديم مصمّم لجهاز كمبيوتر واحد. باستخدام بروتوكول POP، ينزّل برنامج البريد الرسائل، ويمكنك اختيار عدد مرّات تنزيل الرسائل الجديدة. يعمل بروتوكول IMAP على أجهزة متعددة ويُزامِن الرسائل في الوقت الفعلي.

يمكنك استخدام مورد settings في Gmail API لتحديد طريقة تعامل Gmail مع بروتوكولَي POP وIMAP:

POP

يمكنك إدارة إعدادات POP لحساب باستخدام عنصر PopSettings.

تفعيل إمكانية الوصول وإيقافها

التحكّم في إمكانية الوصول باستخدام الحقل accessWindow يحدّد هذا الحقل ما إذا كان بروتوكول POP مفعّلاً والرسائل التي تستردّها واجهة برمجة التطبيقات.

القيمة التأثير
disabled لا يمكن الوصول إلى أي رسائل من خلال POP
allMail يمكن الوصول إلى جميع الرسائل التي لم يتم استرجاعها من خلال بروتوكول POP
fromNowOn لا يمكن الوصول إلى الرسائل الجديدة إلا من خلال POP

طريقة عرض الرسائل

اضبط حالة الرسائل التي تستردّها واجهة برمجة التطبيقات باستخدام الحقل disposition.

القيمة التأثير
archive نقل الرسائل من INBOX
leaveInInbox عدم اتّخاذ أي إجراء وترك الرسائل غير مقروءة في INBOX
markRead ترك رسائل في INBOX ووضع علامة "مقروءة" عليها
trash نقل الرسائل إلى TRASH

الوصول عبر IMAP

يمكنك إدارة إعدادات IMAP لحساب باستخدام عنصر ImapSettings.

تفعيل إمكانية الوصول وإيقافها

استخدِم الحقل المنطقي enabled للتحكّم في إذن الوصول. يحدّد هذا الحقل ما إذا كان الوصول عبر IMAP مفعّلاً للحساب.

طريقة عرض الرسائل

استخدِم الحقل expungeBehavior لإعداد طريقة التعامل مع الرسالة عندما يضع العميل علامة عليها بأنّها محذوفة ويحذفها من آخر مجلد IMAP مرئي.

القيمة التأثير
archive نقل الرسائل التي تم وضع علامة "محذوفة" عليها خارج INBOX
deleteForever حذف الرسائل التي تم وضع علامة عليها كرسائل محذوفة نهائيًا
trash نقل الرسائل التي تم وضع علامة "محذوفة" عليها إلى TRASH

إذا كان حقل القيمة المنطقية autoExpunge هو true، يزيل Gmail الرسالة فورًا عندما يضع العميل علامة عليها كرسالة محذوفة في IMAP. بخلاف ذلك، تظل الرسائل إلى أن يطلب برنامج IMAP إزالتها صراحةً.