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