您可以在 Gmail 中使用標籤來標記、整理及分類郵件和討論串。標籤與訊息和執行緒具有多對多關係：您可以為單一訊息或討論串套用多個標籤，並且將單一標籤套用至多個訊息或執行緒。
如要瞭解如何建立、get、list、update 或 delete 標籤，請參閱標籤參考資料。
如要管理標籤，您必須使用 https://www.googleapis.com/auth/gmail.labels 範圍。如要進一步瞭解範圍，請參閱 Gmail API 專屬授權和驗證資訊。
標籤類型
標籤有兩種類型：預留的 SYSTEM 標籤和自訂 USER 標籤。系統標籤通常會對應 Gmail 網頁介面中的預先定義元素，例如收件匣。系統標籤名稱僅供保留；建立任何 USER 標籤時，不可使用任何 SYSTEM 標籤相同的名稱。下表列出幾個最常見的 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。