Konfigurowanie powiadomień EMM

Google Play generuje powiadomienia (nazywane powiadomieniami EMM) w odpowiedzi na różne zdarzenia, które mają wpływ na firmę. Jeśli na przykład aplikacja zostanie zatwierdzona, system wyśle powiadomienie ProductApprovalEvent.

Powiadomienia usług EMM są powiązane z określonym kontem usługi firmowej (ESA). Jako dostawca usług EMM możesz skonfigurować w konsoli wyświetlanie alertów lub komunikatów dla firmowych administratorów IT na podstawie otrzymywanych powiadomień.

Powiadomienia EMM są wysyłane przez Google Cloud Pub/Sub. Szczegółowe informacje o konfigurowaniu powiadomień Pub/Sub znajdziesz w artykułach Przegląd subskrybentów i Przewodnik dla subskrybentów z serii Pull.

Aby potwierdzić, że system został skonfigurowany pod kątem odbierania powiadomień EMM z Google Play i pobierania nazwy tematu Cloud Pub/Sub, z którym chcesz połączyć subskrypcję, zadzwoń pod numer Enterprises.sendTestPushNotification.

Wysłanie powiadomienia testowego pozwala potwierdzić integrację usług EMM z usługą Google Cloud Pub/Sub w firmie. Jeśli powiadomienia EMM są prawidłowo skonfigurowane, interfejs API zwraca to:

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

Pobierz powiadomienia

Google Cloud Pub/Sub obsługuje 2 różne mechanizmy powiadomień: pull i push. Zalecamy jednak używanie tylko powiadomień pull. Metoda „pull” nie wymaga konfigurowania zewnętrznego serwera i działa zarówno z programowo, jak i ręcznie utworzonymi ESA. Inną zaletą powiadomień pull jest to, że nie wymagają one od klientów dodatkowej konfiguracji ani konserwacji w ograniczonym zakresie lub w ogóle nie wymagają od klientów żadnej dodatkowej konfiguracji. Możesz też używać Enterprises.pullNotificationSet i Enterprises.acknowledgeNotificationSet do odbierania i potwierdzania powiadomień EMM w przypadku długotrwałych połączeń wychodzących.

Podczas wywoływania Enterprises.pullNotificationSet zalecamy pozostawienie parametru requestMode do wartości domyślnej (waitForNotifications). Dzięki temu żądanie będzie czekać, aż pojawi się co najmniej jedno powiadomienie, zanim zwróci odpowiedź. Jeśli po pewnym czasie nie pojawi się żadne powiadomienia, żądanie zwróci pustą listę powiadomień. Potem możesz spróbować ponownie.

Po otrzymaniu powiadomień wywołaj funkcję Enterprises.acknowledgeNotificationSet, aby mieć pewność, że te same powiadomienia nie zostaną zwrócone przy następnym wywołaniu Enterprises.pullNotificationSet.

Możesz też ustawić requestMode na returnImmediately podczas wywoływania funkcji Enterprises.pullNotificationSet. Odpowiedź na tę prośbę otrzymasz od razu. Będzie ona zawierać wszelkie oczekujące powiadomienia lub pustą listę, jeśli nie ma żadnych powiadomień. Ta opcja requestMode może być przydatna podczas wstępnego testowania implementacji powiadomień.

Przykłady powiadomień EMM

Oto kilka przykładów zdarzeń i typów powiadomień, które generują:

Uwaga: wycofaliśmy te typy powiadomień: ProductApprovalEvent, AppUpdateEvent, NewPermissionsEvent, AppRestrictionsSchemaChangeEvent, ProductAvailabilityChangeEvent i NewDeviceEvent. Zgodnie z naszymi zaleceniami w przypadku AppUpdateEvent musisz używać trybu aktualizacji o wysokim priorytecie .

OpisPowiadomienie
Powiadomienie testowe jest wysyłane przez interfejs Google Play EMM API. Musisz wysłać powiadomienie testowe, aby potwierdzić, że Twój system może otrzymywać powiadomienia publikowane przez Google Play oraz poznać nazwę tematu używaną we wszystkich powiadomieniach związanych z Google Play. TestPushNotification
Nowo zarejestrowane urządzenie jest gotowe do zarządzania za pomocą interfejsu Google Play EMM API. Możesz teraz wywoływać interfejsy API, które wymagają deviceId urządzenia (np. Instalacje) i interfejsy API, które zwracają zasób Urządzenia. To powiadomienie jest wysyłane dopiero po skonfigurowaniu pierwszego konta na urządzeniu zarządzanym. WYCOFANE NewDeviceEvent
Administrator oznacza aplikację w konsoli Google Play jako zatwierdzona lub niezatwierdzoną. WYCOFANE ProductApprovalEvent
Upłynął limit czasu oczekiwania na instalację na urządzeniu. Na przykład żądanie instalacji w trybie push jest akceptowane, ale urządzenie jest niedostępne przez kilka dni, więc nie można potwierdzić instalacji. System wysyła powiadomienie o przekroczeniu limitu czasu instalacji.InstallFailureEvent
zostanie opublikowana nowa wersja aplikacji, Aktualizacja jest dostępna na jednym lub kilku urządzeniach, ale niekoniecznie na wszystkich. WYCOFANE AppUpdateEvent
Aktualizacja aplikacji wymaga zatwierdzenia nowych uprawnień przez administratora do przeprowadzenia aktualizacji lub kolejnej instalacji. To powiadomienie jest wysyłane, gdy zestaw zaakceptowanych uprawnień aplikacji różni się od zestawu wymaganych uprawnień aplikacji. WYCOFANE NewPermissionsEvent
Zostanie opublikowana nowa wersja aplikacji zawierająca nowy lub zmodyfikowany schemat konfiguracji zarządzanych. Gdy deweloper przesyła nowy plik APK, Google Play porównuje schemat w pliku manifestu ze schematem w poprzedniej wersji aplikacji. Jeśli schemat się zmieni, Google Play powiadamia przedsiębiorstwa, które zatwierdziły aplikację. WYCOFANE AppRestrictionsSchemaChangeEvent
Dostępna aplikacja staje się niedostępna lub niedostępna w Google Play. Dostępność aplikacji zmieni się, gdy deweloper cofnie jej publikację lub zostanie ona usunięta z Google Play. Dostępność aplikacji zmienia się też w przypadku ponownego dodania niedostępnej aplikacji do Google Play. WYCOFANE ProductAvailabilityChangeEvent