Настроить уведомления EMM,Настроить уведомления EMM

Google Play генерирует уведомления, называемые уведомлениями EMM , в ответ на различные события, влияющие на предприятие. Например, когда приложение одобрено, система отправляет уведомление ProductApprovalEvent .

Уведомления EMM связаны с определенной учетной записью службы предприятия (ESA) . Как EMM, вы можете настроить свою консоль для отображения предупреждений или сообщений ИТ-администраторам предприятия на основе полученных вами уведомлений.

Уведомления EMM отправляются с помощью Google Cloud Pub/Sub . Подробную информацию о настройке уведомлений Pub/Sub см. в «Обзоре подписчика» и «Руководстве для подписчиков по запросу» .

Чтобы подтвердить, что вы успешно настроили свою систему для получения уведомлений EMM от Google Play и для получения названия темы Cloud Pub/Sub, к которой вам необходимо подключить подписку, вызовите Enterprises.sendTestPushNotification .

Отправка тестового уведомления подтверждает интеграцию EMM со службой Google Cloud Pub/Sub для предприятия. Если уведомления EMM настроены правильно, API возвращает следующее:

    {
        topic_name: "/projects/project-name/topics/play-work-012345",
        message_id: "128976912439"
    }

Получение уведомлений

Google Cloud Pub/Sub поддерживает два разных механизма уведомлений: pull и push. Однако рекомендуется использовать только уведомления по запросу. Метод извлечения не требует настройки внешнего сервера и работает как с ESA, созданными программно, так и вручную. Еще одним преимуществом уведомлений по запросу является то, что они практически не требуют дополнительной настройки или обслуживания со стороны ваших клиентов. используйте Enterprises.pullNotificationSet и Enterprises.acknowledgeNotificationSet для получения и подтверждения уведомлений EMM через длительные исходящие соединения.

При вызове Enterprises.pullNotificationSet мы рекомендуем оставить requestMode значение по умолчанию ( waitForNotifications ). Это заставляет запрос ждать, пока не появится одно или несколько уведомлений, прежде чем возвращать ответ. Если через некоторое время уведомлений не будет, запрос вернет пустой список уведомлений, после чего вы сможете повторить запрос.

После получения уведомлений вызовите Enterprises.acknowledgeNotificationSet чтобы гарантировать, что те же уведомления не будут возвращены при следующем вызове Enterprises.pullNotificationSet .

У вас также есть возможность установить requestMode значение returnImmediately при вызове Enterprises.pullNotificationSet . Вы немедленно получите ответ на запрос, содержащий все ожидающие уведомления или пустой список, если уведомлений нет. Этот параметр requestMode может быть полезен при первоначальном тестировании реализации уведомлений.

Примеры уведомлений EMM

Вот несколько примеров событий и типов уведомлений, которые они генерируют:

Примечание. Следующие типы уведомлений устарели: ProductApprovalEvent , AppUpdateEvent , NewPermissionsEvent , AppRestrictionsSchemaChangeEvent , ProductAvailabilityChangeEvent и NewDeviceEvent . Для AppUpdateEvent необходимо использовать режим обновления с высоким приоритетом в соответствии с нашими рекомендациями.

Описание Уведомление
Тестовое уведомление запрашивается через API EMM Google Play . Вам необходимо отправить тестовое уведомление, чтобы подтвердить, что ваша система может получать уведомления, публикуемые Google Play, и узнать название темы, используемой для всех уведомлений, связанных с Google Play. TestPushNotification
Недавно подготовленное устройство готово к управлению с помощью Google Play EMM API . Теперь вы можете вызывать API, которым требуется deviceId устройства (например, Installs ), и API, которые возвращают ресурс Devices . Это уведомление отправляется только после подготовки первой учетной записи на управляемом устройстве. УСТАРЕЛО NewDeviceEvent
Администратор помечает приложение как одобренное или неутвержденное в управляемой консоли Google Play. УСТАРЕЛО ProductApprovalEvent
Время ожидания установки на устройство истекло. Например, запрос на принудительную установку принимается, но устройство недоступно в течение нескольких дней, поэтому установку невозможно подтвердить. Система отправляет уведомление о тайм-ауте установки. InstallFailureEvent
Опубликована новая версия приложения. Обновление доступно для одного или нескольких, но не обязательно для всех устройств. УСТАРЕЛО AppUpdateEvent
Обновление приложения требует одобрения администратором нового разрешения, чтобы можно было выполнить обновление или новую установку. Это уведомление отправляется, когда принятый набор разрешений приложения отличается от запрошенного набора разрешений приложения. УСТАРЕЛО NewPermissionsEvent
Публикуется новая версия приложения, которая включает новую или измененную схему управляемых конфигураций . Когда разработчик загружает новый APK, Google Play сравнивает схему в манифесте со схемой в предыдущей версии приложения. Если схема изменилась, компания уведомляет об этом предприятия, утвердившие приложение. УСТАРЕЛО AppRestrictionsSchemaChangeEvent
Доступное приложение становится недоступным или недоступное приложение повторно добавляется в Google Play. Доступность приложения изменится, если разработчик отменяет его публикацию или удаляет его из Google Play. Доступность также изменится, если недоступное приложение будет повторно добавлено в Google Play. УСТАРЕЛО ProductAvailabilityChangeEvent