Komponenten einer Karte oder eines Dialogfelds entwerfen

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 öffnen

Karten 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

  • Ein Google Workspace-Konto mit Zugriff auf Google Chat:
  • Eine veröffentlichte Chat-App Um eine Chat-App, folgen Schnellstart

    • 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.

    Hier ein Beispiel für 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:

    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 erscheinen.

    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