На этой странице представлен обзор того, как создавать дополнения Google Workspace, расширяющие возможности Google Chat.
Дополнения Google Workspace, расширяющие возможности Chat, могут помочь пользователям выполнять следующие действия:
- Просматривайте ссылки из сообщений чата и предпринимайте действия, не покидая беседу.
- Автоматизируйте или выполняйте задачи в приложениях Google Workspace.
- Получайте оповещения и уведомления о внешних инструментах или услугах.
Как дополнения Google Workspace работают в чате
В Chat дополнения отображаются для пользователей как приложения Google Chat. Для взаимодействия с пользователями приложения Chat могут выполнять следующие действия:
- Отправляйте сообщения , содержащие текст, карточки и интерактивные элементы пользовательского интерфейса.
- Реагируйте на быстрые команды .
- Реагировать на команды с косой чертой .
- Открывайте диалоговые окна , чтобы помочь пользователям выполнять многоэтапные процессы, такие как заполнение данных форм.
- Просматривайте ссылки в сообщениях, прикрепляя карточки с полезной информацией, которые позволяют пользователям выполнять действия прямо из беседы.
Начать
Чтобы приступить к созданию дополнений Google Workspace, работающих в Chat, ознакомьтесь со следующей документацией:
- Попробуйте быстро создать простое приложение чата с использованием скрипта Google Apps или службы HTTP .
- Настройте приложение чата и его интерактивные функции с помощью API чата.
- Узнайте о способах создания интерфейсов чата с использованием дополнительных триггеров, действий и объектов событий.
Ограничения и известные проблемы
Следующие функции чата и дополнительных функций недоступны:
- Архитектуры приложения Chat Dialogflow , Pub/Sub и AppSheet недоступны. Вместо этого вы должны построить приложение Chat с помощью Apps Script или HTTP-сервиса.
- Служба карт Apps Script. Чтобы использовать действия чата и создавать карточки, вместо этого возвращайте объекты JSON. Примеры см. в разделах Открытие интерактивных диалогов и Ссылки предварительного просмотра .
- Пользовательские карты авторизации. Для аутентификации и предоставления авторизации вашей службе из Chat приложение Chat должно вернуть базовую карту авторизации .
- Домашние страницы дополнений в боковой панели чата. Если вы настроили триггер домашней страницы для своего дополнения, домашняя страница отображается только в боковой панели других приложений Google Workspace, которые расширяет ваше дополнение.
- Домашние страницы приложения чата , которые отображаются на вкладке «Главная» в прямых сообщениях приложения чата.
Если вы обновляете существующее дополнение Google Workspace, учтите следующие требования к конфигурации приложений Chat:
- Параметры установки Google Workspace Marketplace должны разрешать установку дополнения как отдельным лицам, так и администраторам Google Workspace.
- Любые общие параметры конфигурации в манифесте дополнения (
addons.common) игнорируются в Chat. Чтобы настроить дополнение для работы в Chat, необходимо включить и настроить API чата. Для получения инструкций см. Настройка приложения Google Chat . - Чтобы развернуть и протестировать надстройку в Chat, необходимо использовать настройку Видимость API Chat. Любые настройки видимости или тестирования, настроенные в SDK Google Workspace Marketplace, игнорируются. Чтобы развернуть тестовую версию надстройки в Chat, см. раздел Тестирование интерактивных функций для приложений Google Chat в документации по API Chat.
- Если ваши дополнения опубликованы в Google Workspace Marketplace, вы не можете сохранить черновик любых изменений в настройках конфигурации API чата Google . При обновлении настроек конфигурации API чата обновленное приложение Chat немедленно становится доступным для всех существующих пользователей. Чтобы обновить листинг Marketplace, вы можете создать черновик перед отправкой любых изменений.