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