הגדרת POP ו-IMAP באמצעות Gmail API

במאמר הזה מוסבר איך לנהל פרוטוקולים של POP ו-IMAP באמצעות Gmail API.

‫POP ו-IMAP הן שתי דרכים שבאמצעותן אפשר לקרוא הודעות Gmail בתוכנות אימייל אחרות. ‫POP הוא פרוטוקול ישן יותר שמיועד למחשב אחד. ב-POP, הלקוח שלכם מוריד את ההודעות, ואתם בוחרים באיזו תדירות להוריד הודעות חדשות. פרוטוקול IMAP פועל במספר מכשירים ומסנכרן את ההודעות בזמן אמת.

אפשר להשתמש במשאב settings של Gmail API כדי להגדיר איך Gmail מטפל בפרוטוקולי POP ו-IMAP:

פופ

אפשר לנהל את הגדרות POP של חשבון באמצעות אובייקט PopSettings.

הפעלה והשבתה של הגישה

שליטה בגישה באמצעות השדה accessWindow. השדה הזה קובע אם פרוטוקול POP מופעל ואילו הודעות ה-API מאחזר.

ערך השפעה
disabled אין אפשרות לגשת להודעות דרך POP
allMail כל ההודעות שלא נמשכו נגישות דרך POP
fromNowOn אפשר לגשת רק להודעות חדשות דרך POP

הטיפול בהודעה

מגדירים את הטיפול בהודעות שה-API מאחזר באמצעות השדה 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 יבקש במפורש להסיר אותן.