您可以在 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。