Enterprises: pullNotificationSet

Estrae e restituisce un set di notifiche per le aziende associate a l'account di servizio autenticato per la richiesta. La notifica impostata può essere vuota se non ci sono notifiche in attesa.
Una serie di notifiche restituita deve essere confermata entro 20 secondi chiamando Enterprises.AcknowledgeNotificationSet, a meno che il set di notifiche è vuoto.
Le notifiche che non vengono confermate entro 20 secondi verranno e alla fine essere nuovamente inclusi nella risposta a un altro PullNotificationSet. e quelli che non vengono mai riconosciuti saranno eliminati in base ai criteri di sistema Pub/Sub della piattaforma Google Cloud.
Potrebbero essere eseguite più richieste contemporaneamente per recuperare delle notifiche, nel qual caso le eventuali notifiche in attesa verranno divisa tra ciascun chiamante, se presente.
Se non sono presenti notifiche, viene restituito un elenco di notifiche vuoto. Le richieste successive potrebbero restituire più notifiche una volta che diventano disponibili.

Richiesta

Richiesta HTTP

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

Parametri

Nome del parametro Valore Descrizione
Parametri di query facoltativi
requestMode string La modalità di richiesta per il recupero delle notifiche.
Se specifichi waitForNotifications, la richiesta verrà bloccare e attendere che siano presenti una o più notifiche oppure restituire un elenco di notifiche vuoto se dopo un po' di tempo non ci sono notifiche.
Se specifichi returnImmediately, la richiesta verrà restituire immediatamente le notifiche in attesa o, in caso contrario, un elenco vuoto notifiche.
Se omesso, il valore predefinito è waitForNotifications.

I valori accettati sono:
  • "returnImmediately"
  • "waitForNotifications"

Autorizzazione

Questa richiesta richiede l'autorizzazione con il seguente ambito:

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

Per ulteriori informazioni, consulta la pagina Autenticazione e autorizzazione.

Corpo della richiesta

Non fornire un corpo della richiesta con questo metodo.

Risposta

In caso di esito positivo, questo metodo restituisce un corpo della risposta con la seguente struttura:

{
  "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
                }
              ]
            }
          ]
        }
      }
    }
  ]
}
Nome proprietà Valore Descrizione Note
notificationSetId string L'ID set di notifiche, necessario per contrassegnare la notifica come ricevuta con l'API Enterprises.AcknowledgeNotification. Questo valore verrà omesso se non sono presenti notifiche.
notification[] list Le notifiche ricevute oppure vuoto se non sono presenti notifiche.
notification[].enterpriseId string L'ID dell'azienda per cui viene inviata la notifica. Sarà sempre presente.
notification[].timestampMillis long L'ora di pubblicazione della notifica, in millisecondi, dal 1970-01-01T00:00:00Z. Sarà sempre presente.
notification[].productApprovalEvent nested object Notifiche relative alle modifiche allo stato di approvazione di un prodotto.
notification[].productApprovalEvent.productId string L'ID del prodotto (ad es. "app:com.google.android.gm") per il quale lo stato di approvazione è cambiato. Questo campo sarà sempre presente.
notification[].productApprovalEvent.approved string Indica se il prodotto è stato approvato o meno. Questo campo sarà sempre presente.

I valori accettati sono:
  • "approved"
  • "unapproved"
  • "unknown"
notification[].installFailureEvent nested object Notifiche relative a un errore di installazione dell'app.
notification[].installFailureEvent.productId string L'ID del prodotto (ad es. "app:com.google.android.gm") per cui si è verificato l'evento di errore di installazione. Questo campo sarà sempre presente.
notification[].installFailureEvent.deviceId string L'ID Android del dispositivo. Questo campo sarà sempre presente.
notification[].installFailureEvent.userId string L'ID dell'utente. Questo campo sarà sempre presente.
notification[].installFailureEvent.failureReason string Il motivo dell'errore di installazione. Questo campo sarà sempre presente.

I valori accettati sono:
  • "timeout"
  • "unknown"
notification[].installFailureEvent.failureDetails string Ulteriori dettagli sull'errore, se applicabili.
notification[].appUpdateEvent nested object Notifiche relative agli aggiornamenti delle app.
notification[].appUpdateEvent.productId string L'ID del prodotto (ad es. "app:com.google.android.gm") che è stato aggiornato. Questo campo sarà sempre presente.
notification[].newPermissionsEvent nested object Notifiche relative alle nuove autorizzazioni app.
notification[].newPermissionsEvent.productId string L'ID del prodotto (ad es. "app:com.google.android.gm") per cui sono state aggiunte nuove autorizzazioni. Questo campo sarà sempre presente.
notification[].newPermissionsEvent.requestedPermissions[] list L'insieme di autorizzazioni richieste attualmente dall'app. UsaPermissions.Ottieni l'API EMM per recuperare i dettagli su queste autorizzazioni.
notification[].newPermissionsEvent.approvedPermissions[] list L'insieme di autorizzazioni che l'amministratore aziendale ha già approvato per questa applicazione. Utilizza Permissions.Get nell'API EMM per recuperare i dettagli su queste autorizzazioni.
notification[].appRestrictionsSchemaChangeEvent nested object Notifiche relative alle nuove modifiche allo schema delle limitazioni delle app.
notification[].appRestrictionsSchemaChangeEvent.productId string L'ID del prodotto (ad es. "app:com.google.android.gm") per cui è stato modificato lo schema di limitazioni dell'app. Questo campo sarà sempre presente.
notification[].productAvailabilityChangeEvent nested object Notifiche sulle modifiche alla disponibilità dei prodotti.
notification[].productAvailabilityChangeEvent.productId string L'ID del prodotto (ad es. "app:com.google.android.gm") per cui è cambiata la disponibilità del prodotto. Questo campo sarà sempre presente.
notification[].productAvailabilityChangeEvent.availabilityStatus string Il nuovo stato del prodotto. Questo campo sarà sempre presente.

I valori accettati sono:
  • "available"
  • "removed"
  • "unknown"
  • "unpublished"
notification[].newDeviceEvent nested object Notifiche sui nuovi dispositivi.
notification[].newDeviceEvent.userId string L'ID dell'utente. Questo campo sarà sempre presente.
notification[].newDeviceEvent.deviceId string L'ID Android del dispositivo. Questo campo sarà sempre presente.
notification[].newDeviceEvent.managementType string Identifica la misura in cui il dispositivo è controllato da un Android EMM in varie configurazioni di implementazione.

I valori possibili sono:
  • "managedDevice", un dispositivo in cui il DPC è impostato come proprietario del dispositivo
  • "managedProfile", un dispositivo in cui il DPC è impostato come proprietario del profilo.
di Gemini Advanced.

I valori accettati sono:
  • "managedDevice"
  • "managedProfile"
notification[].notificationType string Tipo di notifica.

I valori accettati sono:
  • "appRestricionsSchemaChange"
  • "appUpdate"
  • "deviceReportUpdate"
  • "installFailure"
  • "newDevice"
  • "newPermissions"
  • "productApproval"
  • "productAvailabilityChange"
  • "testNotification"
  • "unknown"
notification[].newDeviceEvent.dpcPackageName string App di criteri sul dispositivo.
notification[].deviceReportUpdateEvent nested object Notifiche relative agli aggiornamenti dei report sui dispositivi.
notification[].deviceReportUpdateEvent.userId string L'ID dell'utente. Questo campo sarà sempre presente.
notification[].deviceReportUpdateEvent.deviceId string L'ID Android del dispositivo. Questo campo sarà sempre presente.
notification[].deviceReportUpdateEvent.report nested object Il report sui dispositivi è stato aggiornato con gli ultimi stati dell'app. Questo campo sarà sempre presente.
notification[].deviceReportUpdateEvent.report.lastUpdatedTimestampMillis long Timestamp dell'ultimo aggiornamento del report in millisecondi dall'epoca. Questo campo sarà sempre presente.
notification[].deviceReportUpdateEvent.report.appState[] list Elenco di stati delle app impostati dalle app gestite sul dispositivo. Gli stati delle app vengono definiti dagli sviluppatori delle app. Questo campo sarà sempre presente.
notification[].deviceReportUpdateEvent.report.appState[].packageName string Il nome del pacchetto dell'app. Questo campo sarà sempre presente.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[] list Elenco degli stati delle app con chiave. Questo campo sarà sempre presente.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].key string Chiave che indica lo stato dell'app. I contenuti della chiave vengono impostati dallo sviluppatore dell'app. Per evitare l'XSS, consigliamo di rimuovere l'eventuale codice HTML dalla chiave prima di visualizzarla. Questo campo sarà sempre presente.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].stateTimestampMillis long Timestamp del momento in cui l'app ha impostato lo stato in millisecondi dall'epoca. Questo campo sarà sempre presente.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].severity string Gravità dello stato dell'app. Questo campo sarà sempre presente.

I valori accettati sono:
  • "severityError"
  • "severityInfo"
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].message string Messaggio in formato libero e leggibile che descrive lo stato dell'app. Ad esempio, un messaggio di errore. Per evitare l'XSS, consigliamo di rimuovere l'eventuale codice HTML dal messaggio prima di visualizzarlo.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].data string Campo aggiuntivo destinato a dati leggibili dalle macchine. Ad esempio, un numero o un oggetto JSON. Per evitare l'XSS, consigliamo di rimuovere l'eventuale codice HTML dai dati prima di visualizzarli.
kind string