Komponenten einer Karte oder eines Dialogfelds entwerfen

Auf dieser Seite wird beschrieben, wie Sie die Hauptkomponenten der Benutzeroberfläche von Kartennachrichten in Google Chat entwerfen und erstellen.

Karten unterstützen ein definiertes Layout, interaktive UI-Elemente wie Schaltflächen und Rich Media wie Bilder. Mithilfe von Karten kannst du über Kartennachrichten und Dialogfelder Informationen präsentieren, Input einholen oder Nutzern die nächsten Schritte mitteilen.

Mit dem Card Builder kannst du Karten entwerfen und sie dir als Vorschau ansehen.

Den Card Builder öffnen

Karten und Dialogfelder haben in der Regel die folgenden Komponenten:

  • Ein CardHeader, das den Titel Ihrer Karte enthält.
  • Ein oder mehrere CardSection-Widgets, die den Haupttext der Karte bilden.
  • Ein CardFixedFooter-Widget speziell für Dialogfelder.

Voraussetzungen

  • Ein Google Workspace-Konto mit Zugriff auf Google Chat.
  • Eine veröffentlichte Chat-App. Folgen Sie dieser quickstart, um eine Chat-App zu erstellen.

    • Header hinzufügen

    Das CardHeader-Widget stellt den Header einer Karte dar. Überschriften können einen Titel, eine Unterüberschrift und ein Avatarbild für deine Karte enthalten.

    Sie können CardHeader für Kartennachrichten und Dialogfelder angeben.

    Hier ein Beispiel für eine CardHeader:

    Bereich einer Karte definieren

    Das CardSection-Widget ist ein übergeordneter Container innerhalb einer Karte. Mit Kartenabschnitten können Sie Widgets auf einer Karte gruppieren. Für jeden Kartenabschnitt können Sie eine Kopfzeile und ein oder mehrere Widgets einfügen.

    Sie können CardSection für Kartennachrichten und Dialogfelder angeben.

    Das folgende Beispiel zeigt ein CardSection-Element, das zwei textParagraph-Widgets enthält:

    Das CardFixedFooter-Widget stellt die Fußzeile einer Dialognachricht dar, die von einer Chat-App gesendet wurde. Fußzeilen können eine primäre und eine sekundäre Schaltfläche enthalten.

    Das CardFixedFooter-Widget ist nur für Dialogfelder verfügbar.

    Hier ein Beispiel für ein CardFixedFooter-Widget mit zwei Schaltflächen:

    Fehlerbehebung

    Wenn eine Google Chat-App oder Google Chat-Karte einen Fehler zurückgibt, wird in der Chat-Oberfläche die Meldung „Ein Fehler ist aufgetreten“ oder „Ihre Anfrage kann nicht verarbeitet werden“ angezeigt. Manchmal wird in der Chat-Benutzeroberfläche keine Fehlermeldung angezeigt, aber die Chat-App oder -Karte führt zu einem unerwarteten Ergebnis, z. B. dass keine Kartennachricht angezeigt wird.

    Obwohl eine Fehlermeldung möglicherweise nicht in der Chat-Benutzeroberfläche angezeigt wird, sind beschreibende Fehlermeldungen und Protokolldaten verfügbar, mit denen Sie Fehler beheben können, wenn die Fehlerprotokollierung für Chat-Apps aktiviert ist. Informationen zum Aufrufen, Debuggen und Beheben von Fehlern finden Sie im Hilfeartikel Google Chat-Fehler beheben.