Per un elenco dei metodi utilizzati per questa risorsa, consulta la fine di questa pagina.
Rappresentazioni delle risorse
Una risorsa Dispositivi rappresenta un dispositivo mobile gestito dall'EMM e appartenente a un utente aziendale specifico.
{ "kind": "androidenterprise#device", "androidId": string, "managementType": string, "policy": { "autoUpdatePolicy": string, "productAvailabilityPolicy": string, "productPolicy": [ { "productId": string, "tracks": [ string ], "trackIds": [ string ], "managedConfiguration": { "kind": string, "productId": string, "managedProperty": [ { "key": string, "valueBool": boolean, "valueInteger": integer, "valueString": string, "valueStringArray": [ string ], "valueBundle": { "managedProperty": [ (ManagedProperty) ] }, "valueBundleArray": [ { "managedProperty": [ (ManagedProperty) ] } ] } ], "configurationVariables": { "kind": "androidenterprise#configurationVariables", "mcmId": string, "variableSet": [ { "kind": "androidenterprise#variableSet", "placeholder": string, "userValue": string } ] } }, "autoInstallPolicy": { "autoInstallMode": string, "autoInstallPriority": integer, "autoInstallConstraint": [ { "networkTypeConstraint": string, "chargingStateConstraint": string, "deviceIdleStateConstraint": string } ], "minimumVersionCode": integer }, "autoUpdateMode": string, "enterpriseAuthenticationAppLinkConfigs": [ { "uri": string } ] } ], "maintenanceWindow": { "startTimeAfterMidnightMs": long, "durationMs": long }, "deviceReportPolicy": string }, "report": { "lastUpdatedTimestampMillis": long, "appState": [ { "packageName": string, "keyedAppState": [ { "key": string, "stateTimestampMillis": long, "severity": string, "message": string, "data": string } ] } ] }, "latestBuildFingerprint": string, "sdkVersion": integer, "maker": string, "model": string, "device": string, "product": string, "retailBrand": string }
Nome proprietà | Valore | Descrizione | Note |
---|---|---|---|
androidId |
string |
L'ID Android di Google Play Services per il dispositivo codificato come stringa esadecimale minuscola. Ad esempio, "123456789abcdef0" . |
|
device |
string |
Il nome in codice hardware interno del dispositivo. Questo proviene da android.os.Build.DEVICE . (campo denominato "device" per logs/wireless/android/android_checkin.proto) |
|
kind |
string |
||
latestBuildFingerprint |
string |
Fingerprint della build del dispositivo, se nota. | |
maker |
string |
Il produttore del dispositivo. Questo proviene da android.os.Build.MANUFACTURER . |
|
managementType |
string |
Identifica la misura in cui il dispositivo è controllato da un EMM di Google Play gestito in varie configurazioni di deployment. I valori possibili sono:
I valori accettati sono:
|
|
model |
string |
Il nome del modello del dispositivo. Questo proviene da android.os.Build.MODEL . |
|
policy |
nested object |
Il criterio applicato al dispositivo. | |
policy.autoUpdatePolicy |
string |
Consente di stabilire quando applicare gli aggiornamenti automatici delle app sul dispositivo. Alternativa consigliata: autoUpdateMode impostato in base all'app, che offre maggiore flessibilità in merito alla frequenza di aggiornamento. Quando autoUpdateMode è impostato su AUTO_UPDATE_POSTPONED o AUTO_UPDATE_HIGH_PRIORITY , autoUpdatePolicy non ha alcun effetto. "choiceToTheUser" consente all'utente del dispositivo di configurare le norme di aggiornamento dell'app. "sempre" attiva gli aggiornamenti automatici. "never" disabilita gli aggiornamenti automatici. "wifiOnly" attiva gli aggiornamenti automatici solo quando il dispositivo è connesso al Wi-Fi. I valori accettati sono:
|
|
policy.deviceReportPolicy |
string |
Indica se il dispositivo segnala gli stati dell'app al provider EMM. Il valore predefinito è "deviceReportDisabled".
I valori accettati sono:
|
|
policy.maintenanceWindow |
nested object |
Il periodo di manutenzione che definisce quando le app in esecuzione in primo piano deve essere aggiornato. | |
policy.maintenanceWindow.durationMs |
long |
Durata del periodo di manutenzione, in millisecondi. La durata deve essere compresa tra 30 minuti e 24 ore (incluse). | |
policy.maintenanceWindow.startTimeAfterMidnightMs |
long |
Ora di inizio del periodo di manutenzione, in millisecondi dopo la mezzanotte sul dispositivo. Windows può oltrepassare la mezzanotte. | |
policy.productAvailabilityPolicy |
string |
La disponibilità concessa al dispositivo per i prodotti specificati. L'opzione "tutti" consente al dispositivo di accedere a tutti i prodotti, indipendentemente dallo stato di approvazione. L'opzione "tutti" non attiva la visibilità automatica dei canali "alpha" o "beta". "Whitelist" concede al dispositivo l'accesso ai prodotti specificati in productPolicy[]. Solo i prodotti approvati o quelli precedentemente approvati dall'azienda (prodotti con approvazione revocata) possono essere autorizzati. Se non viene fornito alcun valore, per impostazione predefinita viene applicata la disponibilità impostata a livello di utente.
I valori accettati sono:
|
|
policy.productPolicy[] |
list |
L'elenco delle norme del prodotto. productAvailabilityPolicy deve essere impostato su WHITELIST o ALL per poter applicare le norme del prodotto. |
|
policy.productPolicy[].autoInstallPolicy |
nested object |
Il criterio di installazione automatica del prodotto. | |
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[] |
list |
I vincoli per l'installazione automatica dell'app. Puoi specificare un massimo di un vincolo. |
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].chargingStateConstraint |
string |
Vincolo dello stato di ricarica.
I valori accettati sono:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].deviceIdleStateConstraint |
string |
Vincolo di stato di inattività del dispositivo.
I valori accettati sono:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallConstraint[].networkTypeConstraint |
string |
Vincolo del tipo di rete.
I valori accettati sono:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallMode |
string |
La modalità di installazione automatica. Se il criterio non viene configurato, il valore predefinito è "doNotAutoInstall". Un'app viene installata automaticamente indipendentemente da un periodo di manutenzione impostato.
I valori accettati sono:
|
|
policy.productPolicy[].autoInstallPolicy.autoInstallPriority |
integer |
La priorità dell'installazione, sotto forma di numero intero senza firma. Un numero più basso indica una priorità più alta. | |
policy.productPolicy[].autoInstallPolicy.minimumVersionCode |
integer |
La versione minima dell'app. Se è installata una versione precedente dell'app, questa verrà aggiornata automaticamente in base ai vincoli dell'installazione automatica, invece di attendere il regolare aggiornamento automatico. Puoi impostare un codice di versione minimo per un massimo di 20 app per dispositivo. | |
policy.productPolicy[].autoUpdateMode |
string |
La modalità di aggiornamento automatico per il prodotto. Quando viene utilizzato, autoUpdateMode ha sempre la precedenza sulla scelta dell'utente. Di conseguenza, quando un utente apporta manualmente modifiche alle impostazioni del dispositivo, queste vengono ignorate.
I valori accettati sono:
|
|
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[] |
list |
Una configurazione di un URL di autenticazione per l'app di autenticazione di un provider di identità. Questa operazione aiuta ad avviare l'app di autenticazione del provider di identità durante l'autenticazione in un'app privata che utilizza WebView di Android. L'app di autenticazione dovrebbe già essere il gestore predefinito per l'URL di autenticazione sul dispositivo. | |
policy.productPolicy[].enterpriseAuthenticationAppLinkConfigs[].uri |
string |
Un URL di autenticazione. | |
policy.productPolicy[].managedConfiguration |
nested object |
La configurazione gestita del prodotto. | |
policy.productPolicy[].managedConfiguration.configurationVariables |
nested object |
Contiene l'ID del profilo di configurazione gestita e l'insieme di variabili di configurazione (se presenti) definite per l'utente. | |
policy.productPolicy[].managedConfiguration.configurationVariables.kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.mcmId |
string |
L'ID delle impostazioni delle configurazioni gestite. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[] |
list |
L'insieme di variabili attribuito all'utente. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].kind |
string |
||
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].placeholder |
string |
La stringa segnaposto; definita da EMM. | |
policy.productPolicy[].managedConfiguration.configurationVariables.variableSet[].userValue |
string |
Il valore del segnaposto specifico per l'utente. | |
policy.productPolicy[].managedConfiguration.kind |
string |
Obsoleto. |
|
policy.productPolicy[].managedConfiguration.managedProperty[] |
list |
L'insieme di proprietà gestite per questa configurazione. | |
policy.productPolicy[].managedConfiguration.managedProperty[].key |
string |
La chiave univoca che identifica la proprietà. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBool |
boolean |
Valore booleano: sarà presente solo se il tipo di proprietà è bool. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle |
nested object |
Il pacchetto di proprietà gestite: sarà presente solo se il tipo di proprietà è un pacchetto. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundle.managedProperty[] |
list |
L'elenco delle proprietà gestite. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[] |
list |
L'elenco di pacchetti di proprietà: sarà presente solo se il tipo della proprietà è bundle_array. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueBundleArray[].managedProperty[] |
list |
L'elenco delle proprietà gestite. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueInteger |
integer |
Il valore numerico: sarà presente solo se il tipo di proprietà è un numero intero. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueString |
string |
Valore stringa: sarà presente solo se il tipo di proprietà è stringa, scelta o nascosto. | |
policy.productPolicy[].managedConfiguration.managedProperty[].valueStringArray[] |
list |
Elenco di valori stringa: presente solo se il tipo di proprietà è a selezione multipla. | |
policy.productPolicy[].managedConfiguration.productId |
string |
L'ID del prodotto a cui è destinata la configurazione gestita, ad esempio "app:com.google.android.gm". | |
policy.productPolicy[].productId |
string |
L'ID del prodotto. Ad esempio, "app:com.google.android.gm" . |
|
policy.productPolicy[].trackIds[] |
list |
Concede la visibilità del dispositivo ai canali di rilascio del prodotto specificati, identificati da trackIds . L'elenco dei canali di rilascio di un prodotto può essere ottenuto chiamando Products.Get. |
|
policy.productPolicy[].tracks[] |
list |
Deprecato. Usa invece il criterio trackIds . |
|
product |
string |
Il nome del dispositivo. Questo proviene da android.os.Build.PRODUCT . |
|
report |
nested object |
Il report sul dispositivo aggiornato con gli ultimi stati dell'app. | |
report.appState[] |
list |
Elenco di stati delle app impostati dalle app gestite sul dispositivo. Gli stati dell'app sono definiti dagli sviluppatori dell'app. Questo campo sarà sempre presente. | |
report.appState[].keyedAppState[] |
list |
Elenco di stati delle app con chiave. Questo campo sarà sempre presente. | |
report.appState[].keyedAppState[].data |
string |
Campo aggiuntivo destinato ai dati leggibili dalle macchine. Ad esempio, un oggetto numerico o JSON. Per evitare XSS, consigliamo di rimuovere qualsiasi codice HTML dai dati prima di visualizzarli. | |
report.appState[].keyedAppState[].key |
string |
Chiave che indica lo scopo per cui l'app fornisce uno stato. I contenuti della chiave vengono impostati dallo sviluppatore dell'app. Per evitare XSS, consigliamo di rimuovere qualsiasi codice HTML dalla chiave prima di visualizzarla. Questo campo sarà sempre presente. | |
report.appState[].keyedAppState[].message |
string |
Messaggio leggibile in formato libero che descrive lo stato dell'app. Ad esempio, un messaggio di errore. Per impedire XSS, consigliamo di rimuovere qualsiasi codice HTML dal messaggio prima di visualizzarlo. | |
report.appState[].keyedAppState[].severity |
string |
Gravità dello stato dell'app. Questo campo sarà sempre presente.
I valori accettati sono:
|
|
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. | |
report.appState[].packageName |
string |
Il nome del pacchetto dell'app. Questo campo sarà sempre presente. | |
report.lastUpdatedTimestampMillis |
long |
Il timestamp dell'ultimo aggiornamento del report in millisecondi dall'epoca. Questo campo sarà sempre presente. | |
retailBrand |
string |
Brand di vendita al dettaglio del dispositivo, se impostato. Consulta il sito android.os.Build.BRAND . |
|
sdkVersion |
integer |
Versione di compatibilità dell'API. |
Metodi
- forceReportUpload
- Carica un report contenente eventuali modifiche degli stati delle app sul dispositivo dall'ultima generazione del report. Puoi chiamare questo metodo fino a 3 volte ogni 24 ore per un determinato dispositivo.
- prendi
- Recupera i dettagli di un dispositivo.
- getState
- Recupera se l'accesso di un dispositivo ai servizi Google è attivato o disattivato. Lo stato del dispositivo diventa effettivo solo se l'applicazione dei criteri EMM sui dispositivi Android è abilitata nella Console di amministrazione Google. In caso contrario, lo stato del dispositivo viene ignorato e tutti i dispositivi possono accedere ai servizi Google. Questa opzione è supportata solo per gli utenti gestiti da Google.
- list
- Recupera gli ID di tutti i dispositivi di un utente.
- setState
- Consente di attivare o disattivare l'accesso di un dispositivo ai servizi Google. Lo stato del dispositivo diventa effettivo solo se l'applicazione dei criteri EMM sui dispositivi Android è abilitata nella Console di amministrazione Google. In caso contrario, lo stato del dispositivo viene ignorato e tutti i dispositivi possono accedere ai servizi Google. Questa opzione è supportata solo per gli utenti gestiti da Google.
- aggiornamento
- Aggiorna i criteri relativi ai dispositivi.
Per garantire che il criterio venga applicato correttamente, devi impedire agli account non gestiti di accedere a Google Play impostandoallowed_accounts
nella configurazione gestita del pacchetto Google Play. Vedi Limitare gli account in Google Play.