Method: spaces.messages.patch
Aktualisiert eine Nachricht. Zwischen den Methoden patch
und update
gibt es einen Unterschied. Bei der Methode patch
wird eine patch
-Anfrage verwendet, bei der Methode update
eine put
-Anfrage. Wir empfehlen die Methode patch
. Ein Beispiel finden Sie unter Nachricht aktualisieren.
Unterstützt die folgenden Authentifizierungstypen:
Bei der App-Authentifizierung können Anfragen nur Nachrichten aktualisieren, die von der anrufenden Chat-App erstellt wurden.
HTTP-Anfrage
PATCH https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter |
message.name |
string
Kennung. Ressourcenname der Nachricht. Format: spaces/{space}/messages/{message} Dabei steht {space} für die ID des Gruppenbereichs, in dem die Nachricht gepostet wurde, und {message} für eine systemzugewiesene ID für die Nachricht. Beispiel: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB Wenn Sie beim Erstellen einer Nachricht eine benutzerdefinierte ID festlegen, können Sie diese ID verwenden, um die Nachricht in einer Anfrage anzugeben. Ersetzen Sie dazu {message} durch den Wert aus dem Feld clientAssignedMessageId . Beispiel: spaces/AAAAAAAAAAA/messages/client-custom-name Weitere Informationen
|
Abfrageparameter
Parameter |
updateMask |
string (FieldMask format)
Erforderlich. Die zu aktualisierenden Feldpfade. Trennen Sie mehrere Werte durch Kommas oder verwenden Sie * , um alle Feldpfade zu aktualisieren. Derzeit unterstützte Feldpfade:
|
allowMissing |
boolean
Optional. Wenn true und die Nachricht nicht gefunden werden, wird eine neue Nachricht erstellt und updateMask wird ignoriert. Die angegebene Nachrichten-ID muss vom Kunden zugewiesen sein, andernfalls schlägt die Anfrage fehl.
|
Anfragetext
Der Anfragetext enthält eine Instanz von Message
.
Antworttext
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Message
.
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/chat.bot
https://www.googleapis.com/auth/chat.import
https://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-02-27 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-02-27 (UTC)."],[[["Updates a Google Chat message using the `PATCH` method, preferably over the `update` method which uses `PUT`."],["Supports both app and user authentication, with app authentication limited to updating messages created by the calling Chat app."],["Requires specifying the message to update using its resource name in the URL path and the fields to update using the `updateMask` query parameter."],["Allows creation of a new message if the original is not found when `allowMissing` query parameter is set to `true` and a client-assigned message ID is provided."],["Requires authorization with one of the specified OAuth scopes (`chat.bot`, `chat.import`, or `chat.messages`)."]]],["This documentation outlines how to update a message using the `PATCH` method via an HTTP request to `https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}`. The `message.name` path parameter is required, specifying the message's resource name. The `updateMask` query parameter is mandatory, indicating which fields to update (e.g., text, attachments). Optionally, `allowMissing` creates a new message if one isn't found. The request and response bodies utilize the `Message` resource, and app or user authentication are supported, with specific authentication impacting permissions.\n"]]