Method: users.messages.delete
Exclui a mensagem especificada de forma imediata e permanente. Não é possível desfazer essa operação. Use messages.trash
.
Solicitação HTTP
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{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
O ID da mensagem 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 message, an irreversible action."],["Requires user ID and message ID to execute."],["Uses an empty request body and returns an empty response body upon success."],["Needs authorization with the `https://mail.google.com/` scope."]]],["The core actions are to permanently delete a specified message using a `DELETE` HTTP request. The request URL structure requires `userId` (user's email, \"me\" for authenticated user) and `id` (message ID) as path parameters. The request body must be empty. A successful deletion returns an empty response body. The process needs authorization via the `https://mail.google.com/` OAuth scope. It is stated that the `messages.trash` is a preferred method than deleting.\n"]]