Method: users.threads.delete
Borra de forma inmediata y permanente el subproceso especificado. También se borran todos los mensajes que pertenecen a la conversación. Esta operación no se puede deshacer. En su lugar, prioriza threads.trash
.
Solicitud HTTP
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros |
userId |
string
La dirección de correo electrónico del usuario. Se puede usar el valor especial me para indicar el usuario autenticado.
|
id |
string
ID del subproceso que se borrará.
|
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta correctamente, el cuerpo de la respuesta está vacío.
Permisos de autorización
Requiere el siguiente alcance de OAuth:
Para obtener más información, consulta la guía de autorización.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-09-05 (UTC)
[null,null,["Última actualización: 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"]]