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. Nach dem Entfernen der Karten kann die App keine Karten mehr zur Nachricht hinzufügen.

Erfordert 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 leer, werden die in der Nachricht enthaltenen Originalkarten 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 Autorisierungsleitfaden.