Настройка уведомлений Pub/Sub

Уведомления Pub/Sub позволяют вам получать оповещения о новых зарегистрированных устройствах, отчеты об устройствах и недавно выданных командах .

Чтобы настроить уведомления Pub/Sub, необходимо включить API Pub/Sub и создать тему . Чтобы получать сообщения, опубликованные в теме, создайте на неё подписку. Подписка подключает тему к приложению-подписчику, которое получает и обрабатывает сообщения, опубликованные в теме. После создания подписки необходимо предоставить Android Device Policy разрешение на публикацию в вашей теме.

1. Включите API Pub/Sub для вашего проекта.

Инструкции по включению API Pub/Sub см. в кратком руководстве по консоли . Убедитесь, что вы выбрали тот же проект , для которого включен API управления Android .

2. Создайте тему

После включения API необходимо создать тему, в которой Android Device Policy сможет публиковать уведомления. Создать тему можно двумя способами:

а. Вручную в консоли Google Cloud .
б. Использование API Pub/Sub (см. метод создания темы ).

После создания темы обратите внимание на ее название.

3. Создайте подписку

Подписка охватывает поток сообщений, опубликованных по заданной теме. Подписку можно создать двумя способами:

а. Вручную в консоли Google Cloud .
б. Используя API Pub/Sub (см. метод создания подписки ).

4. Предоставьте Android Device Policy право на публикацию в вашей теме.

Вам необходимо предоставить android-cloud-policy@system.gserviceaccount.com разрешение на публикацию в вашей теме. Существует два способа предоставить права на публикацию:

а. Вручную в консоли Google Cloud .

  • Добавьте android-cloud-policy@system.gserviceaccount.com в качестве участника вашей темы.
  • Нажмите Выбрать роль > Pub/Sub > Издатель Pub/Sub .

б. Использование API Pub/Sub (см. раздел Управление доступом через API IAM )

  • Добавьте serviceAccount:android-cloud-policy@system.gserviceaccount.com в список members .
  • Установите role на roles/pubsub.publisher .

5. Обновите корпоративную версию для поддержки уведомлений.

Пропустите этот шаг, если вы хотите поддерживать уведомление ENTERPRISE_UPGRADE , которое поддерживается всегда.

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

  • pubsubTopic : Название вашей темы pub/sub в формате projects/{project}/topics/{topic} .
  • enabledNotificationTypes : включите все типы уведомлений, которые вы хотите получать.

6. Используйте API Pub/Sub для получения уведомлений.

Подписка может использовать как push-, так и pull-механизм доставки сообщений. Инструкции и указания по получению уведомлений с использованием обоих этих механизмов доступны в Руководстве подписчика Pub/Sub .

Формат сообщения

Сообщения имеют форму PubsubMessage . Поле attributes сообщения содержит атрибут с ключом notificationType и значением, соответствующим типу уведомления, вызвавшему отправку сообщения (например, ENROLLMENT ). Поле data сообщения содержит JSON-представление обновлённого ресурса, закодированное в виде строки UTF-8. Уведомления и соответствующие им типы ресурсов перечислены ниже:

  • Уведомления COMMAND используют тип ресурса Operation .
  • Уведомления USAGE_LOGS используют тип ресурса UsageLogEvent .
  • Уведомления ENROLLMENT и STATUS_REPORT используют тип ресурса Устройство .
  • Уведомления ENTERPRISE_UPGRADE используют тип ресурса EnterpriseUpgradeEvent .

При настройке pubsubTopic на Enterprise будет опубликовано начальное сообщение с notificationType , равным test . Это сообщение отправляется для проверки наличия у Android Device Policy разрешения на публикацию темы и его следует игнорировать.

Ожидаемая задержка

Ожидается, что события обновления Enterprise будут отправляться немедленно.

События локального устройства, происходящие в быстрой последовательности, объединяются в пакеты и передаются в виде одного сообщения Pub/Sub в EMM.

Тип события Ожидаемая задержка между событием на устройстве и соответствующим уведомлением EMM 1
Высокоприоритетные ключевые состояния приложений Немедленно, максимум один отчет в минуту
Стандартные приоритетные состояния приложений В течение одной минуты
События, связанные с приложениями во время подготовки, для приложений с состояниями установки, определенными ИТ-администратором 2 В течение одной минуты после других связанных событий подготовки
События, связанные с приложениями, после подготовки, для приложений с состояниями установки, определенными ИТ-администратором. В течение 5 минут
События, связанные с приложениями, как во время, так и после предоставления, для приложений с состояниями установки, определенными сотрудником 3 В течение 60 минут
Другие события приложения на устройстве В течение 60 минут

  1. Цели наилучшего результата основаны на контролируемых обстоятельствах. Фактическая задержка может варьироваться в зависимости от различных устройств и факторов окружающей среды. ↩

  2. InstallType приложений, применяемых в политике: FORCE_INSTALLED , BLOCKED , REQUIRED_FOR_SETUP , PREINSTALLED и KIOSK . ↩

  3. InstallType доступных приложений: AVAILABLE , INSTALL_TYPE_UNSPECIFIED . ↩