ضبط إعدادات 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 مفعَّلاً للحساب.

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

ضبط إجراء الرسالة عند وضع علامة عليها كرسالة محذوفة وحذفها نهائيًا من آخر مجلد IMAP مرئي باستخدام الحقل expungeBehavior

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

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