Enterprises: pullNotificationSet

Ruft eine Benachrichtigung ab und gibt sie für die Unternehmen zurück, die mit Das Dienstkonto, das für die Anfrage authentifiziert ist. Die eingestellte Benachrichtigung kann leer sein, wenn keine Benachrichtigungen ausstehen.
Ein zurückgegebener Benachrichtigungssatz muss innerhalb von 20 Sekunden bestätigt werden indem Sie Enterprises.AcknowledgeNotificationSet aufrufen, es sei denn, Benachrichtigungsgruppe ist leer.
Benachrichtigungen, die nicht innerhalb von 20 Sekunden bestätigt werden, möglicherweise wieder in die Antwort auf ein anderes PullNotificationSet aufgenommen werden. und Anfragen, die nie bestätigt werden, werden letztlich gelöscht. gemäß der Pub/Sub-Systemrichtlinie der Google Cloud Platform.
Es können mehrere Anfragen gleichzeitig ausgeführt werden, Benachrichtigungen. In diesem Fall werden ausstehende Benachrichtigungen (falls vorhanden) zwischen den einzelnen Anrufern aufgeteilt, falls noch ausstehen.
Wenn keine Benachrichtigungen vorhanden sind, wird eine leere Benachrichtigungsliste zurückgegeben. Bei nachfolgenden Anfragen erhalten Sie möglicherweise weitere Benachrichtigungen, verfügbar.

Anfrage

HTTP-Anfrage

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

Parameter

Parametername Wert Beschreibung
Optionale Abfrageparameter
requestMode string Der Anfragemodus zum Abrufen von Benachrichtigungen.
Wenn Sie waitForNotifications angeben, wird die Anfrage blockieren und warten, bis eine oder mehrere Benachrichtigungen vorhanden sind, oder eine Benachrichtigungsliste leer, wenn nach einiger Zeit keine Benachrichtigungen vorhanden sind.
Durch die Angabe von returnImmediately wird die Anfrage an sofort zurückgegebene Benachrichtigungen oder eine leere Liste, wenn keine Benachrichtigungen vorhanden sind.
Wenn keine Angabe gemacht wird, wird standardmäßig waitForNotifications verwendet.

Zulässige Werte sind:
  • „returnImmediately“
  • „waitForNotifications“

Autorisierung

Für diese Anfrage ist eine Autorisierung mit dem folgenden 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 Benachrichtigungssets, die erforderlich ist, um die Benachrichtigung mit der Enterprises.AcknowledgeNotification API als empfangen zu kennzeichnen. Dies wird weggelassen, wenn keine Benachrichtigungen vorhanden sind.
notification[] list Die empfangenen Benachrichtigungen oder das Feld ist leer, wenn keine Benachrichtigungen vorhanden sind.
notification[].enterpriseId string Die ID des Unternehmens, für das die Benachrichtigung gesendet wird. Dieser Wert ist immer vorhanden.
notification[].timestampMillis long Zeitpunkt der Veröffentlichung der Benachrichtigung in Millisekunden seit 01.01.1970T00:00:00Z. Dieser Wert ist immer vorhanden.
notification[].productApprovalEvent nested object Benachrichtigungen über Änderungen am Genehmigungsstatus eines Produkts.
notification[].productApprovalEvent.productId string Die ID des Produkts (z.B. „app:com.google.android.gm“), dessen Freigabestatus sich geändert hat. Dieses Feld ist immer vorhanden.
notification[].productApprovalEvent.approved string Gibt an, ob das Produkt genehmigt oder nicht genehmigt wurde. Dieses Feld ist immer vorhanden.

Zulässige Werte sind:
  • „approved“
  • „unapproved“
  • „unknown“
notification[].installFailureEvent nested object Benachrichtigungen über einen Fehler bei der App-Installation.
notification[].installFailureEvent.productId string Die ID des Produkts (z.B. „app:com.google.android.gm“), bei dem die Installation fehlgeschlagen ist. 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.

Zulässige Werte sind:
  • „timeout“
  • „unknown“
notification[].installFailureEvent.failureDetails string Weitere 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 zu neuen 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 die App derzeit anfordert. Verwenden Sie Permissions.Get in der EMM API, um Details zu diesen Berechtigungen abzurufen.
notification[].newPermissionsEvent.approvedPermissions[] list Die Berechtigungen, die der Unternehmensadministrator bereits für diese Anwendung genehmigt hat. Verwenden Sie „Berechtigungen“. Rufen Sie die EMM API auf, um Details zu diesen Berechtigungen abzurufen.
notification[].appRestrictionsSchemaChangeEvent nested object Benachrichtigungen zu neuen Änderungen des Schemas für App-Einschränkungen.
notification[].appRestrictionsSchemaChangeEvent.productId string Die ID des Produkts (z.B. „app:com.google.android.gm“), für das das App-Einschränkungsschema geändert wurde. Dieses Feld ist immer vorhanden.
notification[].productAvailabilityChangeEvent nested object Benachrichtigungen zu Änderungen der Produktverfügbarkeit
notification[].productAvailabilityChangeEvent.productId string Die ID des Produkts (z.B. „app:com.google.android.gm“), für das sich die Produktverfügbarkeit geändert hat. Dieses Feld ist immer vorhanden.
notification[].productAvailabilityChangeEvent.availabilityStatus string Der neue Status des Produkts. Dieses Feld ist immer vorhanden.

Zulässige Werte sind:
  • „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 an, in welchem Umfang das Gerät von einem Android-EMM in verschiedenen Bereitstellungskonfigurationen gesteuert wird.

Mögliche Werte:
  • „managedDevice“, ein Gerät, auf dem der DPC als Geräteeigentümer festgelegt ist,
  • "managedProfile": ein Gerät, auf dem der DPC als Profilinhaber festgelegt ist


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

Zulässige Werte sind:
  • „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 Updates von Geräteberichten.
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 der Epoche. Dieses Feld ist immer vorhanden.
notification[].deviceReportUpdateEvent.report.appState[] list Liste der App-Status, die von verwalteten Apps auf dem Gerät festgelegt wurden. Der App-Status wird 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 verschlüsselten App-Status. 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. Zur Verhinderung von XSS empfehlen wir, HTML-Code aus dem Schlüssel zu entfernen, bevor er angezeigt wird. Dieses Feld ist immer vorhanden.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].stateTimestampMillis long Zeitstempel in Millisekunden für den Zeitpunkt, zu dem die App den Status seit der Epoche festgelegt hat. Dieses Feld ist immer vorhanden.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].severity string Schweregrad des App-Status. Dieses Feld ist immer vorhanden.

Zulässige Werte sind:
  • „severityError“
  • „severityInfo“
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].message string Eine für Menschen lesbare Nachricht im freien Format, die den App-Status beschreibt. Dies kann beispielsweise eine Fehlermeldung sein. Entfernen Sie zur Vermeidung von XSS jeglichen HTML-Code aus der Nachricht, bevor Sie sie anzeigen.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].data string Zusätzliches Feld für maschinenlesbare Daten. Beispielsweise eine Zahl oder ein JSON-Objekt. Zur Vermeidung von XSS empfehlen wir, jeglichen HTML-Code aus den Daten zu entfernen, bevor sie angezeigt werden.
kind string