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