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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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