Nachrichten in Google Chat

Auf dieser Seite werden die Unterschiede zwischen Text- und Kartennachrichten erläutert.

Wenn Chat-Apps Nachrichten senden, um grundlegende Informationen zu vermitteln, werden die Nachrichten inline angezeigt, genau wie Nutzer in Google Chat Nachrichten. Um Nachrichten zu erstellen, die mehr als Text enthalten, oder um Nachrichten, mit denen Nutzer interagieren können, können Chat-Apps Karten. Chat-Apps können auch eine SMS mit einer Karte anhängen. Bis Nutzer werden aufgefordert, mehrstufige Prozesse wie das Ausfüllen eines Formulars, Chat-Apps können auch Karten erstellen, die in einem neuen Fenster Dialogfelder ein.

Aufbau einer Textnachricht

In der Google Chat API werden Nachrichten als JSON-Objekte dargestellt. In einer Nachricht wird eine Textnachricht text -Objekt enthält.

Im Folgenden Beispiel: Eine Chat-App erstellt eine Textnachricht in einem Gruppenbereich, für ein Team von Softwareentwicklern, bei dem eine Code-Freeze bevorsteht:

{
  "text": "Attention <users/all>: Code freeze starts at `11:59 am` Pacific Standard Time! If you need a little more time, type `/moreTime` and I'll push the code freeze back one hour."
}

Die JSON-Datei gibt die folgende Meldung zurück:

Beispiel-Textnachricht in Google Chat, die ein Einfrieren von Code ankündigt.

Aufbau einer Kartennachricht

In der Google Chat API werden Nachrichten als JSON-Objekte dargestellt. Innerhalb einer Nachricht wird eine Karte als cardsV2 -Array und besteht aus Folgendem:

  • Mindestens eine CardWithId-Objekte.
  • Ein cardId, der zum Identifizieren der Karte und des Bereichs einer bestimmten Nachricht verwendet wird. Karten in verschiedenen Nachrichten können dieselbe ID haben.
  • Ein card-Objekt, das aus Folgendem besteht:

    • Ein header-Objekt der Dinge wie Titel, Unterüberschrift und Avatar-Bild angibt.
    • Mindestens eine section Objekte die jeweils mindestens ein Widget enthalten.
    • Mindestens eine widget-Objekte. Jedes Widget ist ein zusammengesetztes Objekt, das Text, Bilder, und anderen Objekttypen.

Die folgende Kartennachricht enthält beispielsweise header, section und widget Objekte:

Eine Chat-App, mit der eine Umfrage in Google Chat ausgeführt wird
Bereich mithilfe einer Karte
Nachricht

Der folgende Code stellt die JSON-Datei der Kartennachricht dar:

JSON

{
  "cardsV2": [
    {
      "cardId": "unique-card-id",
      "card": {
        "header": {
          "title": "Sasha",
          "subtitle": "Software Engineer",
          "imageUrl": "https://developers.google.com/chat/images/quickstart-app-avatar.png",
          "imageType": "CIRCLE",
          "imageAltText": "Avatar for Sasha"
        },
        "sections": [
          {
            "header": "Contact Info",
            "collapsible": true,
            "uncollapsibleWidgetsCount": 1,
            "widgets": [
              {
                "decoratedText": {
                  "startIcon": {
                    "knownIcon": "EMAIL"
                  },
                  "text": "sasha@example.com"
                }
              },
              {
                "decoratedText": {
                  "startIcon": {
                    "knownIcon": "PERSON"
                  },
                  "text": "<font color=\"#80e27e\">Online</font>"
                }
              },
              {
                "decoratedText": {
                  "startIcon": {
                    "knownIcon": "PHONE"
                  },
                  "text": "+1 (555) 555-1234"
                }
              },
              {
                "buttonList": {
                  "buttons": [
                    {
                      "text": "Share",
                      "onClick": {
                        "openLink": {
                          "url": "https://example.com/share"
                        }
                      }
                    },
                    {
                      "text": "Edit",
                      "onClick": {
                        "action": {
                          "function": "goToView",
                          "parameters": [
                            {
                              "key": "viewType",
                              "value": "EDIT"
                            }
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  ]
}


Mit dem Card Builder können Sie JSON-Kartennachrichten für Chat-Apps erstellen und als Vorschau ansehen:

Card Builder öffnen