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 网页界面中的“发件人为：”功能，也是配置每个地址的电子邮件签名的基础。如需了解详情，请参阅管理别名。

线程

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