您可以使用標籤標記、整理及分類 Gmail 中的郵件和會話串。標籤與郵件和會話串的關係為多對多：您可以為單一郵件或會話串套用多個標籤，也可以為多封郵件或會話串套用單一標籤。
如要瞭解如何create、取得、列出、更新或刪除標籤，請參閱「標籤參考資料」。
如要管理標籤，您必須使用 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 傳送的郵件，並在 From 標頭中插入 messages.insert 和使用者的電子郵件，或是由使用者透過網頁介面傳送的郵件。 |
DRAFT |
否 | 會自動套用至所有使用 Gmail API 或 Gmail 介面建立的 draft 訊息。 |
CATEGORY_PERSONAL |
是 | 對應至 Gmail 介面「個人」分頁中顯示的郵件。 |
CATEGORY_SOCIAL |
是 | 對應至 Gmail 介面「社交網路」分頁中顯示的郵件。 |
CATEGORY_PROMOTIONS |
是 | 對應至 Gmail 介面「促銷內容」分頁中顯示的郵件。 |
CATEGORY_UPDATES |
是 | 對應至 Gmail 介面「更新」分頁中顯示的郵件。 |
CATEGORY_FORUMS |
是 | 對應至 Gmail 介面「論壇」分頁中顯示的郵件。 |
管理訊息和會話中的標籤
標籤只會出現在訊息中。舉例來說，如果您在會話串中列出標籤，就會取得該會話串中任何訊息的標籤清單。討論串中的每則訊息可能都沒有標籤。您可以為訊息套用多個標籤，但無法為草稿訊息套用標籤。
在主題中新增或移除標籤
在會話串中新增或移除標籤時，會在該會話串中所有現有訊息上新增或移除指定標籤。
如果在您新增標籤後，有人將郵件加入至會話串，新郵件就不會繼承與該會話串相關聯的現有標籤。如要為這些訊息新增標籤，請再次將標籤新增至討論串。
如要新增或移除與執行緒相關聯的標籤，請使用 threads.modify。
為郵件新增或移除標籤
當您為郵件加上標籤後，系統會將標籤加入該郵件，並與郵件所屬的討論串建立關聯。標籤不會新增至討論串中的其他訊息。
如果您從郵件中移除標籤，而該郵件是會話串中唯一具有該標籤的郵件，則系統也會從會話串中移除該標籤。
如要新增或移除套用至訊息的標籤，請使用 messages.modify。