На этой странице описано, как спроектировать и создать основные компоненты пользовательского интерфейса карточных сообщений в Google Chat.
Карты поддерживают определенный макет, интерактивные элементы пользовательского интерфейса, такие как кнопки, и мультимедийные средства, например изображения. Вы можете использовать карточки для представления информации, сбора данных или предоставления пользователям следующих действий с помощью карточных сообщений и диалогов .
Используйте конструктор карточек для разработки и предварительного просмотра карточных сообщений JSON для приложений чата:
Откройте конструктор карточекКарты и диалоги обычно состоят из следующих компонентов:
-
CardHeader
, содержащий название вашей карты. - Один или несколько виджетов
CardSection
, образующих основную часть карточки. - Виджет
CardFixedFooter
, предназначенный только для диалогов .
Предварительные условия
Приложение Google Chat с интерактивными функциями. Чтобы создать интерактивное приложение чата, выполните одно из следующих кратких руководств в зависимости от архитектуры приложения , которую вы хотите использовать:
- HTTP-сервис с облачными функциями Google
- Скрипт Google Apps
- Google Cloud Dialogflow CX
- Google Cloud Pub/Sub
Добавить заголовок
Виджет CardHeader
представляет собой заголовок карточки. Заголовки могут включать заголовок, подзаголовок и изображение аватара вашей карточки.
Вы можете включить CardHeader
для карточных сообщений и диалогов .
Ниже приведен пример CardHeader
:
Определить раздел карты
Виджет CardSection
— это высокоуровневый контейнер внутри карточки. Разделы карты используются для группировки виджетов внутри карты. Для каждого раздела карточки вы можете включить заголовок и один или несколько виджетов.
Вы можете включить CardSection
для карточных сообщений и диалогов .
Ниже приведен пример CardSection
, который содержит два виджета textParagraph
:
Настраиваемая кнопка управления складной секцией
Настройте кнопку управления, которая сворачивает и разворачивает разделы в карточках чата. Выбирайте из множества значков или изображений, чтобы визуально представить содержимое раздела, чтобы пользователям было легче понимать информацию и взаимодействовать с ней.
Добавьте постоянный нижний колонтитул
Виджет CardFixedFooter
представляет собой нижний колонтитул диалогового сообщения, отправленного приложением чата. Нижние колонтитулы могут включать в себя основную и дополнительную кнопку.
Виджет CardFixedFooter
доступен только для диалогов .
Ниже приведен пример виджета CardFixedFooter
с двумя кнопками:
Устранение неполадок
Когда приложение или карточка Google Chat возвращает ошибку, в интерфейсе Chat отображается сообщение «Что-то пошло не так». или «Невозможно обработать ваш запрос». Иногда в пользовательском интерфейсе чата не отображается сообщение об ошибке, но приложение или карточка чата выдает неожиданный результат; например, сообщение с карточкой может не появиться.
Хотя сообщение об ошибке может не отображаться в пользовательском интерфейсе чата, доступны описательные сообщения об ошибках и данные журнала, которые помогут вам исправить ошибки, если включено ведение журнала ошибок для приложений чата. Информацию о просмотре, отладке и исправлении ошибок см. в разделе «Устранение неполадок и исправление ошибок Google Chat» .