Konfigurowanie powiadomień EMM

Google Play generuje powiadomienia, zwane powiadomieniami EMM, w odpowiedzi na różne zdarzenia wpływające na organizację. Gdy na przykład aplikacja zostanie zatwierdzona, system wysyła powiadomienie ProductApprovalEvent.

Powiadomienia EMM są powiązane z konkretnym kontem usługi dla firm (ESA). Jako dostawca usług EMM możesz skonfigurować konsolę, aby wyświetlała alerty lub wiadomości administratorom IT w firmie na podstawie otrzymanych powiadomień.

Powiadomienia EMM są wysyłane za pomocą usługi Google Cloud Pub/Sub. Szczegółowe informacje o konfigurowaniu powiadomień Pub/Sub znajdziesz w artykule Omówienie subskrypcji i w przewodniku po subskrypcji pull.

Aby sprawdzić, czy system jest prawidłowo skonfigurowany do odbierania powiadomień EMM z Google Play, i aby pobrać nazwę tematu Cloud Pub/Sub, z którym musisz połączyć subskrypcję, zadzwoń pod numer Enterprises.sendTestPushNotification.

Wysłanie powiadomienia testowego pozwala sprawdzić integrację EMM z usługą Google Cloud Pub/Sub dla firm. Jeśli powiadomienia EMM są prawidłowo skonfigurowane, interfejs API zwraca te informacje:

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

Powiadomienia typu „pull”

Google Cloud Pub/Sub obsługuje 2 różne mechanizmy powiadomień: pull i push. Zalecamy jednak tylko powiadomienia typu „pull”. Metoda pull nie wymaga konfiguracji zewnętrznego serwera i działa zarówno w przypadku automatycznego, jak i ręcznego tworzenia ESA. Kolejną zaletą powiadomień typu „pull” jest to, że nie wymagają one od klientów dodatkowej konfiguracji ani konserwacji. Aby odbierać i potwierdzać powiadomienia EMM przez długotrwałe połączenia wychodzące, użyj: Enterprises.pullNotificationSet i Enterprises.acknowledgeNotificationSet.

Gdy wywołujesz funkcję Enterprises.pullNotificationSet, zalecamy pozostawienie parametru requestMode w swojej domyślnej wartości (waitForNotifications). W takim przypadku żądanie będzie czekać, aż pojawi się co najmniej jedno powiadomienie, zanim zwróci odpowiedź. Jeśli po pewnym czasie nie ma żadnych powiadomień, żądanie zwróci pustą listę powiadomień, po czym możesz ponownie przesłać żądanie.

Gdy otrzymasz powiadomienia, zadzwoń pod numer Enterprises.acknowledgeNotificationSet, aby mieć pewność, że te same powiadomienia nie zostaną zwrócone podczas następnego połączenia z numerem Enterprises.pullNotificationSet.

Możesz też ustawić wartość requestMode na returnImmediately podczas wywoływania funkcji Enterprises.pullNotificationSet. Otrzymasz odpowiedź na prośbę od razu, zawierającą wszystkie oczekujące powiadomienia lub pustą listę, jeśli nie ma żadnych powiadomień. Opcja requestMode może być przydatna podczas początkowego testowania implementacji powiadomień.

Przykłady powiadomień EMM

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

Uwaga: wycofane zostały następujące typy powiadomień: ProductApprovalEvent, AppUpdateEvent, NewPermissionsEvent, AppRestrictionsSchemaChangeEvent, ProductAvailabilityChangeEvent i NewDeviceEvent. W przypadku AppUpdateEvent musisz używać trybu aktualizacji o wysokim priorytecie zgodnie z naszymi zaleceniami.

OpisPowiadomienie
Testowe powiadomienie jest żądane za pomocą interfejsu Google Play EMM API. Musisz wysłać testowe powiadomienie, aby potwierdzić, że Twój system może odbierać powiadomienia publikowane przez Google Play, oraz poznać nazwę tematu używaną we wszystkich powiadomieniach powiązanych z Google Play. TestPushNotification
Nowo przygotowane urządzenie jest gotowe do zarządzania za pomocą interfejsu EMM Google Play API. Możesz teraz wywoływać interfejsy API, które wymagają deviceId urządzenia (na przykład Installs), oraz interfejsy API, które zwracają zasób Devices. To powiadomienie jest wysyłane tylko po utworzeniu pierwszego konta na urządzeniu zarządzanym. WYCOFANE NewDeviceEvent
Administrator zaznacza aplikację jako zatwierdzoną lub niezatwierdzona w konsoli zarządzanego Sklepu Google Play. WYCOFANE ProductApprovalEvent
Oczekująca instalacja na urządzeniu osiąga limit czasu. Na przykład prośba o instalację została zaakceptowana, ale przez kilka dni nie można było uzyskać dostępu do urządzenia, więc nie można było potwierdzić instalacji. System wysyła powiadomienie o przekroczeniu limitu czasu instalacji.InstallFailureEvent
opublikowano nową wersję aplikacji; Aktualizacja jest dostępna na co najmniej 1 urządzeniu, ale niekoniecznie na wszystkich. WYCOFANE AppUpdateEvent
Aktualizacja aplikacji wymaga zatwierdzenia nowego uprawnienia przez administratora, aby można było przeprowadzić aktualizację lub nową instalację. To powiadomienie jest wysyłane, gdy zestaw akceptowanych uprawnień aplikacji różni się od zestawu żądanych uprawnień aplikacji. WYCOFANE NewPermissionsEvent
opublikowano nową wersję aplikacji zawierającą nowy lub zmodyfikowany schemat konfiguracji zarządzanej; 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 wysyła powiadomienie do firm, które zatwierdziły aplikację. WYDAJĄCY SIĘ AppRestrictionsSchemaChangeEvent
dostępna aplikacja staje się niedostępna lub niedostępna aplikacja jest ponownie dodawana do Google Play; Dostępność aplikacji zmienia się, jeśli deweloper cofnie jej publikację lub usunie ją z Google Play. Dostępność zmienia się również, gdy niedostępna aplikacja zostanie ponownie dodana do Google Play. WYCOFANE ProductAvailabilityChangeEvent
Powiadomienie dotyczące przekształcania konta Enterprise. Uaktualnienie grupy kont zarządzanego Sklepu Google Play to proces, w którym grupa kont zarządzanego Sklepu Google Play zostaje przekształcona w zarządzaną domenę Google. EnterpriseUpgradeEvent