Обзор сообщений Google Chat

На этой странице объясняются различия между текстовыми сообщениями и карточными сообщениями.

Когда приложения чата отправляют текстовые сообщения с основной информацией, они отображаются в строке, точно так же, как люди в Google Chat пишут сообщения. Чтобы создавать сообщения, содержащие больше текста, или сообщения, с которыми пользователи могут взаимодействовать, приложения чата могут использовать карточки . Приложения чата также могут добавлять текстовые сообщения с карточками. Чтобы предложить пользователям завершить многоэтапные процессы, такие как заполнение формы, приложения чата также могут создавать карточки, которые открываются в новом окне в виде диалоговых окон .

Анатомия текстового сообщения

В API Google Chat сообщения представлены в виде объектов JSON. Внутри сообщения текстовое сообщение представлено как text объект.

В следующем примере приложение Chat создает текстовое сообщение для группы разработчиков программного обеспечения о приближении заморозки кода:

{
  "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 возвращает следующее сообщение:

Пример текстового сообщения в Google Chat, объявляющего о блокировке кода.

Анатомия карточного сообщения

В API Google Chat сообщения представлены в виде объектов JSON. В сообщении карточка представлена ​​в виде массива cardsV2 и состоит из следующего:

  • Один или несколько объектов CardWithId .
  • cardId , используемый для идентификации карты и ограниченный рамками данного сообщения. (Карточки в разных сообщениях могут иметь один и тот же идентификатор.)

  • Объект card , который состоит из следующего:

    • Объект header , который определяет такие вещи, как заголовок, подзаголовок и изображение в стиле аватара.
    • Один или несколько объектов section , каждый из которых содержит хотя бы один виджет.
    • Один или несколько объектов widget . Каждый виджет представляет собой составной объект, который может представлять текст, изображения, кнопки и другие типы объектов.

Например, следующее сообщение-карточка содержит объекты header , section и widget :

Приложение Chat, проводящее опрос в пространстве Chat с использованием сообщения-карточки.

Следующий код представляет JSON сообщения карты:

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

Используйте конструктор карточек для разработки и предварительного просмотра сообщений и пользовательских интерфейсов для приложений чата:

Откройте конструктор карточек