UpdateThreadLabels¶

添加或移除 Gmail 线程中每封邮件的单个标签。在 Gmail 中，几乎所有收件箱操作本质上都是标签的添加/移除操作，因此该工具是归档、标记已读/未读、加星标、移至回收站、标记重要/垃圾邮件，以及应用或移除自定义标签的基础操作。

工作流程：先调用 ListLabels 找出所需标签名称对应的 UUID id，然后使用该 label_id、线程的 thread_id，以及 add=true（应用）或 add=false（移除）来调用此工具。每次调用只修改一个标签——若需对同一线程执行多项更改（例如归档并标记为已读），请每个标签调用一次此工具。

常见操作（请先通过 ListLabels 查找每个系统标签的 id）：

• 归档：移除 INBOX（add=false）
• 移回收件箱：添加 INBOX（add=true）
• 标记为已读：移除 UNREAD（add=false）
• 标记为未读：添加 UNREAD（add=true）
• 加星标：添加 STARRED（add=true）/ 取消星标：移除（add=false）
• 移至回收站：添加 TRASH（add=true）/ 恢复：移除（add=false）
• 标记为重要：添加 IMPORTANT（add=true）/ 标记为不重要：移除（add=false）
• 举报垃圾邮件：添加 SPAM（add=true）/ 非垃圾邮件：移除（add=false）
• 应用自定义用户标签：添加具有该显示名称的标签（add=true）/ 移除：（add=false）

thread_id 是邮件线程的 UUID（与 ListEntities、搜索结果或 GetThread 返回的 id 相同）。label_id 是 ListLabels 返回的 UUID——不是标签名称。

参数¶