تنظیمات POP و IMAP را با Gmail API پیکربندی کنید

این سند نحوه مدیریت پروتکل‌های POP و IMAP را با استفاده از Gmail API توضیح می‌دهد.

POP و IMAP دو روش برای خواندن پیام‌های Gmail شما در سایر سرویس‌دهندگان ایمیل هستند. POP یک پروتکل قدیمی است که برای یک رایانه طراحی شده است. با POP، سرویس‌گیرنده شما پیام‌ها را دانلود می‌کند و شما انتخاب می‌کنید که هر چند وقت یکبار پیام‌های جدید را دانلود کند. IMAP در چندین دستگاه کار می‌کند و پیام‌ها را به صورت آنی همگام‌سازی می‌کند.

شما می‌توانید از منبع settings Gmail API برای پیکربندی نحوه مدیریت پروتکل‌های POP و IMAP توسط Gmail استفاده کنید:

پاپ

شما می‌توانید تنظیمات POP را برای یک حساب کاربری با استفاده از شیء PopSettings مدیریت کنید.

فعال و غیرفعال کردن دسترسی

دسترسی را با فیلد accessWindow کنترل کنید. این فیلد تعیین می‌کند که آیا POP فعال است یا خیر و API کدام پیام‌ها را بازیابی می‌کند.

ارزش اثر
disabled هیچ پیامی از طریق POP قابل دسترسی نیست
allMail تمام پیام‌های واکشی نشده از طریق POP قابل دسترسی هستند.
fromNowOn فقط پیام‌های جدید از طریق POP قابل دسترسی هستند

وضعیت پیام

وضعیت پیام‌هایی را که API بازیابی می‌کند با فیلد disposition پیکربندی کنید.

ارزش اثر
archive انتقال پیام‌ها از INBOX
leaveInInbox هیچ کاری نکنید؛ پیام‌ها را در INBOX نخوانده بگذارید
markRead پیام‌ها را در INBOX بگذارید و آنها را به عنوان خوانده شده علامت بزنید
trash انتقال پیام‌ها به TRASH

آیمپ

شما می‌توانید تنظیمات IMAP را برای یک حساب کاربری با استفاده از شیء ImapSettings مدیریت کنید.

فعال و غیرفعال کردن دسترسی

از فیلد بولی enabled برای کنترل دسترسی استفاده کنید. این فیلد تعیین می‌کند که آیا IMAP برای حساب فعال است یا خیر.

وضعیت پیام

از فیلد expungeBehavior برای پیکربندی وضعیت یک پیام هنگامی که کلاینت آن را به عنوان حذف شده علامت‌گذاری می‌کند و از آخرین پوشه IMAP قابل مشاهده حذف می‌کند، استفاده کنید.

ارزش اثر
archive پیام‌های علامت‌گذاری شده به عنوان حذف شده را از INBOX خارج کنید
deleteForever پیام‌های علامت‌گذاری شده به عنوان حذف شده را برای همیشه حذف کنید
trash پیام‌های علامت‌گذاری شده به عنوان حذف شده را به TRASH منتقل کنید

اگر فیلد بولی autoExpunge true باشد، جیمیل بلافاصله پس از علامت‌گذاری یک پیام به عنوان حذف‌شده در IMAP توسط کلاینت، آن را حذف می‌کند. در غیر این صورت، پیام‌ها تا زمانی که کلاینت IMAP صریحاً درخواست حذف آنها را ندهد، باقی می‌مانند.