本文說明如何使用 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 用戶端明確要求移除郵件，否則郵件會一直保留在伺服器上。