管理标签

您可以在 Gmail 中使用标签来标记、整理和分类邮件和会话。标签与消息和会话之间存在多对多关系:您可以为单条消息或会话应用多个标签,而将单个标签应用于多条消息或会话串。

如需了解如何创建获取列出更新删除标签,请参阅标签参考

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

标签类型

标签分为两种:预留的 SYSTEM 标签和自定义的 USER 标签。系统标签通常对应于 Gmail 网页界面中的预定义元素(例如收件箱)。系统标签名称已预留;不得使用与任何 SYSTEM 标签相同的名称创建 USER 标签。下表列出了一些最常见的 Gmail 系统标签:

名称 可以手动应用 备注
INBOX
SPAM
TRASH
UNREAD
STARRED
IMPORTANT
SENT 自动应用于通过 drafts.sendmessages.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