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

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

Примечание. На этой странице объясняется, как публиковать приложения чата с помощью консоли Google Cloud. Если вы создали приложение Chat с автоматической настройкой Google AppSheet, вам не нужно использовать консоль Google Cloud для публикации своего приложения Chat. Вместо этого используйте шаги, описанные в документации AppSheet, Поделитесь своим приложением Chat с помощью автоматической настройки .

Как пользователи находят и используют приложения 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

Пользователи с ролями Project также могут получить доступ к странице конфигурации приложения.

Пользователи с настраиваемыми ролями, содержащими разрешения resourcemanager.projects.(get|update), не могут получить доступ к конфигурации приложения. Для пользовательских ролей вместо этого используйте разрешения chat.apps.(get|update) .

Опубликуйте свое приложение с помощью 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.

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

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

Примечание. Если вы создали приложение Chat с помощью автоматической настройки AppSheet, отключите свое приложение, выполнив действия, описанные в разделе Отключение приложений Chat в документации AppSheet.

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

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

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