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:
|
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:
|
|
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:
|
|
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:
|
|
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:
I valori accettati sono:
|
|
notification[].notificationType |
string |
Tipo di notifica.
I valori accettati sono:
|
|
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:
|
|
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 |