本文档介绍了如何使用 Gmail API 管理 POP 和 IMAP 协议。
POP 和 IMAP 这两种方法都可用来在其他电子邮件客户端中阅读 Gmail 邮件。POP 是一项较旧的技术，只能用于一台计算机。 系统会下载基于 POP 的电子邮件，并由您决定下载新电子邮件的频率。IMAP 可在多个设备上使用，并且电子邮件会实时同步。
您可以使用 Gmail API 的 settings 资源来配置 Gmail 处理 POP 和 IMAP 协议的方式：
流行
您可以使用 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 客户端明确请求移除它们为止。