Настройте API Чата Google

Для каждого создаваемого вами приложения Google Chat требуется собственный проект Google Cloud с включенным и настроенным Chat API. На этой странице показано, как настроить API чата.

Предварительные условия

Настройте API чата

  1. В консоли Google Cloud найдите «Google Chat API» и нажмите «Google Chat API» , затем нажмите «Управление» .

    Перейти к API чата

  2. Перейдите на вкладку «Конфигурация» и введите следующую необходимую информацию:

    • Имя приложения : имя, которое люди используют при взаимодействии с вашим приложением чата.
    • URL-адрес аватара : URL-адрес HTTPS, указывающий на квадратное графическое изображение (например, PNG или JPEG) размером не менее 128x128, которое отображается в качестве аватара для вашего приложения чата.
    • Описание : описание предназначения приложения Chat, которое отображается под названием вашего приложения Chat.

  3. Чтобы включить интерактивные функции, щелкните переключатель «Включить интерактивные функции» , который позволит пользователям взаимодействовать с вашим приложением чата, и используйте следующую таблицу для завершения настройки:

    Поле Описание
    Функциональность Набор полей, определяющих, как приложение 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 .

  4. Чтобы регистрировать ошибки в Cloud Logging каждый раз, когда приложение Chat возвращает ошибку, установите флажок Записывать ошибки в журнал . Дополнительные сведения см. в разделе Журналы ошибок запросов для приложений чата .

  5. Нажмите Сохранить . Когда вы сохраняете конфигурацию приложения 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.