Method: spaces.messages.update

Aktualisiert eine Nachricht. Es gibt einen Unterschied zwischen den Methoden patch und update. 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 Nachrichten aktualisieren.

Unterstützt die folgenden Authentifizierungstypen:

Bei Verwendung der App-Authentifizierung können Anfragen nur Nachrichten aktualisieren, die von der aufrufenden Chat-App erstellt wurden.

HTTP-Anfrage

PUT 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 ist {space} die ID des Gruppenbereichs, in dem die Nachricht gepostet wird, und {message} eine vom System zugewiesene 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 Feldpfade, die aktualisiert werden sollen. 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 client-assigned 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.