Pub/Sub-Benachrichtigungen einrichten

Mit Pub/Sub-Benachrichtigungen können Sie Benachrichtigungen zu neu registrierten Geräten, Geräteberichten und kürzlich erteilten Befehlen erhalten.

Wenn Sie Pub/Sub-Benachrichtigungen einrichten möchten, müssen Sie die Pub/Sub API aktivieren und ein Thema erstellen. Wenn Sie Nachrichten zu einem Thema erhalten möchten, müssen Sie ein Abo für dieses Thema erstellen. Durch das Abo wird das Thema mit einer Abonnentenanwendung verbunden, die Nachrichten empfängt und verarbeitet, die für das Thema veröffentlicht wurden. Nachdem Sie ein Abo erstellt haben, müssen Sie der Android Device Policy die Berechtigung erteilen, in Ihrem Thema zu veröffentlichen.

1. Pub/Sub API für Ihr Projekt aktivieren

Eine Anleitung zum Aktivieren der Pub/Sub API finden Sie in der Console-Kurzanleitung. Achten Sie darauf, dass Sie dasselbe Projekt auswählen, für das die Android Management API aktiviert ist.

2. Thema erstellen

Nachdem Sie die API aktiviert haben, müssen Sie ein Thema erstellen, über das Android Device Policy Benachrichtigungen veröffentlichen kann. Es gibt zwei Möglichkeiten, ein Thema zu erstellen:

a. Manuell in der Google Cloud Console.
b. Über die Pub/Sub API (siehe Methode „create topic“)

Notieren Sie sich den Namen des Themas, nachdem Sie es erstellt haben.

3. Abo erstellen

Mit einem Abo werden alle eingehenden Nachrichten zu einem bestimmten Thema erfasst. Es gibt zwei Möglichkeiten, ein Abo zu erstellen:

a. Manuell in der Google Cloud Console.
b. Über die Pub/Sub API (siehe Methode „create subscription“)

4. Android Device Policy das Recht gewähren, in Ihrem Thema zu veröffentlichen

Sie müssen android-cloud-policy@system.gserviceaccount.com die Berechtigung erteilen, in Ihrem Thema zu veröffentlichen. Es gibt zwei Möglichkeiten, Verlagsrechte zu gewähren:

a. Manuell in der Google Cloud Console

  • Fügen Sie android-cloud-policy@system.gserviceaccount.com als Mitglied zu Ihrem Thema hinzu.
  • Klicken Sie auf Rolle auswählen > Pub/Sub > Pub/Sub-Publisher.

b. Über die Pub/Sub API (siehe Zugriff über die IAM API steuern)

  • Fügen Sie serviceAccount:android-cloud-policy@system.gserviceaccount.com zu members hinzu.
  • Setzen Sie role auf roles/pubsub.publisher.

5. Enterprise-Version aktualisieren, um Benachrichtigungen zu unterstützen

Überspringen Sie diesen Schritt, wenn Sie ENTERPRISE_UPGRADE unterstützen möchten, da diese Benachrichtigung immer unterstützt wird.

Wenn Sie Benachrichtigungen zu einem Unternehmen mit dem von Ihnen erstellten Thema verknüpfen möchten, rufen Sie enterprises.patch auf und geben Sie die folgenden Parameter an:

  • pubsubTopic: Der Name Ihres Pub/Sub-Themas im Format projects/{project}/topics/{topic}.
  • enabledNotificationTypes: Fügen Sie alle Benachrichtigungstypen hinzu, die Sie erhalten möchten. Wählen Sie ENROLLMENT, STATUS_REPORT oder COMMAND aus.

6. Pub/Sub API zum Abrufen von Benachrichtigungen verwenden

Für die Nachrichtenzustellung durch ein Abo kann entweder der Push- oder der Pull-Mechanismus verwendet werden. Richtlinien und Anleitungen zum Empfangen von Benachrichtigungen über beide Mechanismen finden Sie im Pub/Sub-Abonnentenhandbuch.

Nachrichtenformat

Nachrichten haben die Form einer PubsubMessage. Das Feld attributes der Nachricht enthält ein Attribut mit dem Schlüssel notificationType und dem Wert, der dem Benachrichtigungstyp entspricht, der die Nachricht ausgelöst hat (z.B. ENROLLMENT). Das Feld data der Nachricht enthält die JSON-Darstellung der aktualisierten Ressource, codiert als UTF-8-String. Die Benachrichtigungen und die zugehörigen Ressourcentypen sind:

  • Für COMMAND-Benachrichtigungen wird der Ressourcentyp Operation verwendet.
  • Für USAGE_LOGS-Benachrichtigungen wird der Ressourcentyp UsageLogEvent verwendet.
  • Für ENROLLMENT- und STATUS_REPORT-Benachrichtigungen wird der Ressourcentyp Device verwendet.
  • Für ENTERPRISE_UPGRADE-Benachrichtigungen wird der Ressourcentyp EnterpriseUpgradeEvent verwendet.

Wenn Sie die pubsubTopic für ein Unternehmen festlegen, wird eine erste Nachricht veröffentlicht, in der notificationType auf test gesetzt ist. Diese Meldung wird gesendet, um zu prüfen, ob Android Device Policy die Veröffentlichungsberechtigung für das Thema hat. Sie kann ignoriert werden.

Erwartete Latenz

Ereignisse zu Enterprise-Upgrades werden voraussichtlich sofort gesendet.

Lokale Geräteereignisse, die in schneller Folge auftreten, werden in einem Batch zusammengefasst und in einer einzelnen Pub/Sub-Nachricht an EMMs gesendet.

Ereignistyp Erwartete Latenz zwischen On-Device-Ereignis und entsprechender EMM-Benachrichtigung1
Schlüsselstatus der App mit hoher Priorität Sofort, maximal ein Bericht pro Minute
App-Status mit Schlüsseln mit Standardpriorität Innerhalb einer Minute
Anwendungsbezogene Ereignisse während der Bereitstellung für Apps mit vom IT-Administrator definierten Installationsstatus2 Innerhalb einer Minute zusätzlich zu anderen zugehörigen Bereitstellungsereignissen
Anwendungsbezogene Ereignisse nach der Bereitstellung für Apps mit vom IT-Administrator definierten Installationsstatus Innerhalb von 5 Minuten
Anwendungsbezogene Ereignisse während und nach der Bereitstellung für Apps mit vom Mitarbeiter definierten Installationsstatus3 Innerhalb von 60 Minuten
Andere App-Ereignisse auf dem Gerät Innerhalb von 60 Minuten

  1. Best-Effort-Zielvorhaben, die auf kontrollierten Bedingungen basieren. Die tatsächliche Latenz kann je nach Gerät und Umgebung variieren. ↩

  2. InstallType der in der Richtlinie erzwungenen Apps: FORCE_INSTALLED, BLOCKED, REQUIRED_FOR_SETUP, PREINSTALLED und KIOSK. ↩

  3. InstallType der verfügbaren Apps: AVAILABLE, INSTALL_TYPE_UNSPECIFIED. ↩