На этой странице объясняется, как создать домашнюю страницу для вашего приложения Google Chat. Главная страница приложения — это настраиваемый интерфейс карточки, который приложение Chat отправляет пользователю, когда он открывает прямое сообщение с помощью приложения Chat.
Например, вы можете настроить сообщение на главной карточке приложения, включив в него советы по взаимодействию с приложением Chat с помощью команд с косой чертой . Для конечных пользователей главная страница приложения доступна только в прямом сообщении приложения Chat, если разработчик приложения включил эту функцию.
Используйте конструктор карточек для разработки и предварительного просмотра карточных сообщений JSON для приложений чата:
Откройте конструктор карточекПредварительные условия
Питон
Приложение Google Chat с интерактивными функциями. Чтобы создать интерактивное приложение чата с использованием службы HTTP, выполните это краткое руководство .Скрипт приложений
Приложение Google Chat с интерактивными функциями. Чтобы создать интерактивное приложение чата с помощью Apps Script, выполните это краткое руководство .Node.js
Приложение Google Chat с интерактивными функциями. Чтобы создать интерактивное приложение чата с использованием службы HTTP, выполните это краткое руководство .Ява
Приложение Google Chat с интерактивными функциями. Чтобы создать интерактивное приложение чата с использованием службы HTTP, выполните это краткое руководство .Настройте API чата
Для поддержки приложения Home вам необходимо обновить конфигурацию Chat API в консоли Google Cloud.
Питон
В консоли Google Cloud выберите Меню > продукты > Google Workspace > Библиотека продуктов > Google Chat API .
Нажмите «Управление» , а затем перейдите на вкладку «Конфигурация» .
Установите флажок «Домашняя страница приложения поддержки» .
В поле «Домашний URL-адрес приложения» добавьте URL-адрес. Обычно это значение совпадает с URL-адресом приложения . Этот URL-адрес вызывается для событий
APP_HOME
.Нажмите Сохранить .
Скрипт приложений
В консоли Google Cloud выберите Меню > продукты > Google Workspace > Библиотека продуктов > Google Chat API .
Нажмите «Управление» , а затем перейдите на вкладку «Конфигурация» .
Установите флажок «Домашняя страница приложения поддержки» .
Нажмите Сохранить .
Node.js
В консоли Google Cloud выберите Меню > продукты > Google Workspace > Библиотека продуктов > Google Chat API .
Нажмите «Управление» , а затем перейдите на вкладку «Конфигурация» .
Установите флажок «Домашняя страница приложения поддержки» .
В поле «Домашний URL-адрес приложения» добавьте URL-адрес. Обычно это значение совпадает с URL-адресом приложения . Этот URL-адрес вызывается для событий
APP_HOME
.Нажмите Сохранить .
Ява
В консоли Google Cloud выберите Меню > продукты > Google Workspace > Библиотека продуктов > Google Chat API .
Нажмите «Управление» , а затем перейдите на вкладку «Конфигурация» .
Установите флажок «Домашняя страница приложения поддержки» .
В поле «Домашний URL-адрес приложения» добавьте URL-адрес. Обычно это значение совпадает с URL-адресом приложения . Этот URL-адрес вызывается для событий
APP_HOME
.Нажмите Сохранить .
Создайте домашнюю страницу приложения
Домашняя карточка приложения запускается, когда пользователь открывает прямое сообщение из приложения «Чат», и ее можно обновить в ответ на интерактивное событие, такое как нажатие кнопки, отправка формы или закрытие диалогового окна.
В следующем примере приложение Chat отображает начальную домашнюю карточку приложения, на которой отображается время создания карточки, а также кнопка. Когда пользователь нажимает кнопку, приложение Chat возвращает обновленную карточку, на которой отображается время создания обновленной карточки.
Создайте начальную карточку для главной страницы приложения.
Чтобы создать домашнюю страницу приложения, приложение Chat должно обрабатывать события взаимодействия APP_HOME
и возвращать экземпляр RenderActions
с навигацией pushCard
.
Питон
Скрипт приложений
Реализуйте функцию onAppHome
, которая вызывается после всех событий APP_HOME
:
В этом примере отправляется карточное сообщение, возвращая card JSON . Вы также можете использовать сервис карточек Apps Script .
Node.js
Ява
Обновить домашнюю карточку приложения
Если ваша первоначальная домашняя карточка приложения содержит интерактивные виджеты, такие как кнопки или средства выбора, ваше приложение Chat должно обрабатывать соответствующие события взаимодействия, возвращая экземпляр RenderActions
с навигацией updateCard
. Дополнительные сведения об работе с интерактивными виджетами см. в разделе Обработка информации, введенной пользователями .
Питон
Скрипт приложений
В этом примере отправляется карточное сообщение, возвращая card JSON . Вы также можете использовать сервис карточек Apps Script .
Node.js
Ява
Ограничения
Как правило, navigation
недоступна для приложений чата. Вы не можете вернуть стопку карт. Для приложений чата доступны только pushCard
(для первоначального ответа) и updateCard
(для обновлений).
Связанные темы
- Просмотрите примеры приложений чата , в которых используется домашняя страница приложения.
Чтобы открыть диалоговое окно, используйте взаимодействие
OPEN_DIALOG
. Дополнительные сведения см. в разделе Открытие диалогового окна в ответ на домашнюю карточку приложения .Чтобы закрыть диалоговое окно, используйте взаимодействие
CLOSE_DIALOG
чтобы закрыть диалоговое окно и вернуться к домашней карточке приложения, или используйте взаимодействиеCLOSE_DIALOG_EXECUTE
, чтобы закрыть диалоговое окно и обновить домашнюю карточку приложения. Дополнительные сведения см. в разделе «Ответ на диалоговое окно для домашней карточки приложения» .Пример использования домашней страницы приложения см. в приложении Chat для управления проблемами в лаборатории разработки кода. Создание приложений для Google Chat с помощью Gemini .