您可以在 Gmail 中使用标签来标记、整理和分类邮件和会话。标签与消息和会话之间存在多对多关系：您可以为单条消息或会话应用多个标签，而将单个标签应用于多条消息或会话串。
如需了解如何创建、获取、列出、更新或删除标签，请参阅标签参考。
如需管理标签，您必须使用 https://www.googleapis.com/auth/gmail.labels 范围。如需详细了解范围，请参阅 Gmail API 特有的授权和身份验证信息。
标签类型
标签分为两种：预留的 SYSTEM 标签和自定义的 USER 标签。系统标签通常对应于 Gmail 网页界面中的预定义元素（例如收件箱）。系统标签名称已预留；不得使用与任何 SYSTEM 标签相同的名称创建 USER 标签。下表列出了一些最常见的 Gmail 系统标签：
| 名称 | 可以手动应用 | 备注 |
|---|---|---|
INBOX |
是 | |
SPAM |
是 | |
TRASH |
是 | |
UNREAD |
是 | |
STARRED |
是 | |
IMPORTANT |
是 | |
SENT |
否 | 自动应用于通过 drafts.send 或 messages.send 发送的消息、使用 messages.insert 插入且在 From 标头中插入用户的电子邮件地址，或由用户通过网页界面发送的消息。 |
DRAFT |
否 | 自动应用于使用 Gmail API 或 Gmail 界面创建的所有 draft 邮件。 |
CATEGORY_PERSONAL |
是 | 对应于 Gmail 界面的“个人”标签页中显示的消息。 |
CATEGORY_SOCIAL |
是 | 对应于 Gmail 界面的“社交”标签页中显示的消息。 |
CATEGORY_PROMOTIONS |
是 | 对应于 Gmail 界面的“推广”标签页中显示的消息。 |
CATEGORY_UPDATES |
是 | 对应于 Gmail 界面的“最新动态”标签页中显示的消息。 |
CATEGORY_FORUMS |
是 | 对应于 Gmail 界面的“论坛”标签页中显示的消息。 |
管理邮件和会话的标签
标签仅存在于邮件中。例如，如果您列出某个会话的标签，则会收到该会话内任意邮件上存在的标签列表。标签可能不会存在于会话串中的每封邮件上。您可以为邮件应用多个标签，但无法为草稿邮件应用标签。
为消息串添加或移除标签
为某个会话添加或移除标签时，您可以为该会话中的所有现有邮件添加或移除指定标签。
如果邮件在您添加标签后添加到会话中，则新邮件不会继承与该会话相关联的现有标签。如需为这些邮件添加标签，请再次将标签添加到相应会话。
如需添加或移除与线程关联的标签，请使用 threads.modify。
为邮件添加或移除标签
为消息添加标签后，该标签会添加到相应消息中，并与消息所属的会话关联。该标签不会添加到会话串中的其他消息中。
如果您从某封邮件中移除某个标签，而该标签是会话中唯一带有该标签的邮件，则该标签也会从该会话中移除。
如需添加或移除应用于消息的标签，请使用 messages.modify。