Method: users.labels.delete
立即永久刪除指定的標籤，並從所有套用該標籤的郵件和討論串中移除該標籤。
HTTP 要求
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/labels/{id}
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 |
userId |
string
使用者的電子郵件地址。特殊值 me 可用於表示已驗證使用者。
|
id |
string
要刪除的標籤 ID。
|
授權範圍
需要下列其中一種 OAuth 範圍：
https://mail.google.com/
https://www.googleapis.com/auth/gmail.modify
https://www.googleapis.com/auth/gmail.labels
詳情請參閱授權指南。
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2024-09-05 (世界標準時間)。
[null,null,["上次更新時間：2024-09-05 (世界標準時間)。"],[[["Permanently deletes the specified label and removes it from associated messages and threads."],["Uses a DELETE HTTP request to `https://gmail.googleapis.com/gmail/v1/users/{userId}/labels/{id}`."],["Requires specifying the user ID (or `me` for the authenticated user) and the label ID as path parameters."],["Needs authorization with specific OAuth scopes, such as `https://mail.google.com/` or `https://www.googleapis.com/auth/gmail.modify`."],["Sends an empty request body and returns an empty response body upon successful deletion."]]],["This document outlines the process for deleting a Gmail label via API. The `DELETE` request targets `https://gmail.googleapis.com/gmail/v1/users/{userId}/labels/{id}`, requiring the user's email or \"me\" and the label's ID. The request body must be empty. A successful deletion yields an empty response body. Authorization requires one of three specified OAuth scopes, and deletion also removes the label from associated messages and threads. The resource is deleted immediately and permanently.\n"]]
