Method: users.threads.delete
Exclui a linha de execução especificada de forma imediata e permanente. Todas as mensagens da conversa também são excluídas. Não é possível desfazer essa operação. Use threads.trash
.
Solicitação HTTP
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros |
userId |
string
O endereço de e-mail do usuário. O valor especial me pode ser usado para indicar o usuário autenticado.
|
id |
string
ID da linha de execução a ser excluída.
|
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Se a solicitação for concluída, o corpo da resposta estará vazio.
Escopos de autorização
Requer o seguinte escopo OAuth:
Para mais informações, consulte o Guia de autorização.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2024-09-05 UTC.
[null,null,["Última atualização 2024-09-05 UTC."],[[["Permanently deletes a specified thread and all its associated messages, an irreversible action."],["Requires user ID and thread ID as path parameters in the DELETE request."],["Uses Gmail API and needs authorization with the `https://mail.google.com/` scope."],["Request body should be empty, and a successful deletion results in an empty response body."],["Consider using `threads.trash` for a reversible alternative to thread deletion."]]],["This document outlines how to permanently delete a Gmail thread and its associated messages via an HTTP DELETE request. The request requires specifying the `userId` (user's email, or \"me\") and the `id` of the thread. The URL follows gRPC Transcoding syntax. The request body must be empty, and a successful deletion returns an empty response. This action is irreversible. Authorization needs the `https://mail.google.com/` OAuth scope. Prefer trashing a thread over deleting it.\n"]]