您可以使用標籤來標記、整理及分類 Gmail 中的訊息和會話串。標籤與訊息和執行緒具有多對多關係：您可以將多個標籤套用至單一訊息或執行緒，並將單一標籤套用至多則訊息或執行緒。
如要瞭解如何建立、取得、清單、更新或刪除標籤，請參閱標籤參考資料。
如要管理標籤，您必須使用 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。