Создав приложение 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.
Чтобы опубликовать свое приложение чата и сделать его доступным для других, обычно необходимо выполнить следующие действия:
- Включите и настройте Google Chat API . При настройке API вы предоставляете другим пользователям Google Chat доступ к вашему приложению Chat для тестирования.
- Опубликуйте свое приложение с помощью SDK Google Workspace Marketplace . Вы можете настроить приложение Chat так, чтобы оно было доступно пользователям вашей организации Google Workspace или всем пользователям Google Chat.
- Если ваша организация 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.
- Используйте кнопку ниже, чтобы создать новый проект (или выбрать существующий) и добавить в него сервисный аккаунт. Назначьте учетной записи службы роль владельца проекта .
Включить API - Сохраните загруженный ключ JSON. Ваше приложение может использовать этот ключ для проверки подлинности сообщений, которые оно отправляет в пространства асинхронно.
- Откройте свой проект в файле API Console . В списке API выберите Google Chat API .
- Выберите вкладку Конфигурация и введите информацию для приложения, как описано в следующей таблице.
Когда вы сохраняете конфигурацию приложения, ваше приложение становится доступным для указанных пользователей в вашей организации Google Workspace.
Настройки конфигурации Google Chat API
Поле | Описание |
---|---|
Имя приложения | Имя, которое люди используют при взаимодействии с вашим приложением. |
URL аватара | URL-адрес HTTPS, указывающий на квадратное графическое изображение (например, PNG или JPEG) размером не менее 128x128, которое будет отображаться в качестве аватара для вашего приложения. |
Описание | Описание функций приложения, которое отображается под названием вашего приложения. |
Функциональность | Набор полей, определяющих, какие события могут запускать приложение:
|
Настройки соединения | Конечная точка приложения, которая может быть одной из следующих:
|
Слеш-команды | Команды, которые могут отображаться для пользователей в 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, выполните следующие действия:
- Протестируйте приложение Chat, установив его из Chat . Убедитесь, что ваше приложение полностью функционально и не находится в стадии разработки.
- Просмотрите требования к публикации и убедитесь, что ваше приложение им всем соответствует. См. Области проверки .
- Запишите номер версии вашего приложения — это необходимо для настройки SDK Google Workspace Marketplace.
Когда вы будете готовы к публикации, см. раздел Обзор: публикация приложения .
Отключите приложение чата
После сохранения страницы конфигурации появится поле «Статус приложения». Это поле позволяет вам контролировать, является ли приложение активным или отключенным .
Чтобы отключить приложение чата:
- Откройте облачную консоль Google .
- При необходимости выберите проект Google Cloud, в котором размещено приложение Chat:
- Рядом с "Google Cloud" нажмите на стрелку вниз . Появится диалоговое окно со списком текущих проектов.
- Выберите проект, в котором размещено перенесенное приложение Chat.
- Щелкните Открыть .
- Найдите «Google Chat API» и нажмите Google Chat API .
- Щелкните Управление .
- Щелкните Конфигурация .
- В разделе «Статус приложения» выберите «Отключено» .
- Нажмите Сохранить .