Gmail API 是一个 RESTful API,可用于访问 Gmail 邮箱和发送邮件。对于大多数 Web 应用,Gmail API 是授权访问用户 Gmail 数据的最佳选择,适用于各种应用,例如:
- 使用只读邮件提取、编入索引和备份
- 自动或程序化消息发送
- 电子邮件账号迁移
- 整理电子邮件,包括邮件过滤和排序
- 对整个组织的电子邮件签名实现标准化
下面列出了 Gmail API 中使用的常用术语:
- 消息
- 包含发件人、收件人、主题和正文的电子邮件。创建消息后,便无法更改消息。消息由消息资源表示。
- 线程
- 构成对话的一组相关消息。在电子邮件客户端应用中,当一个或多个收件人使用自己的邮件回复邮件时,就会形成一个会话。
- 标签
一种整理消息和会话的机制。例如,可能会创建“taxes”标签,并将其应用于与用户税费相关的所有消息和线程。标签有两种类型:
- 系统标签
- 内部创建的标签,例如“
INBOX
”“TRASH
”或“SPAM
”。无法删除或修改这些标签。但是,某些系统标签(例如INBOX
)可对邮件和会话应用或移除标签。 - 用户标签
- 用户创建的标签。用户或应用可以删除或修改这些标签。用户标签由标签资源表示。
- 草稿
一封邮件未发送。草稿中包含的消息可以替换。 发送草稿会自动删除草稿并创建带有
SENT
系统标签的消息。草稿由草稿资源表示。
后续步骤
如需了解如何使用 Google Workspace API 进行开发(包括处理身份验证和授权),请参阅 Google Workspace 开发者入门。
如需了解如何配置和运行简单的 Gmail API 应用,请参阅快速入门概览。