- 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 di Android Device Policy viene utilizzato dal dispositivo. Ciò influisce sulle impostazioni dei criteri supportate. |
state |
Lo stato da applicare al dispositivo. Questo campo può essere modificato tramite una richiesta di applicazione patch. Tieni presente che quando chiami |
appliedState |
Lo stato attualmente applicato al dispositivo. |
policyCompliant |
Se il dispositivo è conforme alle norme. |
nonComplianceDetails[] |
Dettagli sulle impostazioni dei criteri a cui il dispositivo non è conforme. |
enrollmentTime |
Data e ora della registrazione del dispositivo. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
lastStatusReportTime |
L'ultima volta che il dispositivo ha inviato un report sullo stato. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
lastPolicyComplianceReportTime |
Deprecato. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
lastPolicySyncTime |
L'ultima volta che il dispositivo ha recuperato il criterio. Un timestamp nel formato RFC3339 UTC "Zulu" 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 con dati aggiuntivi forniti, questo campo contiene questi 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. Queste informazioni sono disponibili soltanto se il valore |
hardwareInfo |
Informazioni dettagliate sull'hardware del dispositivo. |
displays[] |
Informazioni dettagliate sulle visualizzazioni sul dispositivo. Queste informazioni sono disponibili soltanto se il valore |
applicationReports[] |
Report relativi alle app installate sul dispositivo. Queste informazioni sono disponibili soltanto quando il valore |
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 si è già registrato in precedenza. I nomi sono in ordine cronologico. |
networkInfo |
Informazioni sulla rete del dispositivo. Queste informazioni sono disponibili soltanto se il valore |
memoryInfo |
Informazioni memoria: contiene informazioni sulla memoria e sullo spazio di archiviazione del dispositivo. |
memoryEvents[] |
Eventi relativi alle misurazioni della memoria e dello spazio di archiviazione in ordine cronologico. Queste informazioni sono disponibili soltanto se il valore Gli eventi vengono conservati per un determinato periodo di tempo e quelli precedenti vengono eliminati. |
powerManagementEvents[] |
Eventi di gestione dell'alimentazione sul dispositivo in ordine cronologico. Queste informazioni sono disponibili soltanto se il valore |
hardwareStatusSamples[] |
Campioni di stato dell'hardware in ordine cronologico. Queste informazioni sono disponibili soltanto se il valore |
deviceSettings |
Informazioni sulle impostazioni del dispositivo. Queste informazioni sono disponibili soltanto se il valore |
user |
L'utente proprietario del dispositivo. |
systemProperties |
Mappa del nome e del valore delle proprietà di sistema selezionate relative al dispositivo. Queste informazioni sono disponibili soltanto se il valore Un oggetto contenente un elenco di |
securityPosture |
Il valore della security posture del dispositivo, che riflette il livello di sicurezza del dispositivo. |
ownership |
Proprietà del dispositivo gestito. |
commonCriteriaModeInfo |
Informazioni sulla modalità Common Criteria: standard di sicurezza definiti in 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 relative all'eventuale migrazione di questo dispositivo dalla gestione da parte di un altro controller dei criteri dei dispositivi (DPC). |
DeviceState
Stati applicabili 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 di 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. |
DEACTIVATED_BY_DEVICE_FINANCE |
Questo è un dispositivo finanziato che è stato "bloccato" da parte dell'agente finanziario. Ciò significa che sono state applicate alcune impostazioni dei criteri che limitano la funzionalità del dispositivo fino allo "sbloccato" del dispositivo da parte dell'agente finanziario. Il dispositivo continuerà ad applicare le impostazioni dei criteri, escluse quelle sostituite dall'agente finanziario. Quando il dispositivo è "bloccato", lo stato viene indicato in appliedState come DEACTIVATED_BY_DEVICE_FINANCE . |
NonComplianceDetail
Fornisce dettagli sulla mancata conformità a un'impostazione di criteri.
Rappresentazione JSON |
---|
{ "settingName": string, "nonComplianceReason": enum ( |
Campi | |
---|---|
settingName |
Il nome dell'impostazione del criterio. Si tratta del nome 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 determinato campo nidificato non è conforme, verrà specificato il percorso completo del campo in questione. Il percorso è formattato nello stesso modo in cui verrebbe fatto riferimento al campo JSON del criterio in JavaScript, ovvero: 1) Per i campi di tipo oggetto, il nome del campo è seguito da un punto e dal nome di un 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 dei criteri, il valore attuale dell'impostazione sul dispositivo. |
installationFailureReason |
Se |
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 sta impedendo l'installazione dell'app. Alcuni possibili motivi sono i seguenti: il dispositivo non dispone di spazio di archiviazione sufficiente, la connessione di rete del dispositivo non è affidabile o l'installazione richiede 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 in genere quando la connettività a internet del dispositivo è ridotta, non disponibile o c'è un problema di configurazione di rete. Assicurati che il dispositivo abbia accesso alla connettività internet completa su una rete che soddisfa |
INSUFFICIENT_STORAGE |
Lo spazio di archiviazione sul dispositivo dell'utente non è sufficiente per installare l'app. Il problema si può risolvere liberando spazio di archiviazione sul dispositivo. L'installazione o l'aggiornamento delle app riprenderà automaticamente quando il dispositivo avrà spazio di archiviazione sufficiente. |
SpecificNonComplianceReason
Ulteriori dettagli sul motivo per cui un dispositivo potrebbe non essere conforme a un'impostazione dei criteri. In futuro è possibile aggiungere nuovi valori all'enumerazione.
Enum | |
---|---|
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED |
Il motivo specifico della mancata conformità non è 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. impostata su . |
PASSWORD_POLICIES_PASSWORD_EXPIRED |
La password del dispositivo o del profilo è scaduta. Impostazione impostata. impostata su . |
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT |
La password del dispositivo non soddisfa i requisiti delle password. Impostazione impostata. impostata su . |
ONC_WIFI_INVALID_VALUE |
Nella configurazione Wi-Fi ONC è presente un valore errato. specifica il valore del campo errato. Impostazione impostata. impostata su . |
ONC_WIFI_API_LEVEL |
L'impostazione Wi-Fi ONC non è supportata nel livello API della versione Android in esecuzione sul dispositivo. specifica quale valore del campo non è supportato. Impostazione impostata. impostata su . |
ONC_WIFI_INVALID_ENTERPRISE_CONFIG |
Nella rete Wi-Fi aziendale manca l'autorità di certificazione principale o il nome di dominio. impostata su . |
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK |
L'utente deve rimuovere manualmente la rete Wi-Fi configurata. Questa opzione si applica solo ai profili di lavoro sui dispositivi di proprietà personale. impostata 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. impostata su . |
SpecificNonComplianceContext
Contesto aggiuntivo per
.SpecificNonComplianceReason
Rappresentazione JSON |
---|
{ "oncWifiContext": { object ( |
Campi | |
---|---|
oncWifiContext |
Contesto aggiuntivo per la non conformità in relazione alla configurazione Wi-Fi. Vedi |
passwordPoliciesContext |
Contesto aggiuntivo per la non conformità in relazione ai criteri relativi alle password. Consulta i |
OncWifiContext
Contesto aggiuntivo per la non conformità in relazione 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à in relazione 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 della versione di Android visibile dall'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 dell'ID build Android pensata per essere mostrata all'utente. Ad esempio, |
deviceKernelVersion |
Versione kernel, ad esempio |
bootloaderVersion |
Il numero di versione del bootloader di sistema, ad esempio |
androidBuildTime |
Ora della creazione. Un timestamp nel formato RFC3339 UTC "Zulu" 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 la lingua 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, ovvero se esiste un aggiornamento e di che tipo. |
updateReceivedTime |
La data e l'ora in cui l'aggiornamento è stato disponibile per la prima volta. Il valore zero indica che questo campo non è impostato. Questo campo viene impostato solo se è disponibile un aggiornamento (ovvero Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
UpdateStatus
Lo stato di un aggiornamento, ovvero se esiste un aggiornamento e di che tipo.
Enum | |
---|---|
UPDATE_STATUS_UNKNOWN |
Non è noto se esiste un aggiornamento di sistema in sospeso. Questo accade, ad esempio, quando 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 sospeso, 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 il criterio 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 |
Brand 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 per la limitazione della batteria in gradi Celsius per ogni batteria del dispositivo. |
cpuShutdownTemperatures[] |
Soglie di temperatura di arresto della CPU in Celsius per ogni CPU sul dispositivo. |
cpuThrottlingTemperatures[] |
Soglie di temperatura per la limitazione della CPU in Celsius per ogni CPU sul dispositivo. |
gpuShutdownTemperatures[] |
Soglie di temperatura di arresto della GPU in Celsius per ogni GPU sul dispositivo. |
gpuThrottlingTemperatures[] |
Soglie di temperatura per la limitazione della GPU in Celsius per ogni GPU sul dispositivo. |
skinShutdownTemperatures[] |
Soglie della temperatura di spegnimento della pelle del dispositivo in gradi Celsius. |
skinThrottlingTemperatures[] |
Soglie di temperatura per la 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 viene effettuata la registrazione con la stessa organizzazione, questo ID persiste durante tutte le configurazioni e anche il ripristino dei dati di fabbrica. Questo ID è disponibile sui dispositivi di proprietà personale con un profilo di lavoro sui 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 display univoco. |
refreshRate |
Frequenza di aggiornamento del display in frame al secondo. |
state |
Stato del display. |
width |
Larghezza di visualizzazione in pixel. |
height |
Altezza di visualizzazione in pixel. |
density |
Densità del display espressa in punti per pollice. |
DisplayState
Lo stato di una visualizzazione.
Enum | |
---|---|
DISPLAY_STATE_UNSPECIFIED |
Questo valore non è consentito. |
OFF |
Il display non è attivo. |
ON |
Il display è attivo. |
DOZE |
Il display è inattivo in stato di basso consumo |
SUSPENDED |
Il display è inattivo in stato di sospensione a bassa potenza. |
ApplicationReport
Sono state segnalate informazioni 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 di eventi 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 |
Origine del pacchetto. |
state |
Stato dell'applicazione. |
keyedAppStates[] |
Elenco di stati dell'app con 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 nel formato RFC3339 UTC "Zulu" 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 quella precedente. |
RESTARTED |
L'app è stata riavviata. |
PINNED |
L'app è stata bloccata in primo piano. |
UNPINNED |
L'app è stata sbloccata. |
ApplicationSource
La fonte che ha fornito un'app.
Enum | |
---|---|
APPLICATION_SOURCE_UNSPECIFIED |
L'app è stata trasferita tramite sideload da un'origine non specificata. |
SYSTEM_APP_FACTORY_VERSION |
Questa è 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 attuale dell'installazione.
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. Rappresenta un punto di riferimento per lo stato fornito dall'app. Ad esempio, se fornisci un feedback sulla configurazione gestita, questa chiave potrebbe essere la chiave di configurazione gestita. |
severity |
La gravità dello stato dell'app. |
message |
Facoltativamente, 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 valore deve essere incluso nel messaggio. |
data |
Facoltativamente, un valore leggibile dalla macchina che deve essere letto dall'EMM. Ad esempio, l'impostazione di valori su cui l'amministratore può scegliere di eseguire una query nella console EMM (ad es. "invia una notifica se i dati della batteria_avviso sono inferiori a 10"). |
createTime |
L'ora di creazione dello stato dell'app sul dispositivo. Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
lastUpdateTime |
L'ora in cui lo stato dell'app è stato aggiornato più di recente. Un timestamp nel formato RFC3339 UTC "Zulu" 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 autentiche che devono essere risolte da un'organizzazione di gestione. |
UserFacingType
Se l'app è rivolta agli utenti.
Enum | |
---|---|
USER_FACING_TYPE_UNSPECIFIED |
Il tipo di app rivolto agli utenti 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 |
L'indirizzo MAC Wi-Fi del dispositivo. Ad esempio, |
networkOperatorName |
Nome alfabetico dell'operatore registrato attuale. ad esempio Vodafone. |
telephonyInfos[] |
Fornisce informazioni relative alla telefonia associate a ogni scheda SIM sul dispositivo. Funzionalità supportata solo su 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 su 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
Evento relativo alle misurazioni della memoria e dello spazio di archiviazione.
Per distinguere tra eventi nuovi e vecchi, 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 nel formato RFC3339 UTC "Zulu" 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 ha 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 |
È stato rimosso un supporto di archiviazione esterno. 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 nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
batteryLevel |
Per eventi |
PowerManagementEventType
Il tipo di evento.
Enum | |
---|---|
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED |
Non specificato. Nessun evento ha questo tipo. |
BATTERY_LEVEL_COLLECTED |
È stato misurato il livello della batteria. |
POWER_CONNECTED |
La ricarica del dispositivo è iniziata. |
POWER_DISCONNECTED |
La ricarica del dispositivo è stata interrotta. |
BATTERY_LOW |
Il dispositivo è entrato in modalità a basso consumo. |
BATTERY_OKAY |
Il dispositivo è uscito dalla modalità a basso consumo. |
BOOT_COMPLETED |
Il dispositivo si è avviato. |
SHUTDOWN |
Il dispositivo si è spento. |
HardwareStatus
Stato 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 nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: |
batteryTemperatures[] |
Temperature attuali della batteria in Celsius per ogni batteria del dispositivo. |
cpuTemperatures[] |
Le temperature attuali della CPU in gradi Celsius per ogni CPU sul dispositivo. |
gpuTemperatures[] |
Temperature GPU attuali in Celsius per ogni GPU sul dispositivo. |
skinTemperatures[] |
Temperature cutanea attuali del dispositivo in gradi Celsius. |
fanSpeeds[] |
Velocità della ventola in rpm per ogni ventola sul dispositivo. Un array vuoto indica che non sono presenti ventole o che la velocità delle ventole non è supportata dal sistema. |
cpuUsages[] |
Utilizzo della CPU in percentuale per ogni core disponibile sul dispositivo. L'utilizzo è 0 per ogni core scollegato. Un array vuoto implica che l'utilizzo della CPU non è supportato nel sistema. |
DeviceSettings
Informazioni sulle impostazioni di sicurezza del dispositivo sul dispositivo.
Rappresentazione JSON |
---|
{
"isDeviceSecure": boolean,
"unknownSourcesEnabled": boolean,
"developmentSettingsEnabled": boolean,
"adbEnabled": boolean,
"isEncrypted": boolean,
"encryptionStatus": enum ( |
Campi | |
---|---|
isDeviceSecure |
Se il dispositivo è protetto con PIN/password. |
unknownSourcesEnabled |
Se l'installazione di app da origini sconosciute è attiva. |
developmentSettingsEnabled |
Se la modalità sviluppatore è attiva sul dispositivo. |
adbEnabled |
Indica se ADB è abilitato sul dispositivo. |
isEncrypted |
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 dovrebbe 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 è 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
Il livello di sicurezza del dispositivo, come determinato dallo stato attuale del dispositivo e dai criteri applicati.
Rappresentazione JSON |
---|
{ "devicePosture": enum ( |
Campi | |
---|---|
devicePosture |
Valore della security posture del dispositivo. |
postureDetails[] |
Ulteriori dettagli relativi alla security posture del dispositivo. |
DevicePosture
Possibili valori della security posture di un dispositivo gestito.
Enum | |
---|---|
POSTURE_UNSPECIFIED |
Non specificato. Nessun dettaglio della postura per questo valore della postura. |
SECURE |
Questo dispositivo è sicuro. |
AT_RISK |
Questo dispositivo potrebbe essere più vulnerabile ai malintenzionati rispetto a quanto consigliato per l'utilizzo con i dati aziendali. |
POTENTIALLY_COMPROMISED |
Questo dispositivo potrebbe essere stato compromesso e i dati aziendali potrebbero essere accessibili da soggetti non autorizzati. |
PostureDetail
Ulteriori dettagli relativi alla security posture del dispositivo.
Rappresentazione JSON |
---|
{ "securityRisk": enum ( |
Campi | |
---|---|
securityRisk |
Un rischio per la sicurezza specifico che influisce negativamente sulla condizione di sicurezza del dispositivo. |
advice[] |
Consigli corrispondenti rivolti agli amministratori per mitigare questo rischio per la sicurezza e migliorare la condizione di sicurezza del dispositivo. |
SecurityRisk
Il rischio che il dispositivo non sia 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 non va a buon fine). |
COMPROMISED_OS |
L'API Play Integrity rileva che sul dispositivo è in esecuzione un sistema operativo compromesso (il controllo 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 visualizzata nel campo relativo all'integrità del dispositivo. |
CommonCriteriaModeInfo
Informazioni sulla modalità Common Criteria: standard di sicurezza definiti in Common Criteria for Information Technology Security Evaluation (CC).
Queste informazioni sono disponibili solo se il criterio statusReportingSettings.commonCriteriaModeEnabled
è true
nei criteri del dispositivo.
Rappresentazione JSON |
---|
{
"commonCriteriaModeStatus": enum ( |
Campi | |
---|---|
commonCriteriaModeStatus |
Indica se è attivata la modalità Common Criteria. |
CommonCriteriaModeStatus
Indica se è attivata la modalità Common Criteria.
Enum | |
---|---|
COMMON_CRITERIA_MODE_STATUS_UNKNOWN |
Stato sconosciuto. |
COMMON_CRITERIA_MODE_DISABLED |
La modalità Common Criteria è attualmente disattivata. |
COMMON_CRITERIA_MODE_ENABLED |
Al momento è abilitata la modalità Common Criteria. |
DpcMigrationInfo
Informazioni relative all'eventuale migrazione di questo dispositivo dalla gestione da parte di 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, si tratta del nome del pacchetto. Non viene 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. |
|
Recupera un dispositivo. |
|
Invia un comando a un dispositivo. |
|
Elenca i dispositivi di una determinata azienda. |
|
Consente di aggiornare un dispositivo. |