Method: users.labels.delete
指定したラベルを即時かつ完全に削除し、ラベルが適用されているメッセージやスレッドから削除します。
HTTP リクエスト
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/labels/{id}
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
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
詳細については、承認ガイドをご覧ください。
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-09-05 UTC。
[null,null,["最終更新日 2024-09-05 UTC。"],[[["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"]]