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 |