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