EMM-Benachrichtigungen einrichten

Google Play generiert als Reaktion auf verschiedene Ereignisse, die ein Unternehmen betreffen, Benachrichtigungen, sogenannte EMM-Benachrichtigungen. Wenn beispielsweise eine App genehmigt wird, sendet das System eine ProductApprovalEvent-Benachrichtigung.

EMM-Benachrichtigungen sind mit einem bestimmten Unternehmensdienstkonto (Enterprise Service Account, ESA) verknüpft. Als EMM können Sie Ihre Konsole so einrichten, dass IT-Administratoren von Unternehmen basierend auf den Benachrichtigungen, die Sie erhalten, Warnungen oder Nachrichten anzeigen.

EMM-Benachrichtigungen werden über Google Cloud Pub/Sub gesendet. Ausführliche Informationen zum Einrichten von Pub/Sub-Benachrichtigungen finden Sie in der Abonnentenübersicht und im Pull-Abonnentenleitfaden.

Rufen Sie Enterprises.sendTestPushNotification auf, um zu bestätigen, dass Ihr System erfolgreich so eingerichtet wurde, dass EMM-Benachrichtigungen von Google Play empfangen und der Name des Cloud Pub/Sub-Themas abgerufen wird, mit dem Sie Ihr Abo verbinden müssen.

Mit einer Testbenachrichtigung wird Ihre EMM-Integration mit dem Google Cloud Pub/Sub-Dienst für das Unternehmen validiert. Wenn EMM-Benachrichtigungen ordnungsgemäß konfiguriert sind, gibt die API Folgendes zurück:

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

Benachrichtigungen abrufen

Google Cloud Pub/Sub unterstützt zwei verschiedene Benachrichtigungsmechanismen: Pull und Push. Es werden jedoch nur Pull-Benachrichtigungen empfohlen. Der Pull-Ansatz erfordert keine externe Servereinrichtung und funktioniert sowohl mit programmatisch als auch manuell erstellten ESAs. Ein weiterer Vorteil von Pull-Benachrichtigungen besteht darin, dass sie nur wenig oder gar keine zusätzliche Konfiguration oder Wartung durch Ihre Kunden erfordern. Verwenden Sie Enterprises.pullNotificationSet und Enterprises.acknowledgeNotificationSet, um EMM-Benachrichtigungen über lang andauernde ausgehende Verbindungen zu empfangen und zu bestätigen.

Beim Aufrufen von Enterprises.pullNotificationSet empfehlen wir, für requestMode den Standardwert (waitForNotifications) beizubehalten. Dadurch wartet die Anfrage, bis eine oder mehrere Benachrichtigungen vorhanden sind, bevor eine Antwort zurückgegeben wird. Wenn nach einiger Zeit keine Benachrichtigungen vorhanden sind, gibt die Anfrage eine leere Benachrichtigungsliste zurück. Anschließend können Sie die Anfrage noch einmal senden.

Nachdem Sie Benachrichtigungen erhalten haben, rufen Sie Enterprises.acknowledgeNotificationSet auf, damit beim nächsten Aufruf von Enterprises.pullNotificationSet nicht dieselben Benachrichtigungen zurückgegeben werden.

Sie haben auch die Möglichkeit, requestMode auf returnImmediately zu setzen, wenn Sie Enterprises.pullNotificationSet aufrufen. Sie erhalten sofort eine Antwort auf die Anfrage, die alle ausstehenden Benachrichtigungen enthält, oder eine leere Liste, wenn keine Benachrichtigungen vorhanden sind. Diese requestMode-Option kann nützlich sein, wenn Sie die Implementierung Ihrer Benachrichtigungen zuerst testen.

Beispiele für EMM-Benachrichtigungen

Hier sind einige Beispiele für Ereignisse und die von ihnen generierten Benachrichtigungstypen:

Hinweis:Die folgenden Benachrichtigungstypen wurden eingestellt: ProductApprovalEvent, AppUpdateEvent, NewPermissionsEvent, AppRestrictionsSchemaChangeEvent, ProductAvailabilityChangeEvent und NewDeviceEvent. Für AppUpdateEvent müssen Sie gemäß unseren Empfehlungen den Updatemodus mit hoher Priorität verwenden.

BeschreibungMeldung
Eine Testbenachrichtigung wird über die Google Play EMM API angefordert. Du musst eine Testbenachrichtigung senden, um zu bestätigen, dass dein System die von Google Play veröffentlichten Benachrichtigungen empfangen kann, und um den Themennamen herauszufinden, der für alle mit Google Play verknüpften Benachrichtigungen verwendet wird. TestPushNotification
Ein neu bereitgestelltes Gerät kann jetzt durch die Google Play EMM API verwaltet werden. Sie können jetzt APIs aufrufen, für die die deviceId des Geräts (z. B. Installationen) erforderlich sind, sowie APIs, die eine Ressource vom Typ Geräte zurückgeben. Diese Benachrichtigung wird erst gesendet, nachdem das erste Konto auf einem verwalteten Gerät bereitgestellt wurde. EINGESTELLT NewDeviceEvent
Ein Administrator markiert eine App in der Managed Google Play Console als genehmigt oder nicht genehmigt. EINGESTELLT ProductApprovalEvent
Bei einer ausstehenden Installation auf einem Gerät tritt eine Zeitüberschreitung auf. Eine Push-Installationsanfrage wird beispielsweise akzeptiert, aber das Gerät ist mehrere Tage lang nicht erreichbar, sodass die Installation nicht bestätigt werden kann. Das System sendet eine Benachrichtigung über die Zeitüberschreitung bei der Installation.InstallFailureEvent
Eine neue Version einer App wird veröffentlicht. Das Update ist für ein oder mehrere, aber nicht unbedingt für alle Geräte verfügbar. EINGESTELLT AppUpdateEvent
Für ein App-Update muss eine neue Berechtigung vom Administrator genehmigt werden, damit ein Update oder eine Neuinstallation durchgeführt werden kann. Diese Benachrichtigung wird gesendet, wenn die von der App akzeptierten Berechtigungssätze von den angeforderten Berechtigungen der Anwendungen abweichen. EINGESTELLT NewPermissionsEvent
Es wird eine neue Version einer Anwendung veröffentlicht, die ein neues oder geändertes Schema für verwaltete Konfigurationen enthält. Wenn ein Entwickler ein neues APK hochlädt, vergleicht Google Play das Schema im Manifest mit dem Schema in der vorherigen Version der App. Falls sich das Schema geändert hat, werden Unternehmen benachrichtigt, die die App genehmigt haben. EINGESTELLT AppRestrictionsSchemaChangeEvent
Eine verfügbare App ist nicht mehr verfügbar oder eine nicht verfügbare App wird Google Play wieder hinzugefügt. Die Verfügbarkeit der App ändert sich, wenn ein Entwickler die Veröffentlichung aufhebt oder sie aus Google Play entfernt wird. Die Verfügbarkeit ändert sich auch, wenn eine nicht verfügbare App wieder zu Google Play hinzugefügt wird. EINGESTELLT ProductAvailabilityChangeEvent