Gmail API 概览

Gmail API 是一种 RESTful API，可用于访问 Gmail 邮箱和发送邮件。对于大多数 Web 应用，Gmail API 是经过授权访问用户 Gmail 数据的最佳选择，适用于各种应用，例如：

常用术语

以下是此 API 中使用的常用术语列表：

委托人和受托人

委托人是指向同一 Google Workspace 组织内的其他用户授予邮箱访问权限的 Gmail 用户。接收此访问权限的用户是受托人。受托人可以代表委托人的账号读取、发送和删除邮件，以及查看和添加联系人。如需了解详情，请参阅管理受托人。

草稿

未发送的邮件。可以替换草稿中包含的邮件。发送草稿会自动删除草稿并创建带有 SENT 系统标签的邮件。草稿由 drafts资源表示。如需了解详情，请参阅使用草稿。

过滤条件

为账号配置的高级规则，用于根据特定匹配条件（如发件人、主题或大小）评估收到的邮件。当邮件匹配时，过滤条件会自动触发操作，例如添加或移除标签，或将电子邮件转发到指定地址。如需了解详情，请参阅管理过滤条件。

转发地址

配置为接收用户账号自动转发的邮件的特定已验证电子邮件地址。地址必须经过正式注册和验证，以证明所有权，然后才能在转发规则或过滤条件中使用。如需了解详情，请参阅管理转发。

标签

一种用于整理邮件和会话的机制。例如，您可以创建“税务”标签，并将其应用于与用户税务相关的所有邮件和会话。如需了解详情，请参阅管理标签。

标签分为以下两种类型：

系统标签: 内部创建的标签，例如 INBOX、TRASH 或 SPAM。这些标签无法删除或修改。不过，某些系统标签（例如 INBOX）可以应用于邮件和会话，也可以从邮件和会话中移除。
用户标签: 用户创建的标签。用户或应用可以删除或修改这些标签。用户标签由 labels 资源表示。

邮件

包含发件人、收件人、主题和正文的电子邮件。邮件创建后无法更改。邮件由 messages 资源表示。

推送通知

与 Google Cloud Pub/Sub 集成的服务器端通知系统。应用可以“监视”邮箱，Gmail API 会在发生更改（例如收到新电子邮件）时自动发送 Webhook 或提醒，从而无需应用持续轮询服务器以获取更新。如需了解详情，请参阅推送通知。

S/MIME 证书

上传到特定“发件人为：”别名的数字证书，允许用户发送加密和数字签名的电子邮件，确保邮件安全和发件人身份的真实性。如需了解详情，请参阅管理 S/MIME 证书。

“发件人为：”别名

这些别名表示账号有权从中发送邮件的各种电子邮件地址。每个账号都至少有一个别名，表示主邮箱。别名对应于 Gmail 网页界面中的“发件人为：”功能，也是配置按地址电子邮件签名的基础。如需了解详情，请参阅管理别名。

会话

构成对话的一组相关邮件。在电子邮件客户端应用中，当一个或多个收件人使用自己的邮件回复邮件时，会形成会话。如需了解详情，请参阅管理会话。