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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Вам не нужно настраивать SDK Google Workspace Marketplace для приложения Chat. Члены команды могут найти и использовать ваше приложение для чата в Google Chat.
...Для моей большой команды Авторизоваться как пользователь или приложение . В настройках видимости укажите людей и/или группы Google для тестирования вашего приложения чата.

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

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

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

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

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

...Для моей организации Google Workspace Авторизоваться как пользователь или приложение . В настройках видимости укажите людей и/или группы Google для тестирования вашего приложения чата.

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

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

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

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

...Для всех (приложение общедоступного чата) Авторизоваться как приложение . В настройках видимости укажите людей и/или группы Google для тестирования вашего приложения чата.

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

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

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

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

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

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

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

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

Настройки конфигурации Google Chat API

Поле Описание
Имя приложения Имя, которое люди используют при взаимодействии с вашим приложением.
URL аватара URL-адрес HTTPS, указывающий на квадратное графическое изображение (например, PNG или JPEG) размером не менее 128x128, которое будет отображаться в качестве аватара для вашего приложения.
Описание Описание функций приложения, которое отображается под названием вашего приложения.
Функциональность Набор полей, определяющих, какие события могут запускать приложение:
  • Получение сообщений 1:1 : пользователи могут найти приложение и отправить ему сообщение непосредственно в Google Chat.
  • Получение событий от установки администратора . Получайте события ADDED_TO_SPACE или REMOVED_FROM_SPACE от Chat, когда администратор Google Workspace устанавливает или удаляет приложение в своей организации. По умолчанию приложение не получает эти события, если вы не согласитесь на их получение, поскольку это может привести к увеличению количества запросов в секунду.
  • Присоединяйтесь к пространствам и групповым беседам . Приложение может присоединяться к пространствам и групповым беседам, когда оно к ним добавлено.
Настройки соединения Конечная точка приложения, которая может быть одной из следующих:
  • URL-адрес приложения : конечная точка HTTPS, на которой размещена реализация приложения.
  • Проект скрипта приложений . Идентификатор развертывания для проекта скрипта приложений, который реализует приложение.
  • Название темы Cloud Pub/Sub . Тема Cloud Pub/Sub, на которую приложение подписывается как на конечную точку.
  • Dialogflow : регистрирует приложение с интеграцией Dialogflow. Для получения дополнительной информации см. документацию Dialogflow по интеграции с Google Chat.
Слеш-команды Команды, которые могут отображаться для пользователей в Google Chat. Позволяет пользователям видеть основные действия для вашего приложения в Google Chat и выбирать конкретное действие, с которым они хотят взаимодействовать.
Ссылка разворачивается Шаблоны URL-адресов, которые приложение распознает и предоставляет дополнительный контент, когда пользователи отправляют ссылки. Дополнительные сведения см. в разделе Развернуть ссылки .
Видимость До 5 человек или одна или несколько групп Google, которые могут просматривать и устанавливать ваше приложение Chat. Используйте это поле, чтобы протестировать свое приложение или поделиться им со своей командой. Дополнительные сведения см. в разделе Настройки видимости и публикации для приложения Chat .

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

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

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

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

Используйте SDK Google Workspace Marketplace, чтобы:

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

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

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

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

Отключите приложение чата

После сохранения страницы конфигурации появится поле «Статус приложения». Это поле позволяет вам контролировать, является ли приложение активным или отключенным .

Чтобы отключить приложение чата:

  1. Откройте облачную консоль Google .
  2. При необходимости выберите проект Google Cloud, в котором размещено приложение Chat:
    1. Рядом с "Google Cloud" нажмите на стрелку вниз . Появится диалоговое окно со списком текущих проектов.
    2. Выберите проект, в котором размещено перенесенное приложение Chat.
    3. Щелкните Открыть .
  3. Найдите «Google Chat API» и нажмите Google Chat API .
  4. Щелкните Управление .
  5. Щелкните Конфигурация .
  6. В разделе «Статус приложения» выберите «Отключено» .
  7. Нажмите Сохранить .