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