Method: users.threads.delete
Löscht die angegebene Unterhaltung sofort und endgültig. Alle Nachrichten, die zum Thread gehören, werden ebenfalls gelöscht. Dieser Vorgang kann nicht rückgängig gemacht werden. Stattdessen threads.trash
bevorzugen.
HTTP-Anfrage
DELETE https://gmail.googleapis.com/gmail/v1/users/{userId}/threads/{id}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter |
userId |
string
Die E-Mail-Adresse des Nutzers. Mit dem speziellen Wert me kann der authentifizierte Nutzer angegeben werden.
|
id |
string
ID des zu löschenden Threads.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2024-09-05 (UTC).
[null,null,["Zuletzt aktualisiert: 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"]]