- Risorsa: dispositivo
- DeviceState
- NonComplianceDetail
- InstallationFailureReason
- SpecificNonComplianceReason
- SpecificNonComplianceContext
- OncWifiContext
- PasswordPoliciesContext
- SoftwareInfo
- SystemUpdateInfo
- UpdateStatus
- HardwareInfo
- Display
- DisplayState
- ApplicationReport
- ApplicationEvent
- ApplicationEventType
- ApplicationSource
- ApplicationState
- KeyedAppState
- Gravità
- UserFacingType
- NetworkInfo
- TelephonyInfo
- MemoryInfo
- MemoryEvent
- MemoryEventType
- PowerManagementEvent
- PowerManagementEventType
- HardwareStatus
- DeviceSettings
- EncryptionStatus
- SecurityPosture
- DevicePosture
- PostureDetail
- SecurityRisk
- CommonCriteriaModeInfo
- CommonCriteriaModeStatus
- DpcMigrationInfo
- Metodi
Risorsa: dispositivo
Un dispositivo di proprietà di un'azienda. Se non diversamente indicato, tutti i campi sono di sola lettura e non possono essere modificati da enterprises.devices.patch
.
Rappresentazione JSON |
---|
{ "name": string, "userName": string, "managementMode": enum ( |
Campi | |
---|---|
name |
Il nome del dispositivo nel formato |
userName |
Il nome della risorsa dell'utente proprietario di questo dispositivo nel formato |
managementMode |
Il tipo di modalità di gestione utilizzata da Android Device Policy sul dispositivo. Questo influisce sulle impostazioni dei criteri supportate. |
state |
Lo stato da applicare al dispositivo. Questo campo può essere modificato da una richiesta di patch. Tieni presente che quando chiami |
appliedState |
Lo stato attualmente applicato al dispositivo. |
policyCompliant |
Se il dispositivo è conforme ai relativi criteri. |
nonComplianceDetails[] |
Dettagli sulle impostazioni dei criteri a cui il dispositivo non è conforme. |
enrollmentTime |
L'ora della registrazione dei dispositivi. Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
lastStatusReportTime |
L'ultima volta che il dispositivo ha inviato un report di stato. Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
lastPolicyComplianceReportTime |
Deprecato. Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
lastPolicySyncTime |
L'ultima volta che il dispositivo ha recuperato il criterio. Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
policyName |
Il nome del criterio applicato al dispositivo, nel formato |
appliedPolicyName |
Il nome del criterio attualmente applicato al dispositivo. |
appliedPolicyVersion |
La versione del criterio attualmente applicata al dispositivo. |
apiLevel |
Il livello API della versione della piattaforma Android in esecuzione sul dispositivo. |
enrollmentTokenData |
Se il dispositivo è stato registrato con un token di registrazione e sono stati forniti dati aggiuntivi, questo campo contiene quei dati. |
enrollmentTokenName |
Se il dispositivo è stato registrato con un token di registrazione, questo campo contiene il nome del token. |
disabledReason |
Se lo stato del dispositivo è |
softwareInfo |
Informazioni dettagliate sul software del dispositivo. Questa informazione è disponibile solo se |
hardwareInfo |
Informazioni dettagliate sull'hardware del dispositivo. |
displays[] |
Informazioni dettagliate sui display sul dispositivo. Questa informazione è disponibile solo se |
applicationReports[] |
Report per app installate sul dispositivo. Queste informazioni sono disponibili soltanto se |
previousDeviceNames[] |
Se lo stesso dispositivo fisico è stato registrato più volte, questo campo contiene i nomi dei dispositivi precedenti. Il numero di serie viene utilizzato come identificatore univoco per determinare se lo stesso dispositivo fisico è stato registrato in precedenza. I nomi sono in ordine cronologico. |
networkInfo |
Informazioni sulla rete del dispositivo. Questa informazione è disponibile solo se |
memoryInfo |
Informazioni sulla memoria: contiene informazioni sulla memoria e sullo spazio di archiviazione del dispositivo. |
memoryEvents[] |
Eventi relativi alle misurazioni di memoria e spazio di archiviazione in ordine cronologico. Questa informazione è disponibile solo se Gli eventi vengono conservati per un determinato periodo di tempo e quelli vecchi vengono eliminati. |
powerManagementEvents[] |
Eventi di gestione dell'alimentazione sul dispositivo in ordine cronologico. Questa informazione è disponibile solo se |
hardwareStatusSamples[] |
Esempi di stato hardware in ordine cronologico. Questa informazione è disponibile solo se |
deviceSettings |
Informazioni sulle impostazioni del dispositivo. Questa informazione è disponibile solo se |
user |
L'utente proprietario del dispositivo. |
systemProperties |
Mappa del nome e del valore delle proprietà di sistema selezionate relative al dispositivo. Questa informazione è disponibile solo se Un oggetto contenente un elenco di |
securityPosture |
Il valore della strategia di sicurezza del dispositivo, che riflette il suo livello di sicurezza. |
ownership |
Proprietà del dispositivo gestito. |
commonCriteriaModeInfo |
Informazioni sulla modalità Common Criteria: standard di sicurezza definiti nel documento Common Criteria for Information Technology Security Evaluation (CC). Queste informazioni sono disponibili solo se |
appliedPasswordPolicies[] |
I requisiti per le password attualmente applicati al dispositivo.
|
dpcMigrationInfo |
Solo output. Informazioni che indicano se è stata eseguita la migrazione di questo dispositivo affinché non sia più gestito da un altro controller dei criteri dei dispositivi (DPC). |
DeviceState
Stati che possono essere applicati a un dispositivo.
Enum | |
---|---|
DEVICE_STATE_UNSPECIFIED |
Questo valore non è consentito. |
ACTIVE |
Il dispositivo è attivo. |
DISABLED |
Il dispositivo è disattivato. |
DELETED |
Il dispositivo è stato eliminato. Questo stato non viene mai restituito da una chiamata API, ma viene utilizzato nel report dello stato finale quando il dispositivo conferma l'eliminazione. Se il dispositivo viene eliminato tramite la chiamata API, questo stato viene pubblicato in Pub/Sub. Se l'utente elimina il profilo di lavoro o reimposta il dispositivo, lo stato del dispositivo rimarrà sconosciuto al server. |
PROVISIONING |
È in corso il provisioning del dispositivo. I dispositivi appena registrati rimangono in questo stato finché non viene applicato un criterio. |
LOST |
Il dispositivo è stato smarrito. Questo stato è possibile solo sui dispositivi di proprietà dell'organizzazione. |
PREPARING_FOR_MIGRATION |
Il dispositivo è in fase di preparazione per la migrazione all'API Android Management. Non sono necessarie ulteriori azioni per continuare la migrazione. |
NonComplianceDetail
Fornisce dettagli sulla non conformità a un'impostazione dei criteri.
Rappresentazione JSON |
---|
{ "settingName": string, "nonComplianceReason": enum ( |
Campi | |
---|---|
settingName |
Il nome dell'impostazione del criterio. Si tratta del nome di un campo JSON di un campo |
nonComplianceReason |
Il motivo per cui il dispositivo non è conforme all'impostazione. |
packageName |
Il nome del pacchetto che indica quale app non è conforme, se applicabile. |
fieldPath |
Per le impostazioni con campi nidificati, se un particolare campo nidificato non è conforme, viene specificato il percorso completo del campo in questione. La formattazione del percorso è la stessa del campo JSON del criterio a cui fa riferimento in JavaScript, ovvero: 1) Per i campi di tipo oggetto, il nome del campo è seguito da un punto e poi da un nome di sottocampo. 2) Per i campi di tipo array, il nome del campo è seguito dall'indice dell'array racchiuso tra parentesi. Ad esempio, per indicare un problema con il campo |
currentValue |
Se non è stato possibile applicare l'impostazione del criterio, il valore attuale dell'impostazione sul dispositivo. |
installationFailureReason |
Se il criterio |
specificNonComplianceReason |
Il motivo specifico del criterio per cui il dispositivo non è conforme all'impostazione. |
specificNonComplianceContext |
Contesto aggiuntivo per |
InstallationFailureReason
Motivi per cui l'installazione di un'app potrebbe non riuscire.
Enum | |
---|---|
INSTALLATION_FAILURE_REASON_UNSPECIFIED |
Questo valore non è consentito. |
INSTALLATION_FAILURE_REASON_UNKNOWN |
Una condizione sconosciuta impedisce l'installazione dell'app. Ecco alcuni potenziali motivi: lo spazio di archiviazione sul dispositivo non è sufficiente, la connessione di rete del dispositivo è inaffidabile o l'installazione sta richiedendo più tempo del previsto. L'installazione verrà ritentata automaticamente. |
IN_PROGRESS |
L'installazione è ancora in corso. |
NOT_FOUND |
App non trovata in Google Play. |
NOT_COMPATIBLE_WITH_DEVICE |
L'app non è compatibile con il dispositivo. |
NOT_APPROVED |
L'app non è stata approvata dall'amministratore. |
PERMISSIONS_NOT_ACCEPTED |
L'app ha nuove autorizzazioni che non sono state accettate dall'amministratore. |
NOT_AVAILABLE_IN_COUNTRY |
Lʼapp non è disponibile nel paese in cui risiedono gli utenti. |
NO_LICENSES_REMAINING |
Non sono disponibili licenze da assegnare all'utente. |
NOT_ENROLLED |
L'azienda non è più registrata alla versione gestita di Google Play oppure l'amministratore non ha accettato i Termini di servizio della versione gestita di Google Play più recenti. |
USER_INVALID |
L'utente non è più valido. L'utente potrebbe essere stato eliminato o disattivato. |
NETWORK_ERROR_UNRELIABLE_CONNECTION |
Un errore di rete sul dispositivo dell'utente ha impedito il completamento dell'installazione. Questo accade solitamente quando la connettività internet del dispositivo è ridotta, non disponibile o si verifica un problema di configurazione della rete. Assicurati che il dispositivo abbia accesso alla connettività internet completa su una rete conforme a |
INSUFFICIENT_STORAGE |
Sul dispositivo dell'utente non è disponibile spazio di archiviazione sufficiente per installare l'app. Per risolvere il problema, libera spazio di archiviazione sul dispositivo. L'installazione o l'aggiornamento delle app riprenderà automaticamente quando lo spazio di archiviazione sul dispositivo sarà sufficiente. |
SpecificNonComplianceReason
Maggiori dettagli sul motivo per cui un dispositivo potrebbe non essere conforme a un'impostazione dei criteri. In futuro sarà possibile aggiungere nuovi valori all'enum.
Enum | |
---|---|
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED |
Il motivo specifico della non conformità non è stato specificato. I campi in non sono impostati. |
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED |
L'utente deve confermare le credenziali inserendo il blocco schermo. I campi in non sono impostati. è impostato su . |
PASSWORD_POLICIES_PASSWORD_EXPIRED |
La password del dispositivo o del profilo è scaduta. Impostazione impostata. è impostato su . |
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT |
La password del dispositivo non soddisfa i requisiti per le password. Impostazione impostata. è impostato su . |
ONC_WIFI_INVALID_VALUE |
È presente un valore errato nella configurazione Wi-Fi ONC. specifica il valore del campo errato. Impostazione impostata. è impostato su . |
ONC_WIFI_API_LEVEL |
L'impostazione Wi-Fi ONC non è supportata nel livello API della versione di Android in esecuzione sul dispositivo. specifica il valore del campo non supportato. Impostazione impostata. è impostato su . |
ONC_WIFI_INVALID_ENTERPRISE_CONFIG |
Nella rete Wi-Fi aziendale manca l'autorità di certificazione principale o il nome di dominio. è impostato su . |
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK |
L'utente deve rimuovere manualmente la rete Wi-Fi configurata. Questo vale solo per i profili di lavoro su dispositivi di proprietà personale. è impostato su . |
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY |
L'alias della coppia di chiavi specificato tramite il campo ClientCertKeyPairAlias in non corrisponde a una chiave esistente installata sul dispositivo. è impostato su . |
SpecificNonComplianceContext
Contesto aggiuntivo per
.SpecificNonComplianceReason
Rappresentazione JSON |
---|
{ "oncWifiContext": { object ( |
Campi | |
---|---|
oncWifiContext |
Contesto aggiuntivo per la non conformità relativa alla configurazione Wi-Fi. Vedi |
passwordPoliciesContext |
Contesto aggiuntivo per la non conformità relativa ai criteri relativi alle password. Leggi i |
OncWifiContext
Contesto aggiuntivo per la non conformità relativa alla configurazione Wi-Fi.
Rappresentazione JSON |
---|
{ "wifiGuid": string } |
Campi | |
---|---|
wifiGuid |
Il GUID della configurazione Wi-Fi non conforme. |
PasswordPoliciesContext
Contesto aggiuntivo per la non conformità relativa ai criteri relativi alle password.
Rappresentazione JSON |
---|
{
"passwordPolicyScope": enum ( |
Campi | |
---|---|
passwordPolicyScope |
L'ambito della password non conforme. |
SoftwareInfo
Informazioni sul software del dispositivo.
Rappresentazione JSON |
---|
{
"androidVersion": string,
"androidDevicePolicyVersionCode": integer,
"androidDevicePolicyVersionName": string,
"androidBuildNumber": string,
"deviceKernelVersion": string,
"bootloaderVersion": string,
"androidBuildTime": string,
"securityPatchLevel": string,
"primaryLanguageCode": string,
"deviceBuildSignature": string,
"systemUpdateInfo": {
object ( |
Campi | |
---|---|
androidVersion |
La stringa di versione di Android visibile all'utente. Ad esempio, |
androidDevicePolicyVersionCode |
Il codice di versione dell'app Android Device Policy. |
androidDevicePolicyVersionName |
La versione dell'app Android Device Policy mostrata all'utente. |
androidBuildNumber |
Stringa ID build Android da mostrare all'utente. Ad esempio, |
deviceKernelVersion |
Versione del kernel, ad esempio |
bootloaderVersion |
Il numero di versione del bootloader di sistema, ad esempio |
androidBuildTime |
Ora della creazione. Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
securityPatchLevel |
Livello patch di sicurezza, ad esempio |
primaryLanguageCode |
Un codice lingua IETF BCP 47 per l'impostazione internazionale principale sul dispositivo. |
deviceBuildSignature |
Hash SHA-256 di |
systemUpdateInfo |
Informazioni su un potenziale aggiornamento di sistema in attesa. |
SystemUpdateInfo
Informazioni su un potenziale aggiornamento di sistema in attesa.
Rappresentazione JSON |
---|
{
"updateStatus": enum ( |
Campi | |
---|---|
updateStatus |
Lo stato di un aggiornamento: se esiste un aggiornamento e di che tipo. |
updateReceivedTime |
La data e l'ora in cui l'aggiornamento è stato disponibile per la prima volta. Un valore pari a zero indica che questo campo non è impostato. Questo campo viene impostato solo se è disponibile un aggiornamento, ovvero Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
UpdateStatus
Lo stato di un aggiornamento: se esiste un aggiornamento e di che tipo.
Enum | |
---|---|
UPDATE_STATUS_UNKNOWN |
Non è noto se ci sia un aggiornamento di sistema in sospeso. Questo accade, ad esempio, se il livello API del dispositivo è inferiore a 26 o se la versione di Android Device Policy è obsoleta. |
UP_TO_DATE |
Nessun aggiornamento di sistema in attesa disponibile sul dispositivo. |
UNKNOWN_UPDATE_AVAILABLE |
È disponibile un aggiornamento di sistema in attesa, ma il tipo non è noto. |
SECURITY_UPDATE_AVAILABLE |
È disponibile un aggiornamento della sicurezza in attesa. |
OS_UPDATE_AVAILABLE |
È disponibile un aggiornamento del sistema operativo in attesa. |
HardwareInfo
Informazioni sull'hardware del dispositivo. I campi relativi alle soglie di temperatura sono disponibili solo se hardwareStatusEnabled
è true nel criterio del dispositivo.
Rappresentazione JSON |
---|
{ "brand": string, "hardware": string, "deviceBasebandVersion": string, "manufacturer": string, "serialNumber": string, "model": string, "batteryShutdownTemperatures": [ number ], "batteryThrottlingTemperatures": [ number ], "cpuShutdownTemperatures": [ number ], "cpuThrottlingTemperatures": [ number ], "gpuShutdownTemperatures": [ number ], "gpuThrottlingTemperatures": [ number ], "skinShutdownTemperatures": [ number ], "skinThrottlingTemperatures": [ number ], "enterpriseSpecificId": string } |
Campi | |
---|---|
brand |
Marca del dispositivo. Ad esempio, |
hardware |
Nome dell'hardware. Ad esempio, |
deviceBasebandVersion |
Versione banda di base. Ad esempio, |
manufacturer |
Produttore Ad esempio, |
serialNumber |
Il numero di serie del dispositivo. |
model |
Il modello del dispositivo. Ad esempio, |
batteryShutdownTemperatures[] |
Soglie di temperatura di spegnimento della batteria in gradi Celsius per ogni batteria del dispositivo. |
batteryThrottlingTemperatures[] |
Soglie di temperatura di limitazione della batteria in gradi Celsius per ogni batteria del dispositivo. |
cpuShutdownTemperatures[] |
Soglie di temperatura di arresto della CPU in gradi Celsius per ogni CPU sul dispositivo. |
cpuThrottlingTemperatures[] |
Soglie di temperatura di limitazione della CPU in gradi Celsius per ogni CPU sul dispositivo. |
gpuShutdownTemperatures[] |
Soglie di temperatura di arresto della GPU in gradi Celsius per ogni GPU sul dispositivo. |
gpuThrottlingTemperatures[] |
Soglie di temperatura di limitazione della GPU in gradi Celsius per ogni GPU del dispositivo. |
skinShutdownTemperatures[] |
Soglie di temperatura di spegnimento della pelle del dispositivo in gradi Celsius. |
skinThrottlingTemperatures[] |
Soglie di temperatura di limitazione della pelle del dispositivo in gradi Celsius. |
enterpriseSpecificId |
Solo output. ID che identifica in modo univoco un dispositivo di proprietà personale in una determinata organizzazione. Sullo stesso dispositivo fisico quando è registrato con la stessa organizzazione, questo ID persiste per tutte le configurazioni e anche per i ripristini dei dati di fabbrica. Questo ID è disponibile sui dispositivi di proprietà personale con un profilo di lavoro su dispositivi con Android 12 e versioni successive. |
Display
Informazioni di visualizzazione del dispositivo.
Rappresentazione JSON |
---|
{
"name": string,
"displayId": integer,
"refreshRate": integer,
"state": enum ( |
Campi | |
---|---|
name |
Nome del display. |
displayId |
ID visualizzato univoco. |
refreshRate |
Frequenza di aggiornamento del display in frame al secondo. |
state |
Stato del display. |
width |
Larghezza visualizzazione in pixel. |
height |
Altezza visualizzazione in pixel. |
density |
Densità del display espressa come punti per pollice. |
DisplayState
Lo stato di un display.
Enum | |
---|---|
DISPLAY_STATE_UNSPECIFIED |
Questo valore non è consentito. |
OFF |
Il display è spento. |
ON |
Il display è acceso. |
DOZE |
Il display è sospeso in stato di basso consumo |
SUSPENDED |
Il display è sospeso in stato di sospensione a bassa potenza. |
ApplicationReport
Informazioni segnalate su un'app installata.
Rappresentazione JSON |
---|
{ "packageName": string, "versionName": string, "versionCode": integer, "events": [ { object ( |
Campi | |
---|---|
packageName |
Nome del pacchetto dell'app. |
versionName |
La versione dell'app mostrata all'utente. |
versionCode |
Il codice di versione dell'app, che può essere utilizzato per determinare se una versione è più recente di un'altra. |
events[] |
L'elenco degli eventi dell'app che si sono verificati nelle ultime 30 ore. |
displayName |
Il nome visualizzato dell'app. |
packageSha256Hash |
L'hash SHA-256 del file APK dell'app, che può essere utilizzato per verificare che l'app non sia stata modificata. Ogni byte del valore hash è rappresentato da un numero esadecimale a due cifre. |
signingKeyCertFingerprints[] |
L'hash SHA-1 di ogni |
installerPackageName |
Il nome del pacchetto dell'app che ha installato questa app. |
applicationSource |
L'origine del pacchetto. |
state |
Stato dell'applicazione. |
keyedAppStates[] |
Elenco di stati dell'app associati a una chiave segnalati dall'app. |
userFacingType |
Se l'app è rivolta agli utenti. |
ApplicationEvent
Un evento relativo all'app.
Rappresentazione JSON |
---|
{
"eventType": enum ( |
Campi | |
---|---|
eventType |
Tipo di evento app. |
createTime |
L'ora di creazione dell'evento. Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
ApplicationEventType
Un tipo di evento relativo all'app.
Enum | |
---|---|
APPLICATION_EVENT_TYPE_UNSPECIFIED |
Questo valore non è consentito. |
INSTALLED |
L'app è stata installata. |
CHANGED |
L'app è stata modificata, ad esempio è stato attivato o disattivato un componente. |
DATA_CLEARED |
I dati dell'app sono stati cancellati. |
REMOVED |
L'app è stata rimossa. |
REPLACED |
È stata installata una nuova versione dell'app, che sostituisce la versione precedente. |
RESTARTED |
L'app è stata riavviata. |
PINNED |
L'app è stata bloccata in primo piano. |
UNPINNED |
L'app è stata sbloccata. |
ApplicationSource
L'origine che ha fornito un'app.
Enum | |
---|---|
APPLICATION_SOURCE_UNSPECIFIED |
L'app è stata installata tramite sideload da un'origine non specificata. |
SYSTEM_APP_FACTORY_VERSION |
Si tratta di un'app di sistema dall'immagine di fabbrica del dispositivo. |
SYSTEM_APP_UPDATED_VERSION |
Questa è un'app di sistema aggiornata. |
INSTALLED_FROM_PLAY_STORE |
L'app è stata installata dal Google Play Store. |
ApplicationState
Lo stato di installazione attuale.
Enum | |
---|---|
APPLICATION_STATE_UNSPECIFIED |
Lo stato dell'app non è specificato |
REMOVED |
L'app è stata rimossa dal dispositivo |
INSTALLED |
L'app è installata sul dispositivo |
KeyedAppState
Stato dell'app con chiave segnalato dall'app.
Rappresentazione JSON |
---|
{
"key": string,
"severity": enum ( |
Campi | |
---|---|
key |
La chiave per lo stato dell'app. Funge da punto di riferimento per lo stato fornito dall'app. Ad esempio, se fornisci il feedback sulla configurazione gestita, questa chiave potrebbe essere la chiave di configurazione gestita. |
severity |
La gravità dello stato dell'app. |
message |
(Facoltativo) Una stringa di messaggio in formato libero per spiegare lo stato dell'app. Se lo stato è stato attivato da un determinato valore (ad es. un valore di configurazione gestita), questo deve essere incluso nel messaggio. |
data |
Facoltativamente, un valore leggibile dal computer che deve essere letto dal provider EMM. Ad esempio, impostare i valori su cui l'amministratore può scegliere di eseguire una query nella console EMM (ad es. "avvisami se i dati di battery_warning sono inferiori a 10"). |
createTime |
L'ora di creazione dello stato dell'app sul dispositivo. Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
lastUpdateTime |
L'ora dell'ultimo aggiornamento dello stato dell'app. Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
Gravità
La gravità dello stato dell'app.
Enum | |
---|---|
SEVERITY_UNSPECIFIED |
Livello di gravità non specificato. |
INFO |
Livello di gravità delle informazioni. |
ERROR |
Livello di gravità dell'errore. Questo valore deve essere impostato solo per condizioni di errore reali che un'organizzazione di gestione deve intervenire per risolvere. |
UserFacingType
Se l'app è rivolta agli utenti.
Enum | |
---|---|
USER_FACING_TYPE_UNSPECIFIED |
Il tipo di visualizzazione rivolto agli utenti dell'app non è specificato. |
NOT_USER_FACING |
L'app non è rivolta agli utenti. |
USER_FACING |
L'app è rivolta agli utenti. |
NetworkInfo
Informazioni sulla rete del dispositivo.
Rappresentazione JSON |
---|
{
"imei": string,
"meid": string,
"wifiMacAddress": string,
"networkOperatorName": string,
"telephonyInfos": [
{
object ( |
Campi | |
---|---|
imei |
Numero IMEI del dispositivo GSM. Ad esempio, |
meid |
Numero MEID del dispositivo CDMA. Ad esempio, |
wifiMacAddress |
Indirizzo MAC Wi-Fi del dispositivo. Ad esempio, |
networkOperatorName |
Nome alfabetico dell'operatore registrato corrente. ad esempio Vodafone. |
telephonyInfos[] |
Fornisce informazioni sulle telefonate associate a ogni scheda SIM del dispositivo. Funzionalità supportata solo sui dispositivi completamente gestiti a partire dal livello API Android 23. |
TelephonyInfo
Informazioni di telefonia associate a una determinata scheda SIM sul dispositivo. Funzionalità supportata solo sui dispositivi completamente gestiti a partire dal livello API Android 23.
Rappresentazione JSON |
---|
{ "phoneNumber": string, "carrierName": string } |
Campi | |
---|---|
phoneNumber |
Il numero di telefono associato a questa scheda SIM. |
carrierName |
Il nome dell'operatore associato a questa scheda SIM. |
MemoryInfo
Informazioni sulla memoria e sullo spazio di archiviazione del dispositivo.
Rappresentazione JSON |
---|
{ "totalRam": string, "totalInternalStorage": string } |
Campi | |
---|---|
totalRam |
RAM totale sul dispositivo in byte. |
totalInternalStorage |
Memoria interna totale sul dispositivo in byte. |
MemoryEvent
Un evento relativo alle misurazioni della memoria e dello spazio di archiviazione.
Per distinguere gli eventi nuovi da quelli precedenti, ti consigliamo di utilizzare il campo
.createTime
Rappresentazione JSON |
---|
{
"eventType": enum ( |
Campi | |
---|---|
eventType |
Tipo di evento. |
createTime |
L'ora di creazione dell'evento. Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
byteCount |
Il numero di byte senza costi nel mezzo o, per |
MemoryEventType
Il tipo di evento.
Enum | |
---|---|
MEMORY_EVENT_TYPE_UNSPECIFIED |
Non specificato. Nessun evento con questo tipo. |
RAM_MEASURED |
È stato misurato lo spazio libero nella RAM. |
INTERNAL_STORAGE_MEASURED |
È stato misurato lo spazio libero nella memoria interna. |
EXTERNAL_STORAGE_DETECTED |
È stato rilevato un nuovo supporto di archiviazione esterno. Il conteggio dei byte segnalati è la capacità totale del mezzo di archiviazione. |
EXTERNAL_STORAGE_REMOVED |
Un supporto di archiviazione esterno è stato rimosso. Il conteggio dei byte segnalati è pari a zero. |
EXTERNAL_STORAGE_MEASURED |
È stato misurato lo spazio libero in un supporto di archiviazione esterno. |
PowerManagementEvent
Un evento di gestione dell'alimentazione.
Rappresentazione JSON |
---|
{
"eventType": enum ( |
Campi | |
---|---|
eventType |
Tipo di evento. |
createTime |
L'ora di creazione dell'evento. Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
batteryLevel |
Per gli eventi |
PowerManagementEventType
Il tipo di evento.
Enum | |
---|---|
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED |
Non specificato. Nessun evento con questo tipo. |
BATTERY_LEVEL_COLLECTED |
Il livello della batteria è stato misurato. |
POWER_CONNECTED |
La ricarica del dispositivo è iniziata. |
POWER_DISCONNECTED |
La ricarica del dispositivo è stata interrotta. |
BATTERY_LOW |
Sul dispositivo è stata attivata la modalità a basso consumo. |
BATTERY_OKAY |
Il dispositivo è uscito dalla modalità a basso consumo. |
BOOT_COMPLETED |
Il dispositivo è stato avviato. |
SHUTDOWN |
Il dispositivo si è spento. |
HardwareStatus
Stato dell'hardware. Le temperature possono essere confrontate con le soglie di temperatura disponibili in hardwareInfo
per determinare l'integrità dell'hardware.
Rappresentazione JSON |
---|
{ "createTime": string, "batteryTemperatures": [ number ], "cpuTemperatures": [ number ], "gpuTemperatures": [ number ], "skinTemperatures": [ number ], "fanSpeeds": [ number ], "cpuUsages": [ number ] } |
Campi | |
---|---|
createTime |
L'ora in cui sono state effettuate le misurazioni. Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
batteryTemperatures[] |
Le temperature attuali della batteria in Celsius per ogni batteria del dispositivo. |
cpuTemperatures[] |
Le attuali temperature della CPU in Celsius per ogni CPU sul dispositivo. |
gpuTemperatures[] |
Temperature GPU attuali in Celsius per ogni GPU del dispositivo. |
skinTemperatures[] |
Temperature cutanea attuali del dispositivo in Celsius. |
fanSpeeds[] |
Velocità della ventola in RPM per ciascuna ventola sul dispositivo. Un array vuoto indica che non ci sono ventole o che la velocità della ventola non è supportata sull'impianto. |
cpuUsages[] |
Utilizzi della CPU in percentuale per ogni core disponibile sul dispositivo. L'utilizzo è 0 per ogni core scollegato. Un array vuoto indica che l'utilizzo della CPU non è supportato nel sistema. |
DeviceSettings
Informazioni sulle impostazioni del dispositivo relative alla sicurezza.
Rappresentazione JSON |
---|
{
"isDeviceSecure": boolean,
"unknownSourcesEnabled": boolean,
"developmentSettingsEnabled": boolean,
"adbEnabled": boolean,
"isEncrypted": boolean,
"encryptionStatus": enum ( |
Campi | |
---|---|
isDeviceSecure |
Se il dispositivo è protetto con PIN/password. |
unknownSourcesEnabled |
Indica se l'installazione di app da origini sconosciute è abilitata. |
developmentSettingsEnabled |
Indica se la modalità sviluppatore è attivata sul dispositivo. |
adbEnabled |
Indica se ADB è abilitato sul dispositivo. |
isEncrypted |
Indica se la crittografia dello spazio di archiviazione è abilitata. |
encryptionStatus |
Stato della crittografia da DevicePolicyManager. |
verifyAppsEnabled |
Indica se la verifica di Google Play Protect è applicata al dispositivo. |
EncryptionStatus
Stato della crittografia di un dispositivo.
Enum | |
---|---|
ENCRYPTION_STATUS_UNSPECIFIED |
Non specificato. Nessun dispositivo deve avere questo tipo. |
UNSUPPORTED |
La crittografia non è supportata dal dispositivo. |
INACTIVE |
La crittografia è supportata dal dispositivo, ma al momento non è attiva. |
ACTIVATING |
La crittografia non è attualmente attiva, ma è in fase di attivazione. |
ACTIVE |
La crittografia è attiva. |
ACTIVE_DEFAULT_KEY |
La crittografia è attiva, ma l'utente non ha impostato una chiave di crittografia. |
ACTIVE_PER_USER |
La crittografia è attiva e la chiave di crittografia è legata al profilo utente. |
SecurityPosture
La strategia di sicurezza del dispositivo, come determinata dallo stato attuale del dispositivo e dai criteri applicati.
Rappresentazione JSON |
---|
{ "devicePosture": enum ( |
Campi | |
---|---|
devicePosture |
Valore della strategia di sicurezza del dispositivo. |
postureDetails[] |
Ulteriori dettagli relativi alla postura di sicurezza del dispositivo. |
DevicePosture
Possibili valori della strategia di sicurezza di un dispositivo gestito.
Enum | |
---|---|
POSTURE_UNSPECIFIED |
Non specificato. Nessun dettaglio posture per questo valore posture. |
SECURE |
Questo dispositivo è sicuro. |
AT_RISK |
Questo dispositivo potrebbe essere più vulnerabile a malintenzionati di quanto non sia consigliato per l'uso con i dati aziendali. |
POTENTIALLY_COMPROMISED |
Questo dispositivo potrebbe essere stato compromesso e i dati aziendali potrebbero essere accessibili a soggetti non autorizzati. |
PostureDetail
Ulteriori dettagli relativi alla postura di sicurezza del dispositivo.
Rappresentazione JSON |
---|
{ "securityRisk": enum ( |
Campi | |
---|---|
securityRisk |
Un rischio per la sicurezza specifico che influisce negativamente sulla posizione di sicurezza del dispositivo. |
advice[] |
Consiglio dell'amministratore corrispondente per mitigare questo rischio per la sicurezza e migliorare la condizione di sicurezza del dispositivo. |
SecurityRisk
Il rischio che il dispositivo non si trovi nello stato più sicuro.
Enum | |
---|---|
SECURITY_RISK_UNSPECIFIED |
Non specificato. |
UNKNOWN_OS |
L'API Play Integrity rileva che sul dispositivo è in esecuzione un sistema operativo sconosciuto (il controllo BasicIntegrity ha esito positivo, ma ctsProfileMatch ha esito negativo). |
COMPROMISED_OS |
L'API Play Integrity rileva che sul dispositivo è in esecuzione un sistema operativo compromesso (il controllo di BasicIntegrity non va a buon fine). |
HARDWARE_BACKED_EVALUATION_FAILED |
L'API Play Integrity rileva che il dispositivo non ha una solida garanzia di integrità del sistema se l'etichetta MEETS_STRONG_INTEGRITY non viene mostrata nel campo relativo all'integrità del dispositivo. |
CommonCriteriaModeInfo
Informazioni sulla modalità Common Criteria: standard di sicurezza definiti nel documento Common Criteria for Information Technology Security Evaluation (CC).
Questa informazione è disponibile solo se statusReportingSettings.commonCriteriaModeEnabled
è true
nei criteri del dispositivo.
Rappresentazione JSON |
---|
{
"commonCriteriaModeStatus": enum ( |
Campi | |
---|---|
commonCriteriaModeStatus |
Indica se la modalità Common Criteria è abilitata. |
CommonCriteriaModeStatus
Indica se la modalità Common Criteria è abilitata.
Enum | |
---|---|
COMMON_CRITERIA_MODE_STATUS_UNKNOWN |
Stato sconosciuto. |
COMMON_CRITERIA_MODE_DISABLED |
La modalità Common Criteria è attualmente disabilitata. |
COMMON_CRITERIA_MODE_ENABLED |
La modalità Common Criteria è attualmente attiva. |
DpcMigrationInfo
Informazioni che indicano se è stata eseguita la migrazione di questo dispositivo affinché non sia più gestito da un altro controller dei criteri dei dispositivi (DPC).
Rappresentazione JSON |
---|
{ "previousDpc": string, "additionalData": string } |
Campi | |
---|---|
previousDpc |
Solo output. Se questo dispositivo è stato migrato da un altro DPC, questo è il nome del pacchetto. Non compilato negli altri casi. |
additionalData |
Solo output. Se è stata eseguita la migrazione di questo dispositivo da un altro DPC, il campo |
Metodi |
|
---|---|
|
Elimina un dispositivo. |
|
Riceve un dispositivo. |
|
Invia un comando a un dispositivo. |
|
Elenca i dispositivi di una determinata azienda. |
|
Aggiorna un dispositivo. |