Method: spaces.messages.patch

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 Verwendung der Methode patch. Ein Beispiel finden Sie unter Nachricht aktualisieren.

Unterstützt die folgenden Arten der Authentifizierung:

  • App-Authentifizierung mit dem Autorisierungsbereich:

    • https://www.googleapis.com/auth/chat.bot

  • Nutzerauthentifizierung mit einem der folgenden Autorisierungsbereiche:

    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (nur Gruppenbereiche im Importmodus)

Bei der App-Authentifizierung können mit Anfragen nur Nachrichten aktualisiert werden, die von der aufrufenden 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

ID. Ressourcenname der Nachricht.

Format: spaces/{space}/messages/{message}

Dabei ist {space} die ID des Bereichs, 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 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 clientseitig 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 Autorisierungsleitfaden.