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:
|
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:
|
|
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:
|
|
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:
|
|
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:
Zulässige Werte:
|
|
notification[].notificationType |
string |
Art der Benachrichtigung.
Folgende Werte sind zulässig:
|
|
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:
|
|
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 |