إدارة بروتوكولَي POP وIMAP
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك استخدام الإعدادات لضبط سلوك Gmail عند الوصول إليه عبر بروتوكولَي POP وIMAP.
للحصول على معلومات حول كيفية استخدام
getPop أو
updatePop أو
getImap أو
updateImap، راجِع
مرجع الإعدادات.
POP
تفعيل إمكانية الوصول وإيقافها
يمكنك التحكّم في الوصول عبر بروتوكول POP باستخدام السمة accessWindow
. لا تحدّد السمة ما إذا كان بروتوكول POP مفعَّلاً أم لا، بل تحدّد أيضًا الرسائل التي يمكن استردادها.
القيمة |
التأثير |
disabled |
لا يمكن الوصول إلى الحساب عبر بروتوكول POP |
allMail |
تتوفّر جميع الرسائل |
fromNowOn |
تتوفر الرسائل الجديدة فقط |
طريقة عرض الرسائل
يمكنك ضبط طريقة التعامل مع الرسائل التي يتم استردادها عبر POP باستخدام السمة disposition
.
القيمة |
التأثير |
archive |
نقل الرسائل خارج البريد الوارد |
leaveInInbox |
عدم اتّخاذ أي إجراء وترك الرسائل غير مقروءة في البريد الوارد |
markRead |
وضع علامة "مقروءة" على الرسائل |
trash |
ينقل الرسالة إلى المهملات |
الوصول عبر IMAP
تفعيل إمكانية الوصول وإيقافها
يمكنك التحكّم في الوصول عبر IMAP من خلال ضبط السمة enabled
على true
أو false
لتفعيل الوصول أو إيقافه على التوالي.
حالة الرسالة
لضبط حالة الرسائل المحذوفة، استخدِم السمة expungeBehavior
.
القيمة |
التأثير |
archive |
نقل الرسائل خارج البريد الوارد |
deleteForever |
حذف الرسالة نهائيًا |
trash |
ينقل الرسالة إلى المهملات |
بالإضافة إلى ذلك، إذا تم ضبط السمة autoExpunge
على true
، يتم تنفيذ هذه الإجراءات فورًا عند حذف الرسالة عبر بروتوكول IMAP. وبخلاف ذلك،
تُترك الرسائل إلى أن يتم طلبها صراحةً من برنامج IMAP.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-01 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-01 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Managing POP and IMAP\n\nYou can use [Settings](/workspace/gmail/api/reference/rest/v1/users.settings) to configure\nthe behavior of Gmail when accessed via the POP and IMAP protocols.\n\nFor information on how to\n[getPop](/workspace/gmail/api/reference/rest/v1/users.settings/getPop),\n[updatePop](/workspace/gmail/api/reference/rest/v1/users.settings/updatePop),\n[getImap](/workspace/gmail/api/reference/rest/v1/users.settings/getImap),\nor [updateImap](/workspace/gmail/api/reference/rest/v1/users.settings/updateImap), see\nthe [Settings reference](/workspace/gmail/api/reference/rest/v1/users.settings).\n\nPOP\n---\n\n### Enabling and disabling access\n\nYou can control POP access with the `accessWindow` property. The property not\nonly determines whether or not POP is enabled, but also which messages may be\nretrieved.\n\n| Value | Effect |\n|-------------|---------------------------------|\n| `disabled` | No POP access |\n| `allMail` | All messages are available |\n| `fromNowOn` | Only new messages are available |\n\n### Message disposition\n\nYou can configure the disposition of messages retrieved via POP with\nthe `disposition` property.\n\n| Value | Effect |\n|----------------|------------------------------------------------|\n| `archive` | Move messages out of the inbox |\n| `leaveInInbox` | Do nothing, leave messages unread in the inbox |\n| `markRead` | Mark the messages as read |\n| `trash` | Moves the message to the trash |\n\nIMAP\n----\n\n### Enabling and disabling access\n\nYou can control IMAP access by setting the `enabled` property to `true`\nor `false`, to enable or disable access respectively.\n\n### Message Disposition\n\nTo set the disposition for deleted messages, use the `expungeBehavior` property.\n\n| Value | Effect |\n|-----------------|--------------------------------|\n| `archive` | Move messages out of the inbox |\n| `deleteForever` | Permanently delete the message |\n| `trash` | Moves the message to the trash |\n\nAdditionally, if the `autoExpunge` property is set to `true` these actions\nare performed immediately when the message is deleted via IMAP. Otherwise\nmessages are left until explicitly requested from the IMAP client."]]