تنظیمات 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 صریحاً درخواست حذف آنها را ندهد، باقی می‌مانند.