Method: spaces.messages.replaceCards

Ersetzt die in einer Nachricht enthaltenen Karten.

Eine Chat-App kann Karten in einer von einem Menschen erstellten Nachricht nur ersetzen, wenn die Nachricht bereits Karten enthält und die Karten von der App erstellt wurden.

Wenn die App die Karten durch eine leere Liste ersetzt, werden die Karten entfernt. Nachdem die Karten entfernt wurden, können sie der Nachricht nicht mehr hinzugefügt werden.

Erfordert die App-Authentifizierung mit dem Autorisierungsbereich: - https://www.googleapis.com/auth/chat.bot

HTTP-Anfrage

POST https://chat.googleapis.com/v1/{name=spaces/*/messages/*}:replaceCards

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Der Ressourcenname der Nachricht.

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

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "cardsV2": [
    {
      object (CardWithId)
    }
  ]
}
Felder
cardsV2[]

object (CardWithId)

Optional. Ein Array von Karten, die in die Nachricht aufgenommen werden sollen. Diese Karten ersetzen die vorhandenen Karten der Nachricht. Wenn das Feld leer ist, werden die ursprünglichen Karten in der Nachricht gelöscht.

Antworttext

Wenn der Vorgang erfolgreich ist, ist der Antworttext leer.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.