Gmail API 概览

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

  • 使用只读邮件提取、编入索引和备份
  • 自动或程序化消息发送
  • 电子邮件账号迁移
  • 整理电子邮件,包括邮件过滤和排序
  • 对整个组织的电子邮件签名实现标准化

下面列出了 Gmail API 中使用的常用术语:

消息
包含发件人、收件人、主题和正文的电子邮件。创建消息后,便无法更改消息。消息由消息资源表示。
线程
构成对话的一组相关消息。在电子邮件客户端应用中,当一个或多个收件人使用自己的邮件回复邮件时,就会形成一个会话。
标签

一种整理消息和会话的机制。例如,可能会创建“taxes”标签,并将其应用于与用户税费相关的所有消息和线程。标签有两种类型:

系统标签
内部创建的标签,例如“INBOX”“TRASH”或“SPAM”。无法删除或修改这些标签。但是,某些系统标签(例如 INBOX)可对邮件和会话应用或移除标签。
用户标签
用户创建的标签。用户或应用可以删除或修改这些标签。用户标签由标签资源表示。
草稿

一封邮件未发送。草稿中包含的消息可以替换。 发送草稿会自动删除草稿并创建带有 SENT 系统标签的消息。草稿由草稿资源表示。

后续步骤