本文档介绍了如何使用 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 客户端明确请求移除邮件，否则邮件会一直保留。