На этой странице объясняется, как создать домашнюю страницу для прямых сообщений с помощью приложения Google Chat. Домашняя страница, называемая домашней страницей приложения в API Google Chat, представляет собой настраиваемый интерфейс карты, который отображается на вкладке «Главная» пространства прямых сообщений между пользователем и приложением Chat.

Вы можете использовать домашнюю страницу приложения, чтобы делиться советами по взаимодействию с приложением Chat или предоставлять пользователям доступ и возможность использовать внешние сервисы или инструменты из Chat.
Используйте Card Builder для проектирования и предварительного просмотра сообщений и пользовательских интерфейсов для приложений чата:
Откройте конструктор картПредпосылки
Node.js
Приложение Google Chat, которое получает и отвечает на события взаимодействия . Чтобы создать интерактивное приложение Chat с использованием HTTP-сервиса, выполните это краткое руководство .Питон
Приложение Google Chat, которое получает и отвечает на события взаимодействия . Чтобы создать интерактивное приложение Chat с использованием HTTP-сервиса, выполните это краткое руководство .Ява
Приложение Google Chat, которое получает и отвечает на события взаимодействия . Чтобы создать интерактивное приложение Chat с использованием HTTP-сервиса, выполните это краткое руководство .Скрипт приложений
Приложение Google Chat, которое получает и отвечает на события взаимодействия . Чтобы создать интерактивное приложение Chat в Apps Script, выполните это краткое руководство .Настройте домашнюю страницу приложения для вашего чата
Для поддержки домашней страницы приложения необходимо настроить приложение Chat на получение событий взаимодействия APP_HOME
. Ваше приложение Chat получает это событие всякий раз, когда пользователь нажимает вкладку «Главная» из прямого сообщения в приложении Chat.
Чтобы обновить параметры конфигурации в консоли Google Cloud, выполните следующие действия:
В консоли Google Cloud перейдите Дополнительные продукты > Google Workspace > Библиотека продуктов > Google Chat API .
>Нажмите «Управление» , а затем перейдите на вкладку «Конфигурация» .
В разделе «Интерактивные функции» перейдите в раздел «Функциональность» , чтобы настроить домашнюю страницу приложения:
- Установите флажок «Принимать сообщения 1:1» .
- Установите флажок «Поддержка приложения Home» .
Если ваше приложение Chat использует HTTP-сервис, перейдите в настройки подключения и укажите конечную точку для поля App Home URL . Вы можете использовать тот же URL, который вы указали в поле HTTP endpoint URL .
Нажмите «Сохранить» .
Создайте домашнюю карточку приложения
Когда пользователь открывает домашнюю страницу приложения, ваше приложение Chat должно обрабатывать событие взаимодействия APP_HOME
, возвращая экземпляр RenderActions
с навигацией pushCard
и Card
. Для создания интерактивного опыта карта может содержать интерактивные виджеты, такие как кнопки или текстовые поля, которые приложение Chat может обрабатывать и на которые можно отвечать дополнительными картами или диалогом.
В следующем примере приложение Chat отображает начальную домашнюю карточку приложения, которая отображает время создания карточки и кнопку. Когда пользователь нажимает кнопку, приложение Chat возвращает обновленную карточку, которая отображает время создания обновленной карточки.
Node.js
Питон
Ява
Скрипт приложений
Реализуйте функцию onAppHome
, которая вызывается после всех событий взаимодействия APP_HOME
:
Этот пример отправляет сообщение карты, возвращая карту JSON . Вы также можете использовать службу карт Apps Script .
Отвечайте на взаимодействия с домашним приложением
Если ваша начальная домашняя карточка приложения содержит интерактивные виджеты, такие как кнопки или входы выбора, ваше приложение Chat должно обрабатывать соответствующие события взаимодействия, возвращая экземпляр RenderActions
с навигацией updateCard
. Чтобы узнать больше об обработке интерактивных виджетов, см. Обработка информации, введенной пользователями .
В предыдущем примере начальная карточка домашней страницы приложения включала кнопку. Всякий раз, когда пользователь нажимает кнопку, событие взаимодействия CARD_CLICKED
запускает функцию updateAppHome
для обновления карточки домашней страницы приложения, как показано в следующем коде:
Node.js
Питон
Ява
Скрипт приложений
Этот пример отправляет сообщение карты, возвращая карту JSON . Вы также можете использовать службу карт Apps Script .
Открытые диалоги
Ваше приложение чата также может реагировать на взаимодействия на главной странице приложения, открывая диалоги .

Чтобы открыть диалог из домашней страницы приложения, обработайте соответствующее событие взаимодействия, вернув renderActions
с навигацией updateCard
, содержащей объект Card
. В следующем примере приложение Chat реагирует на нажатие кнопки из домашней страницы приложения, обрабатывая событие взаимодействия CARD_CLICKED
и открывая диалог:
{ renderActions: { action: { navigations: [{ updateCard: { sections: [{
header: "Add new contact",
widgets: [{ "textInput": {
label: "Name",
type: "SINGLE_LINE",
name: "contactName"
}}, { textInput: {
label: "Address",
type: "MULTIPLE_LINE",
name: "address"
}}, { decoratedText: {
text: "Add to favorites",
switchControl: {
controlType: "SWITCH",
name: "saveFavorite"
}
}}, { decoratedText: {
text: "Merge with existing contacts",
switchControl: {
controlType: "SWITCH",
name: "mergeContact",
selected: true
}
}}, { buttonList: { buttons: [{
text: "Next",
onClick: { action: { function: "openSequentialDialog" }}
}]}}]
}]}}]}}}
Чтобы закрыть диалог, обработайте следующие события взаимодействия:
-
CLOSE_DIALOG
: закрывает диалоговое окно и возвращается на начальную домашнюю карточку приложения «Чат». -
CLOSE_DIALOG_AND_EXECUTE
: закрывает диалоговое окно и обновляет домашнюю карточку приложения.
В следующем примере кода CLOSE_DIALOG
используется для закрытия диалогового окна и возврата на домашнюю карточку приложения:
{ renderActions: { action: {
navigations: [{ endNavigation: { action: "CLOSE_DIALOG" }}]
}}}
Для сбора информации от пользователей вы также можете строить последовательные диалоги. Чтобы узнать, как строить последовательные диалоги, см. Открытие и ответ на диалоги .
Похожие темы
- Посмотрите примеры приложений чата , использующих домашнюю страницу приложения.
- Открывайте диалоги и отвечайте на них .