管理标签

您可以在 Gmail 中使用标签标记、整理和分类邮件和会话。标签与邮件和会话之间存在多对多关系：您可以为单封邮件或会话应用多个标签，也可以为多封邮件或会话应用单个标签。

如需了解如何create、获取、列出、更新或删除标签，请参阅标签参考文档。

如需管理标签，您必须使用 https://www.googleapis.com/auth/gmail.labels 范围。如需详细了解范围，请参阅 Gmail API 专属授权和身份验证信息。

标签类型

标签分为两种：预留的 SYSTEM 标签和自定义的 USER 标签。 系统标签通常与 Gmail 网页界面中的预定义元素（例如收件箱）相对应。系统标签名称为预留名称；任何 USER 标签都不能与任何 SYSTEM 标签同名。下表列出了一些最常见的 Gmail 系统标签：

名称	可手动应用	备注
INBOX	是
SPAM	是
TRASH	是
UNREAD	是
STARRED	是
IMPORTANT	是
SENT	否	自动应用于使用 drafts.send 或 messages.send 发送的邮件、在 From 标头中插入 messages.insert 和用户的电子邮件地址的邮件，或由用户通过 Web 界面发送的邮件。
DRAFT	否	自动应用于使用 Gmail API 或 Gmail 界面创建的所有 draft 邮件。
CATEGORY_PERSONAL	是	对应于 Gmail 界面“个人”标签页中显示的邮件。
CATEGORY_SOCIAL	是	与 Gmail 界面“社交”标签页中显示的消息相对应。
CATEGORY_PROMOTIONS	是	对应于 Gmail 界面“推广”标签页中显示的消息。
CATEGORY_UPDATES	是	对应于 Gmail 界面“动态”标签页中显示的消息。
CATEGORY_FORUMS	是	对应于 Gmail 界面“论坛”标签页中显示的消息。

管理邮件和会话的标签

标签仅适用于消息。例如，如果您列出会话中的标签，则会获得会话中任何消息所含标签的列表。消息串中的每条消息可能都没有标签。您可以为邮件应用多个标签，但无法为草稿邮件应用标签。

为会话添加或移除标签

为会话添加或移除标签时，系统会为会话中的所有现有邮件添加或移除指定标签。

如果您在添加标签后向会话中添加了消息，则新消息不会继承与会话关联的现有标签。如需为这些邮件添加标签，请再次为会话串添加标签。

如需添加或移除与会话相关联的标签，请使用 threads.modify。

为邮件添加或移除标签

为邮件添加标签后，系统会将该标签添加到该邮件中，并将其与邮件所属的会话相关联。系统不会将该标签添加到会话中的其他邮件。

如果您移除某封邮件的标签，而该邮件是会话中唯一带有该标签的邮件，则该标签也会从会话中移除。

如需添加或移除应用于消息的标签，请使用 messages.modify。