Method: users.labels.delete
Немедленно и навсегда удаляет указанную метку и удаляет ее из всех сообщений и цепочек, к которым она применена.
HTTP-запрос
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/labels/{id}
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
| Параметры |
|---|
userId | string Адрес электронной почты пользователя. Специальное значение me можно использовать для указания аутентифицированного пользователя. |
id | string Идентификатор метки, которую нужно удалить. |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
В случае успеха тело ответа пустое.
Области авторизации
Требуется одна из следующих областей OAuth:
-
https://mail.google.com/ -
https://www.googleapis.com/auth/gmail.modify -
https://www.googleapis.com/auth/gmail.labels
Дополнительную информацию см. в руководстве по авторизации .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-10-30 UTC.
[null,null,["Последнее обновление: 2024-10-30 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"]]
