Omówienie wiadomości w Google Chat

Na tej stronie wyjaśniamy różnice między wiadomościami tekstowymi a wiadomościami z kartami.

Gdy aplikacje Google Chat wysyłają wiadomości tekstowe, aby przekazać podstawowe informacje, wiadomości te pojawiają się w tekście, tak jak wiadomości pisane przez użytkowników w Google Chat. Aby tworzyć wiadomości zawierające więcej niż tylko tekst lub tworzyć wiadomości, z którymi użytkownicy mogą wchodzić w interakcje, aplikacje Google Chat mogą używać kart. Aplikacje Google Chat mogą też dołączyć kartę do wiadomości tekstowej. Aby zachęcić użytkowników do ukończenia procesów wieloetapowych, takich jak wypełnianie formularza, aplikacje Google Chat mogą też tworzyć karty, które otwierają się w nowym oknie jako okna dialogowe.

Budowa wiadomości tekstowej

W interfejsie Google Chat API wiadomości są reprezentowane jako obiekty JSON. W wiadomości, wiadomość tekstowa jest reprezentowana jako text obiekt.

W tym przykładzie aplikacja Google Chat tworzy wiadomość tekstową w pokoju dla zespołu programistów, informującą o zbliżającym się zamrożeniu kodu:

{
  "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."
}

JSON zwraca tę wiadomość:

Przykładowa wiadomość tekstowa w Google Chat z ogłoszeniem o wstrzymaniu zmian w kodzie.

Budowa wiadomości z kartą

W interfejsie Google Chat API wiadomości są reprezentowane jako obiekty JSON. W wiadomości karta jest reprezentowana jako cardsV2 tablica i składa się z tych elementów:

  • co najmniej 1 CardWithId obiektu;
  • elementu cardId służącego do identyfikowania karty i ograniczonego do danej wiadomości (karty w różnych wiadomościach mogą mieć ten sam identyfikator);

  • obiektu card, który składa się z tych elementów:

    • obiektu header określającego takie elementy jak tytuł, podtytuł i obraz w stylu awatara;
    • co najmniej 1 section obiektu , z których każdy zawiera co najmniej 1 widżet;
    • co najmniej 1 widget obiektu. Każdy widżet jest obiektem złożonym, który może reprezentować tekst, obrazy, przyciski i inne typy obiektów.

Na przykład ta wiadomość z kartą zawiera header, section i widget obiekty:

Aplikacja w Google Chat przeprowadzająca ankietę w pokoju w Google Chat za pomocą wiadomości z kartą

Ten kod przedstawia JSON wiadomości z kartą:

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"
                            }
                          ]
                        }
                      }
                    }
                  ]
                }
              }
            ]
          }
        ]
      }
    }
  ]
}

Użyj narzędzia do tworzenia kart, aby projektować i wyświetlać podgląd interfejsów wiadomości i interfejsów użytkownika aplikacji Google Chat:

Otwórz narzędzie do tworzenia kart