Enterprises: pullNotificationSet

Es ruft eine Benachrichtigungsgruppe für die Unternehmen ab, die mit dem für die Anfrage authentifizierten Dienstkonto verknüpft sind, und gibt sie zurück. Der Benachrichtigungssatz kann leer sein, wenn keine Benachrichtigung ausstehend ist.
Ein zurückgegebener Benachrichtigungssatz muss innerhalb von 20 Sekunden durch Aufrufen von Enterprises.AcknowledgeNotificationSet bestätigt werden, sofern der Benachrichtigungssatz nicht leer ist.
Benachrichtigungen, die nicht innerhalb von 20 Sekunden bestätigt werden, werden schließlich noch einmal in die Antwort auf eine andere PullNotificationSet-Anfrage aufgenommen und solche, die nie bestätigt werden, letztendlich gemäß der Pub/Sub-Systemrichtlinie der Google Cloud Platform gelöscht.
Es können mehrere Anfragen gleichzeitig ausgeführt werden, um Benachrichtigungen abzurufen. In diesem Fall werden die ausstehenden Benachrichtigungen (falls vorhanden) auf jeden Aufrufer aufgeteilt, falls noch offen ist.
Wenn keine Benachrichtigungen vorhanden sind, wird eine leere Benachrichtigungsliste zurückgegeben. Für nachfolgende Anfragen werden möglicherweise mehr Benachrichtigungen zurückgegeben, sobald sie verfügbar sind.

Anfragen

HTTP-Anfrage

POST https://www.googleapis.com/androidenterprise/v1/enterprises/pullNotificationSet

Parameter

Parametername Wert Beschreibung
Optionale Suchparameter
requestMode string Der Anfragemodus zum Abrufen von Benachrichtigungen.
Wenn Sie waitForNotifications angeben, wird die Anfrage blockiert und wartet, bis eine oder mehrere Benachrichtigungen vorhanden sind. Wenn keine Benachrichtigungen vorhanden sind, wird eine leere Benachrichtigungsliste zurückgegeben.
Wenn Sie returnImmediately angeben, werden bei der Anfrage sofort die ausstehenden Benachrichtigungen oder eine leere Liste zurückgegeben, wenn keine Benachrichtigungen vorhanden sind.
Wenn keine Angabe gemacht wird, ist der Standardwert waitForNotifications.

Folgende Werte sind zulässig:
  • returnImmediately
  • waitForNotifications

Autorisierung

Für diese Anfrage ist eine Autorisierung in folgendem Umfang erforderlich:

Umfang
https://www.googleapis.com/auth/androidenterprise

Weitere Informationen finden Sie auf der Seite Authentifizierung und Autorisierung.

Anfragetext

Mit dieser Methode keinen Anfragetext bereitstellen.

Antwort

Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:

{
  "kind": "androidenterprise#notificationSet",
  "notificationSetId": string,
  "notification": [
    {
      "enterpriseId": string,
      "timestampMillis": long,
      "notificationType": string,
      "productApprovalEvent": {
        "productId": string,
        "approved": string
      },
      "installFailureEvent": {
        "productId": string,
        "deviceId": string,
        "userId": string,
        "failureReason": string,
        "failureDetails": string
      },
      "appUpdateEvent": {
        "productId": string
      },
      "newPermissionsEvent": {
        "productId": string,
        "requestedPermissions": [
          string
        ],
        "approvedPermissions": [
          string
        ]
      },
      "appRestrictionsSchemaChangeEvent": {
        "productId": string
      },
      "productAvailabilityChangeEvent": {
        "productId": string,
        "availabilityStatus": string
      },
      "newDeviceEvent": {
        "userId": string,
        "deviceId": string,
        "managementType": string,
        "dpcPackageName": string
      },
      "deviceReportUpdateEvent": {
        "userId": string,
        "deviceId": string,
        "report": {
          "lastUpdatedTimestampMillis": long,
          "appState": [
            {
              "packageName": string,
              "keyedAppState": [
                {
                  "key": string,
                  "stateTimestampMillis": long,
                  "severity": string,
                  "message": string,
                  "data": string
                }
              ]
            }
          ]
        }
      }
    }
  ]
}
Name der Eigenschaft Wert Beschreibung Hinweise
notificationSetId string Die ID des Benachrichtigungssatzes, die erforderlich ist, um die Benachrichtigung mit der Enterprises.AcknowledgeNotification API als empfangen zu markieren. Das wird weggelassen, wenn keine Benachrichtigungen vorhanden sind.
notification[] list Die empfangenen Benachrichtigungen oder leer, wenn keine Benachrichtigungen vorhanden sind.
notification[].enterpriseId string Die ID des Unternehmens, für das die Benachrichtigung gesendet wird. Dies ist immer vorhanden.
notification[].timestampMillis long Der Zeitpunkt, an dem die Benachrichtigung in Millisekunden seit dem 01.01.1970 veröffentlicht wurde. Dies ist immer vorhanden.
notification[].productApprovalEvent nested object Benachrichtigungen über Änderungen am Genehmigungsstatus eines Produkts.
notification[].productApprovalEvent.productId string Die ID des Produkts, für das sich der Genehmigungsstatus geändert hat, z.B. „app:com.google.android.gm“. Dieses Feld ist immer vorhanden.
notification[].productApprovalEvent.approved string Gibt an, ob das Produkt genehmigt oder nicht genehmigt wurde. Dieses Feld ist immer vorhanden.

Folgende Werte sind zulässig:
  • approved
  • unapproved
  • unknown
notification[].installFailureEvent nested object Benachrichtigungen über einen App-Installationsfehler.
notification[].installFailureEvent.productId string Die ID des Produkts, für das das Ereignis „Fehler bei der Installation“ aufgetreten ist, z.B. „app:com.google.android.gm“. Dieses Feld ist immer vorhanden.
notification[].installFailureEvent.deviceId string Die Android-ID des Geräts. Dieses Feld ist immer vorhanden.
notification[].installFailureEvent.userId string Die ID des Nutzers. Dieses Feld ist immer vorhanden.
notification[].installFailureEvent.failureReason string Der Grund für den Installationsfehler. Dieses Feld ist immer vorhanden.

Folgende Werte sind zulässig:
  • timeout
  • unknown
notification[].installFailureEvent.failureDetails string Zusätzliche Details zum Fehler, falls zutreffend.
notification[].appUpdateEvent nested object Benachrichtigungen zu App-Updates.
notification[].appUpdateEvent.productId string Die ID des aktualisierten Produkts (z.B. „app:com.google.android.gm“). Dieses Feld ist immer vorhanden.
notification[].newPermissionsEvent nested object Benachrichtigungen über neue App-Berechtigungen.
notification[].newPermissionsEvent.productId string Die ID des Produkts (z.B. „app:com.google.android.gm“), für das neue Berechtigungen hinzugefügt wurden. Dieses Feld ist immer vorhanden.
notification[].newPermissionsEvent.requestedPermissions[] list Die Berechtigungen, die derzeit von der App angefordert werden. Mit „Permissions.Get“ können Sie Details zu diesen Berechtigungen abrufen.
notification[].newPermissionsEvent.approvedPermissions[] list Die Berechtigungen, die der Unternehmensadministrator bereits für diese Anwendung genehmigt hat. Mit „Permissions.Get“ können Sie Details zu diesen Berechtigungen abrufen.
notification[].appRestrictionsSchemaChangeEvent nested object Benachrichtigungen über Änderungen des neuen App-Einschränkungsschemas.
notification[].appRestrictionsSchemaChangeEvent.productId string Die ID des Produkts, für das sich das App-Einschränkungsschema geändert hat (z.B. „app:com.google.android.gm“). Dieses Feld ist immer vorhanden.
notification[].productAvailabilityChangeEvent nested object Benachrichtigungen über Änderungen der Produktverfügbarkeit.
notification[].productAvailabilityChangeEvent.productId string Die ID des Produkts, für das sich die Produktverfügbarkeit geändert hat (z.B. „app:com.google.android.gm“). Dieses Feld ist immer vorhanden.
notification[].productAvailabilityChangeEvent.availabilityStatus string Der neue Status des Produkts. Dieses Feld ist immer vorhanden.

Folgende Werte sind zulässig:
  • available
  • removed
  • unknown
  • unpublished
notification[].newDeviceEvent nested object Benachrichtigungen zu neuen Geräten.
notification[].newDeviceEvent.userId string Die ID des Nutzers. Dieses Feld ist immer vorhanden.
notification[].newDeviceEvent.deviceId string Die Android-ID des Geräts. Dieses Feld ist immer vorhanden.
notification[].newDeviceEvent.managementType string Gibt das Ausmaß an, in dem das Gerät von einem Android-EMM-System in verschiedenen Bereitstellungskonfigurationen gesteuert wird.

Mögliche Werte sind:
  • managedDevice“, ein Gerät, auf dem der DPC als Geräteinhaber festgelegt ist,
  • managedProfile“, ein Gerät, auf dem der DPC als Profilinhaber festgelegt ist.


Zulässige Werte:
  • managedDevice
  • managedProfile
notification[].notificationType string Art der Benachrichtigung.

Folgende Werte sind zulässig:
  • appRestricionsSchemaChange
  • appUpdate
  • deviceReportUpdate
  • installFailure
  • newDevice
  • newPermissions
  • productApproval
  • productAvailabilityChange
  • testNotification
  • unknown
notification[].newDeviceEvent.dpcPackageName string Richtlinien-App auf dem Gerät.
notification[].deviceReportUpdateEvent nested object Benachrichtigungen zu Gerätebericht-Updates.
notification[].deviceReportUpdateEvent.userId string Die ID des Nutzers. Dieses Feld ist immer vorhanden.
notification[].deviceReportUpdateEvent.deviceId string Die Android-ID des Geräts. Dieses Feld ist immer vorhanden.
notification[].deviceReportUpdateEvent.report nested object Der Gerätebericht wurde mit den neuesten App-Status aktualisiert. Dieses Feld ist immer vorhanden.
notification[].deviceReportUpdateEvent.report.lastUpdatedTimestampMillis long Der Zeitstempel der letzten Aktualisierung des Berichts in Millisekunden seit Epochzeit. Dieses Feld ist immer vorhanden.
notification[].deviceReportUpdateEvent.report.appState[] list Liste der App-Status, die von verwalteten Apps auf dem Gerät festgelegt werden. App-Status werden von den Entwicklern der App definiert. Dieses Feld ist immer vorhanden.
notification[].deviceReportUpdateEvent.report.appState[].packageName string Der Paketname der App. Dieses Feld ist immer vorhanden.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[] list Liste der Schlüsselzustände der App. Dieses Feld ist immer vorhanden.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].key string Schlüssel, der angibt, wofür die App einen Status bereitstellt. Der Inhalt des Schlüssels wird vom Entwickler der App festgelegt. Um XSS zu verhindern, sollten Sie HTML-Code aus dem Schlüssel entfernen, bevor Sie ihn anzeigen. Dieses Feld ist immer vorhanden.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].stateTimestampMillis long Zeitstempel, der angibt, wann die Anwendung den Status in Millisekunden seit Epoche festgelegt hat. Dieses Feld ist immer vorhanden.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].severity string Schweregrad des Anwendungsstatus. Dieses Feld ist immer vorhanden.

Folgende Werte sind zulässig:
  • severityError
  • severityInfo
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].message string Kostenlos lesbare Nachricht im freien Format, die den App-Status beschreibt. Beispiel: eine Fehlermeldung. Um XSS zu verhindern, sollten Sie HTML-Code aus der Nachricht entfernen, bevor Sie sie anzeigen.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].data string Zusätzliches Feld für maschinenlesbare Daten. Beispiel: eine Zahl oder ein JSON-Objekt. Um XSS zu verhindern, sollten Sie HTML-Code aus den Daten entfernen, bevor Sie sie anzeigen.
kind string