Method: users.messages.delete
Exclui a mensagem especificada imediatamente e permanentemente. Essa operação não pode ser desfeita. Em vez disso, prefira 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 bem-sucedida, o corpo da resposta será um objeto JSON 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 2025-03-14 UTC.
[null,null,["Última atualização 2025-03-14 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"]]
