Method: spaces.messages.delete
Löscht eine Nachricht. Ein Beispiel finden Sie unter Nachricht löschen.
Unterstützt die folgenden Authentifizierungstypen:
Bei der App-Authentifizierung können mit Anfragen nur Nachrichten gelöscht werden, die von der anrufenden Chat-App erstellt wurden.
HTTP-Anfrage
DELETE https://chat.googleapis.com/v1/{name=spaces/*/messages/*}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
name |
string
Erforderlich. Ressourcenname der Nachricht. Format: spaces/{space}/messages/{message} Wenn Sie eine benutzerdefinierte ID für Ihre Nachricht festgelegt haben, können Sie den Wert aus dem Feld clientAssignedMessageId für {message} verwenden. Weitere Informationen
|
Abfrageparameter
| Parameter |
force |
boolean
Optional. Wenn true ausgewählt ist, werden beim Löschen einer Nachricht auch die Antworten im Thread gelöscht. Wenn false und eine Nachricht Antworten in einem Thread hat, schlägt das Löschen fehl. Gilt nur bei der Authentifizierung als Nutzer. Hat keine Auswirkungen bei der Authentifizierung als Chat-App.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, ist der Antworttext ein leeres JSON-Objekt.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/chat.bothttps://www.googleapis.com/auth/chat.importhttps://www.googleapis.com/auth/chat.messages
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: 2025-01-22 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-01-22 (UTC)."],[[["This method enables you to delete messages and optionally their replies using an HTTP DELETE request."],["It supports both app and user authentication, with app authentication limiting deletion to messages created by the app."],["You can specify whether to force delete threaded replies with the `force` query parameter when using user authentication."],["The request requires specifying the message's resource name in the URL path and an empty request body."],["Authorization is required using one of the specified OAuth scopes."]]],["This document details how to delete a message using the Chat API. The `DELETE` request targets a specific message's resource name in the format `spaces/*/messages/*`. It supports both app and user authentication, with different limitations for each. The request requires a message's name as a path parameter. A `force` query parameter is optional for user authentication to delete threaded replies. The request body is empty, and a successful response returns an empty JSON object. One of three specified OAuth scopes is required.\n"]]
