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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

Пользователи также могут сузить предлагаемый список получателей, @упомянув приложение по имени. Например, если вы публикуете приложение под названием «Scheduler Bot», а пользователь в вашем домене вводит «@sch», то Google Chat предложит ваше приложение в качестве одного из вариантов автозаполнения.

Поделитесь своим приложением с другими

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

В зависимости от предполагаемой аудитории и настроек домена вам может потребоваться выполнить дополнительные действия, перечисленные ниже.

Делитесь своим приложением только в пределах своего домена

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

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

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

Сделайте ваше приложение общедоступным

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

Включить API чата Google

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

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

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

О конфигурации приложения

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

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

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

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

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

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

Вы можете предоставить определенным пользователям доступ к странице конфигурации приложения. Для этого используйте роли 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, выполните следующие действия:

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

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