Спроектируйте компоненты карточки или диалога

На этой странице описано, как спроектировать и создать основные компоненты пользовательского интерфейса карточных сообщений в Google Chat.

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

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

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

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

  • CardHeader , содержащий название вашей карты.
  • Один или несколько виджетов CardSection , образующих основную часть карточки.
  • Виджет CardFixedFooter , предназначенный только для диалогов .

Предварительные условия

  • Аккаунт Google Workspace с доступом к Google Chat .
  • Опубликованное приложение чата. Чтобы создать приложение Chat, следуйте этому краткому руководству .

    • Добавить заголовок

    Виджет CardHeader представляет собой заголовок карточки. Заголовки могут включать заголовок, подзаголовок и изображение аватара вашей карточки.

    Вы можете включить CardHeader для карточных сообщений и диалогов .

    Ниже приведен пример CardHeader :

    Определить раздел карты

    Виджет CardSection — это высокоуровневый контейнер внутри карточки. Разделы карты используются для группировки виджетов внутри карты. Для каждого раздела карточки вы можете включить заголовок и один или несколько виджетов.

    Вы можете включить CardSection для карточных сообщений и диалогов .

    Ниже приведен пример CardSection , который содержит два виджета textParagraph :

    Виджет CardFixedFooter представляет собой нижний колонтитул диалогового сообщения, отправленного приложением чата. Нижние колонтитулы могут включать в себя основную и дополнительную кнопку.

    Виджет CardFixedFooter доступен только для диалогов .

    Ниже приведен пример виджета CardFixedFooter с двумя кнопками:

    Устранение неполадок

    Когда приложение или карточка Google Chat возвращает ошибку, в интерфейсе Chat отображается сообщение «Что-то пошло не так». или «Невозможно обработать ваш запрос». Иногда в пользовательском интерфейсе чата не отображается сообщение об ошибке, но приложение или карточка чата выдает неожиданный результат; например, сообщение с карточкой может не появиться.

    Хотя сообщение об ошибке может не отображаться в пользовательском интерфейсе чата, доступны описательные сообщения об ошибках и данные журнала, которые помогут вам исправить ошибки, если включено ведение журнала ошибок для приложений чата. Информацию о просмотре, отладке и исправлении ошибок см. в разделе «Устранение неполадок и исправление ошибок Google Chat» .