本文說明如何使用 Gmail API 管理 POP 和 IMAP 通訊協定。
POP 和 IMAP 都是透過其他電子郵件用戶端讀取 Gmail 郵件的方式。POP 是較舊的通訊協定，專為單一電腦設計。使用 POP 時，用戶端會下載郵件，你可以選擇下載新郵件的頻率。IMAP 可在多部裝置上運作，並即時同步處理郵件。
您可以使用 Gmail API 的 settings 資源，設定 Gmail 處理 POP 和 IMAP 通訊協定的方式：
POP
您可以使用 PopSettings 物件管理帳戶的 POP 設定。
啟用及停用存取權
使用
accessWindow
欄位控管存取權。這個欄位會決定是否啟用 POP，以及 API 擷取的郵件。
| 值 | 效果 |
|---|---|
disabled |
無法透過 POP 存取任何郵件 |
allMail |
透過 POP 存取所有未擷取的郵件 |
fromNowOn |
只有新郵件可透過 POP 存取 |
郵件處置
使用 disposition 欄位，設定 API 擷取郵件的處置方式。
| 值 | 效果 |
|---|---|
archive |
將郵件移出「INBOX」 |
leaveInInbox |
不採取任何行動，讓訊息在「INBOX」中保持未讀狀態 |
markRead |
將郵件留在 INBOX 中並標示為已讀取 |
trash |
將訊息移至「TRASH」 |
IMAP
您可以使用 ImapSettings 物件管理帳戶的 IMAP 設定。
啟用及停用存取權
使用布林值
enabled
欄位控管存取權。這個欄位會決定帳戶是否啟用 IMAP。
郵件處置
使用 expungeBehavior 欄位設定郵件的處置方式，當用戶端將郵件標示為已刪除，並從最後一個可見的 IMAP 資料夾中清除郵件時，系統會根據此欄位設定處置郵件。
| 值 | 效果 |
|---|---|
archive |
將標示為已刪除的郵件移出 INBOX |
deleteForever |
永久刪除標示為已刪除的訊息 |
trash |
將標示為已刪除的訊息移到「TRASH」 |
如果布林值
autoExpunge
欄位為 true，當用戶端在 IMAP 中將郵件標示為已刪除時，Gmail 會立即清除郵件。否則，除非 IMAP 用戶端明確要求移除郵件，否則郵件會一直保留在伺服器上。