Для каждого создаваемого вами приложения Google Chat требуется собственный проект Google Cloud с включенным и настроенным Chat API. На этой странице показано, как настроить API чата.
Предварительные условия
- Аккаунт Google Workspace с доступом к Google Chat .
- Проект Google Cloud .
- Настройте экран согласия OAuth .
- Включите API Чата Google
Настройте API чата
В консоли Google Cloud найдите «Google Chat API» и нажмите «Google Chat API» , затем нажмите « Управление» .
Перейдите на вкладку «Конфигурация» и введите следующую необходимую информацию:
- Имя приложения : имя, которое люди используют при взаимодействии с вашим приложением чата.
- URL-адрес аватара : URL-адрес HTTPS, указывающий на квадратное графическое изображение (например, PNG или JPEG) размером не менее 128x128, которое отображается в качестве аватара для вашего приложения чата.
- Описание : описание предназначения приложения Chat, которое отображается под названием вашего приложения Chat.
Чтобы включить интерактивные функции, нажмите переключатель «Включить интерактивные функции» , который позволит пользователям взаимодействовать с вашим приложением чата, и используйте следующую таблицу для завершения настройки:
Поле Описание Функциональность Набор полей, определяющих, как приложение Chat может взаимодействовать с пользователями: - Получайте сообщения 1:1 . Пользователи могут находить приложение Chat и отправлять ему сообщения прямо в Google Chat.
- Присоединяйтесь к группам и групповым беседам . Пользователи могут добавлять приложение Chat в группы и групповые беседы.
Настройки соединения Конечная точка для приложения Chat, которая может быть одной из следующих: - URL-адрес приложения : конечная точка HTTPS, на которой размещается реализация приложения Chat.
- Проект Apps Script : идентификатор развертывания проекта Apps Script, реализующего приложение Chat.
- Название темы Cloud Pub/Sub : тема Pub/Sub, на которую приложение Chat подписывается в качестве конечной точки.
- Dialogflow : регистрирует приложение Chat с интеграцией Dialogflow. Дополнительные сведения см. в разделе Создание приложения Google Chat Dialogflow, понимающего естественный язык .
Слэш-команды Команды, которые могут быть доступны пользователям в Google Chat. Позволяет пользователям видеть основные действия вашего приложения Chat в Google Chat и выбирать конкретное действие, с которым они хотят взаимодействовать. Дополнительные сведения см. в разделе «Реагирование на команды с косой чертой в приложении чата» . Предварительный просмотр ссылок Шаблоны URL-адресов, которые приложение Chat распознает и предоставляет дополнительный контент, когда пользователи отправляют ссылки. Дополнительную информацию см. в разделе Ссылки для предварительного просмотра . Видимость До 5 человек или одна или несколько групп Google, которые могут просматривать и устанавливать ваше приложение Chat. Используйте это поле, чтобы протестировать приложение Chat или поделиться им со своей командой. Дополнительную информацию см. в разделе Настройки видимости и публикации для вашего приложения Chat . Чтобы регистрировать ошибки в Cloud Logging каждый раз, когда приложение Chat возвращает ошибку, установите флажок Записывать ошибки в журнал . Дополнительные сведения см. в разделе Журналы ошибок запросов для приложений чата .
Нажмите Сохранить . Когда вы сохраняете конфигурацию приложения Chat, оно становится доступным указанным пользователям в вашей организации Google Workspace.
Предоставьте другим людям разрешение на настройку приложения чата
Вы можете предоставить определенным пользователям доступ к странице конфигурации приложения Chat. Используйте роли IAM «Владелец приложений чата» и «Просмотрщик приложений чата» . Пользователи с этими ролями не могут перейти на страницу конфигурации приложений Chat с помощью панели мониторинга API и служб , но могут получить доступ к странице конфигурации, перейдя в консоль Google Cloud для хост-проекта облака приложения Chat следующим образом:
https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID
Где PROJECT_ID
— это идентификатор проекта Google Cloud, в котором размещено приложение Chat.