На этой странице представлен обзор того, как создавать дополнения 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 Chat. Инструкции см. в разделе «Настройка приложения Google Chat» . - Для развертывания и тестирования надстройки в Chat необходимо использовать настройку видимости Chat API. Любые настройки видимости или тестирования, настроенные в Google Workspace Marketplace SDK, игнорируются. Чтобы развернуть тестовую версию надстройки в Chat, см. раздел Тестирование интерактивных функций для приложений Google Chat в документации по Chat API.
- Если ваши дополнения опубликованы в Google Workspace Marketplace, вы не сможете сохранить черновик любых изменений в настройках конфигурации API Google Chat . При обновлении настроек конфигурации API Chat обновлённое приложение Chat сразу же становится доступно всем существующим пользователям. Чтобы обновить данные о дополнениях в Marketplace, вы можете создать черновик перед отправкой каких-либо изменений.