本文說明如何使用 Gmail API 管理執行緒和郵件的標籤。
您可以使用標籤在 Gmail 中標記、整理及分類郵件和郵件串。標籤與郵件和郵件串之間為多對多關係：您可以為單一郵件或郵件串套用多個標籤，也可以為多封郵件或多個郵件串套用單一標籤。
如要瞭解如何建立、取得、列出、更新或刪除標籤，請參閱 labels 資源。
如要管理標籤，請務必使用 https://www.googleapis.com/auth/gmail.labels 非機密範圍。如要進一步瞭解範圍，請參閱「選擇 Gmail API 範圍」。
標籤類型
標籤分為兩種：保留的 SYSTEM 標籤和自訂 USER 標籤。
系統標籤通常對應至 Gmail 網頁介面中的預先定義元素，例如 INBOX。系統標籤名稱為保留字，因此無法建立與任何 SYSTEM 標籤同名的 USER 標籤。下表列出幾個最常見的 Gmail 系統標籤：
| 名稱 | 可手動套用 | 附註 |
|---|---|---|
INBOX |
是 | |
SPAM |
是 | |
TRASH |
是 | |
UNREAD |
是 | |
STARRED |
是 | |
IMPORTANT |
是 | |
SENT |
否 | 自動套用至以下郵件：
|
DRAFT |
否 | 系統會自動套用至透過 Gmail API 或 Gmail 介面建立的所有郵件。draft |
CATEGORY_PERSONAL |
是 | 對應於 Gmail 介面「個人」分頁中顯示的郵件。 |
CATEGORY_SOCIAL |
是 | 對應於 Gmail 介面「社交網路」分頁中顯示的郵件。 |
CATEGORY_PROMOTIONS |
是 | 對應於 Gmail 介面「促銷內容」分頁中顯示的郵件。 |
CATEGORY_UPDATES |
是 | 對應於 Gmail 介面「最新快訊」分頁中顯示的郵件。 |
CATEGORY_FORUMS |
是 | 對應於 Gmail 介面「論壇」分頁中顯示的郵件。 |
管理討論串和郵件的標籤
標籤只會顯示在郵件上，如果您擷取執行緒的標籤清單，系統會傳回執行緒中任何郵件的標籤清單。討論串中的每則訊息可能不會都有標籤。
無法將標籤套用至草稿郵件。
在討論串中新增或移除標籤
在郵件串中新增或移除標籤時，系統會為郵件串中的所有現有郵件新增或移除指定標籤。
如果是在新增標籤後才將郵件加入討論串，新郵件不會沿用與討論串相關聯的現有標籤。如要為這些郵件加上標籤，請再次為郵件串加上標籤。
如要新增或移除與執行緒相關聯的標籤，請使用 threads.modify。
為郵件加上或移除標籤
為郵件加上標籤後，該標籤會新增至郵件，並與郵件所屬的討論串建立關聯。標籤不會加到討論串中的其他郵件。
如果將郵件從某個標籤中移除，且該郵件是會話串中唯一有該標籤的郵件，系統也會從會話串中移除該標籤。
如要新增或移除套用至郵件的標籤，請使用 messages.modify。