Публикация приложений Google Chat

Создав приложение Chat, вы можете опубликовать его, чтобы оно было доступно избранным людям или группам, всем в вашей организации Google Workspace или любому пользователю Google Chat.

Как пользователи находят и используют приложения Chat

Чтобы обнаружить приложения Google Chat, пользователи могут выполнить любое из следующих действий:

  • Найдите и установите приложения Chat из Google Chat или Google Workspace Marketplace .
  • Взаимодействуйте с приложением, добавленным в пространство чата.
  • Откройте для себя приложение на панели личных сообщений после того, как администратор Google Workspace установил приложение от его имени.

Чтобы начать использовать приложение, пользователи Google Chat могут отправить прямое сообщение с помощью приложения или добавить его в пространство. Пользователи также могут добавить приложение, упомянув его @. В следующем примере показано, как пользователь @ упоминает приложение Chat, чтобы добавить его в пространство:

Добавление приложения в пространство путем ввода @ в сообщении.

Как администраторы Google Workspace устанавливают приложения Chat

Администраторы Google Workspace могут найти приложения Chat в Google Workspace Marketplace и установить их для пользователей своей организации . Когда администратор устанавливает приложение чата, оно появляется на панели личных сообщений пользователей.

Администраторы Google Workspace также могут управлять использованием приложений Chat и вносить их в список разрешенных в своей организации Google Workspace. Если вы разрабатываете приложение чата для организации, которая использует белые списки, вы должны попросить администратора добавить ваше приложение чата в белый список, чтобы пользователи могли найти и использовать его. Дополнительную информацию см. в справке администратора Google Workspace «Разрешить пользователям устанавливать приложения Chat» .

Настройте и опубликуйте свое приложение Chat с помощью консоли Google Cloud.

Чтобы опубликовать приложение Chat и сделать его доступным для других, обычно необходимо выполнить следующие действия:

  1. Включите и настройте Google Chat API . Настраивая API, вы предоставляете другим пользователям Google Chat доступ к вашему приложению Chat для тестирования.
  2. Опубликуйте свое приложение с помощью SDK Google Workspace Marketplace . Вы можете настроить приложение Chat так, чтобы оно было доступно пользователям вашей организации Google Workspace или всем пользователям Google Chat.
  3. Если ваша организация Google Workspace управляет доступом к приложениям Chat, попросите администратора Google Workspace добавить приложение в белый список организации.

Настройки видимости и публикации для вашего приложения Chat

В следующей таблице показано, как настроить параметры Google Chat API и Google Workspace Marketplace SDK в зависимости от аудитории вашего приложения Chat:

Предполагаемые пользователи приложения Метод аутентификации Настройки API Google Чата Настройки SDK Google Workspace Marketplace Где опубликовано мое приложение Chat?
Ваша маленькая команда Выполните аутентификацию как пользователь или приложение . В настройке «Видимость» укажите людей или группы Google, которые могут получить доступ к приложению.

Если ваша учетная запись Google Workspace требует внесения приложений в белый список, вы можете указать только до 5 отдельных адресов электронной почты (вы не можете указать группы Google).

Вам не нужно настраивать SDK Google Workspace Marketplace для приложения Chat. Члены команды могут найти и использовать ваше приложение Chat из Google Chat.
Ваша большая команда Выполните аутентификацию как пользователь или приложение . В настройке «Видимость» укажите людей или группы Google, которые будут тестировать ваше приложение Chat.

После тестирования опубликуйте приложение Chat в своей организации Google Workspace, используя настройки в SDK Google Workspace Marketplace.

Установите для видимости приложения значение «Частное» .

Установите для параметров установки значение Индивидуальный + Администратор .

Если ваша учетная запись Google Workspace требует внесения приложений в белый список, попросите администратора добавить ваше приложение Chat в белый список, чтобы пользователи могли найти и использовать его. Дополнительную информацию см. в справке администратора Google Workspace «Разрешить пользователям устанавливать приложения Chat» .

Любой сотрудник вашей организации Google Workspace может найти и установить ваше приложение Chat в Google Chat, а также просмотреть его в Google Workspace Marketplace. Пользователи и администраторы Google Workspace могут установить ваше приложение из Marketplace.

Ваша организация Google Workspace Выполните аутентификацию как пользователь или приложение . В настройке «Видимость» укажите людей или группы Google, которые будут тестировать ваше приложение Chat.

После тестирования опубликуйте приложение Chat в своей организации Google Workspace, используя настройки в SDK Google Workspace Marketplace.

Установите для видимости приложения значение «Частное» .

Установите для параметров установки значение Индивидуальный + Администратор .

Любой сотрудник вашей организации Google Workspace может найти и установить ваше приложение Chat в Google Chat, а также просмотреть его в Google Workspace Marketplace. Только администраторы Google Workspace могут установить ваше приложение из Marketplace.

Все (приложение общедоступного чата) Выполните аутентификацию как пользователь или приложение . В настройке «Видимость» укажите людей или группы Google, которые будут тестировать ваше приложение Chat.

После тестирования опубликуйте свое приложение Chat публично, используя настройки Google Workspace Marketplace.

Установите видимость приложения как общедоступную .

Установите для параметров установки значение «Индивидуальный + Администратор».

Любой пользователь Google Workspace может найти и установить ваше приложение Chat в Google Chat, а также просмотреть его в Google Workspace Marketplace. Только администраторы Google Workspace могут установить ваше приложение из Marketplace.

Включите и настройте API Google Chat

Настройте проект для своего приложения в консоли Google Cloud и включите API Google Chat:

  1. Используйте кнопку ниже, чтобы создать новый проект (или выбрать существующий) и добавить к нему сервисную учетную запись. Назначьте сервисному аккаунту роль владельца проекта .
    Включить API
  2. Сохраните загруженный ключ JSON. Ваше приложение может использовать этот ключ для аутентификации сообщений, которые оно отправляет в пространства асинхронно.
  3. Откройте свой проект в . В списке API нажмите Google Chat API .
  4. Выберите вкладку «Конфигурация» и введите информацию о приложении, как описано в следующей таблице.

Когда вы сохраните конфигурацию приложения, оно станет доступно указанным пользователям в вашей организации Google Workspace.

Параметры конфигурации API Google Chat

Поле Описание
Имя приложения Имя, которое люди используют при взаимодействии с вашим приложением чата.
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. Тема Cloud Pub/Sub, на которую приложение Chat подписывается в качестве конечной точки.
  • Dialogflow : регистрирует приложение Chat с интеграцией Dialogflow. Дополнительную информацию см. в документации Dialogflow по интеграции с Google Chat.
Слэш-команды Команды, которые могут быть доступны пользователям в Google Chat. Позволяет пользователям видеть основные действия вашего приложения Chat в Google Chat и выбирать конкретное действие, с которым они хотят взаимодействовать.
Предварительный просмотр ссылок Шаблоны URL-адресов, которые приложение Chat распознает и предоставляет дополнительный контент, когда пользователи отправляют ссылки. Для получения дополнительной информации обратитесь к ссылкам предварительного просмотра .
Видимость До 5 человек или одна или несколько групп Google, которые могут просматривать и устанавливать ваше приложение Chat. Используйте это поле, чтобы протестировать приложение Chat или поделиться им со своей командой. Дополнительные сведения см. в разделе «Настройки видимости и публикации для вашего приложения Chat» .

Предоставьте разрешения на настройку приложения

Вы можете предоставить определенным пользователям доступ к странице конфигурации приложения. Для этого используйте роли IAM «Владелец приложений чата» и «Просмотрщик приложений чата» . Пользователи с этими ролями не могут перейти на страницу конфигурации приложения через панель мониторинга API и служб , но могут получить доступ к странице конфигурации, перейдя к консоли своего проекта следующим образом:

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

Опубликуйте свое приложение с помощью SDK Google Workspace Marketplace.

Используйте SDK Google Workspace Marketplace для выполнения любого из следующих действий:

  • Опубликуйте свое приложение Chat публично и позвольте любому пользователю Google Chat добавить его в пространство.
  • Опубликуйте приложение Chat в своей организации Google Workspace.
  • Сделайте свое приложение видимым для администраторов Google Workspace, чтобы они могли установить его для пользователей своей организации . Чтобы ваше приложение было доступно администраторам Google Workspace, оно должно поддерживать прямой обмен сообщениями.

Прежде чем опубликовать свое приложение с помощью SDK Google Workspace Marketplace, выполните следующие действия:

  1. Проверьте свое приложение Chat, установив его из Chat . Убедитесь, что ваше приложение полностью функционально и не находится в стадии разработки.
  2. Ознакомьтесь с требованиями к публикации и убедитесь, что ваше приложение им всем соответствует. См. Области обзора .
  3. Запишите номер версии вашего приложения: он понадобится вам для настройки SDK Google Workspace Marketplace.

Когда вы будете готовы к публикации, см. раздел Обзор: публикация приложения .