Auf dieser Seite wird beschrieben, wie Sie die wichtigsten UI-Komponenten einer Karte entwerfen und erstellen. Nachrichten in Google Chat.
Karten unterstützen ein definiertes Layout, interaktive UI-Elemente wie Schaltflächen und Rich Media wie Bilder. Sie können Karten verwenden, um Informationen zu präsentieren, Input zu sammeln, oder Nutzenden die nächsten Schritte durch Kartennachrichten und Dialogfelder:
Mit dem Card Builder können Sie JSON-Kartennachrichten für Chat-Apps erstellen und als Vorschau ansehen:
Card Builder öffnenKarten und Dialogfelder haben in der Regel die folgenden Komponenten:
- Ein
CardHeader
, der den Titel deiner Karte enthält. - Ein oder mehrere
CardSection
-Widgets, die den Hauptteil der Karte bilden. - Ein
CardFixedFooter
-Widget nur für Dialogfelder spezifisch.
Vorbereitung
Eine Google Chat App mit aktivierten interaktiven Funktionen. So erstellen Sie ein Chat-App verwenden, führen Sie eine der folgenden Kurzanleitungen aus für die App-Architektur, die Sie verwenden möchten:
- HTTP-Dienst mit Google Cloud Functions
- Google Apps Script
- Google Cloud Dialogflow CX
- Cloud Pub/Sub
Header hinzufügen
CardHeader
-Widget
steht für den Header einer Karte. Header können Folgendes enthalten:
Titel, Untertitel und ein Avatarbild für die Karte.
Du kannst CardHeader
für
Kartennachrichten und
Dialogfelder.
Das folgende Beispiel zeigt ein CardHeader
-Objekt:
Bereich einer Karte definieren
Das CardSection
-Widget ist ein
übergeordneten Container innerhalb einer Karte. Du verwendest die Karte
um Widgets auf einer Karte zu gruppieren. Für jeden Kartenbereich können Sie
eine Kopfzeile und ein oder mehrere Widgets.
Du kannst CardSection
für
Kartennachrichten und
Dialogfelder.
Das folgende Beispiel zeigt ein CardSection
-Objekt, das zwei textParagraph
-Elemente enthält.
Widgets:
Dauerhafte Fußzeile hinzufügen
Die CardFixedFooter
das die Fußzeile einer von einem
eine Chat-App.
Fußzeilen können eine primäre und eine sekundäre Schaltfläche enthalten.
Das CardFixedFooter
-Widget ist nur verfügbar für
Dialogfelder.
Das folgende Beispiel zeigt ein CardFixedFooter
-Widget mit zwei Schaltflächen:
Fehlerbehebung
Wenn eine Google Chat-App oder card gibt einen Fehler zurück. Der Parameter In der Chatoberfläche wird die Meldung „Ein Fehler ist aufgetreten“ angezeigt. oder „Ihre Anfrage kann nicht verarbeitet werden.“ Manchmal kann die Chat-UI Es wird zwar keine Fehlermeldung angezeigt, aber die Chat-App oder die Karte zu einem unerwarteten Ergebnis führt. z. B. wird eine Kartennachricht angezeigt werden.
Auch wenn in der Chat-Benutzeroberfläche möglicherweise keine Fehlermeldung angezeigt wird, beschreibende Fehlermeldungen und Protokolldaten stehen zur Fehlerbehebung zur Verfügung. wenn die Fehlerprotokollierung für Chat-Apps aktiviert ist. Hilfe bei der Anzeige: Debugging und Beheben von Fehlern finden Sie unter Google Chat-Fehler beheben