- Risorsa: dispositivo
- DeviceState
- NonComplianceDetail
- InstallationFailureReason
- SpecificNonComplianceReason
- SpecificNonComplianceContext
- OncWifiContext
- PasswordPoliciesContext
- SoftwareInfo
- SystemUpdateInfo
- UpdateStatus
- HardwareInfo
- EuiccChipInfo
- Display
- DisplayState
- ApplicationReport
- ApplicationEvent
- ApplicationEventType
- ApplicationSource
- ApplicationState
- KeyedAppState
- Gravità
- UserFacingType
- NetworkInfo
- TelephonyInfo
- ActivationState
- ConfigMode
- MemoryInfo
- MemoryEvent
- MemoryEventType
- PowerManagementEvent
- PowerManagementEventType
- HardwareStatus
- DeviceSettings
- EncryptionStatus
- SecurityPosture
- DevicePosture
- PostureDetail
- SecurityRisk
- CommonCriteriaModeInfo
- CommonCriteriaModeStatus
- PolicySignatureVerificationStatus
- 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 che Android Device Policy assume sul dispositivo. Ciò 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 al criterio. |
nonComplianceDetails[] |
Dettagli sulle impostazioni dei criteri a cui il dispositivo non è conforme. |
enrollmentTime |
L'ora di registrazione del dispositivo. Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
lastStatusReportTime |
L'ultima volta che il dispositivo ha inviato un report di stato. Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
lastPolicyComplianceReportTime |
Deprecato. Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
lastPolicySyncTime |
L'ultima volta che il dispositivo ha recuperato i criteri. Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". 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 applicato 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 i 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 solo se |
hardwareInfo |
Informazioni dettagliate sull'hardware del dispositivo. |
displays[] |
Informazioni dettagliate sui display del dispositivo. Queste informazioni sono disponibili solo se |
applicationReports[] |
Report per le app installate sul dispositivo. Queste informazioni sono disponibili solo quando |
previousDeviceNames[] |
Se lo stesso dispositivo fisico è stato registrato più volte, questo campo contiene i nomi precedenti del dispositivo. 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. Queste informazioni sono disponibili solo se |
memoryInfo |
Informazioni sulla memoria: contiene informazioni sulla memoria e sullo spazio di archiviazione del dispositivo. |
memoryEvents[] |
Eventi correlati alle misurazioni di memoria e spazio di archiviazione in ordine cronologico. Queste informazioni sono disponibili solo se Gli eventi vengono conservati per un determinato periodo di tempo e quelli meno recenti vengono eliminati. |
powerManagementEvents[] |
Eventi di gestione dell'alimentazione sul dispositivo in ordine cronologico. Queste informazioni sono disponibili solo se |
hardwareStatusSamples[] |
Esempi di stato dell'hardware in ordine cronologico. Queste informazioni sono disponibili solo se |
deviceSettings |
Informazioni sulle impostazioni del dispositivo. Queste informazioni sono disponibili solo se |
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 solo se Un oggetto contenente un elenco di coppie |
securityPosture |
Valore della postura di sicurezza 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 nei Common Criteria for Information Technology Security Evaluation (CC). Queste informazioni sono disponibili solo se |
appliedPasswordPolicies[] |
I requisiti di password attualmente applicati al dispositivo.
|
dpcMigrationInfo |
Solo output. Informazioni relative alla migrazione di questo dispositivo dalla gestione di 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 sullo stato finale quando il dispositivo conferma l'eliminazione. Se il dispositivo viene eliminato tramite la chiamata API, questo stato viene pubblicato su Pub/Sub. Se l'utente elimina il profilo di lavoro o ripristina il dispositivo, lo stato del dispositivo rimarrà sconosciuto al server. |
PROVISIONING |
È in corso il provisioning del dispositivo. I dispositivi appena registrati si trovano in questo stato finché non viene applicato un criterio. |
LOST |
Il dispositivo è smarrito. Questo stato è possibile solo sui dispositivi di proprietà dell'organizzazione. |
PREPARING_FOR_MIGRATION |
Il dispositivo si sta preparando per la migrazione all'API Android Management. Non sono necessari ulteriori interventi per continuare la migrazione. |
DEACTIVATED_BY_DEVICE_FINANCE |
Si tratta di un dispositivo finanziato che è stato "bloccato" dall'agente finanziario. Ciò significa che sono state applicate determinate impostazioni dei criteri che limitano la funzionalità del dispositivo finché non viene "sbloccato" dall'agente finanziario. Il dispositivo continuerà ad applicare le impostazioni dei criteri, escluse quelle sottoposte a override dall'agente finanziario. Quando il dispositivo è "bloccato", lo stato viene segnalato in appliedState come DEACTIVATED_BY_DEVICE_FINANCE . |
NonComplianceDetail
Fornisce dettagli sulla mancata conformità a un'impostazione delle norme.
Rappresentazione JSON |
---|
{ "settingName": string, "nonComplianceReason": enum ( |
Campi | |
---|---|
settingName |
Il nome dell'impostazione del criterio. Questo è il nome del campo JSON di un campo |
nonComplianceReason |
Il motivo per cui il dispositivo non è conforme all'impostazione. |
packageName |
Il nome del pacchetto che indica l'app non conforme, se applicabile. |
fieldPath |
Per le impostazioni con campi nidificati, se un determinato campo nidificato non è conforme, viene specificato il percorso completo del campo in violazione. Il percorso è formattato nello stesso modo in cui viene fatto riferimento al campo JSON della norma 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 l'impostazione del criterio non è stata applicata, il valore corrente 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 |
Un problema sconosciuto impedisce l'installazione dell'app. Alcuni potenziali motivi sono che il dispositivo non ha 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 |
L'app non è stata trovata su 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 dispone di 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 a Google Play gestito o l'amministratore non ha accettato i Termini di servizio di Google Play gestito 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 l'installazione. Di solito questo accade quando la connettività a internet del dispositivo è degradata, non disponibile o si verifica un problema di configurazione di rete. Assicurati che il dispositivo abbia accesso alla connettività internet completa su una rete che soddisfi |
INSUFFICIENT_STORAGE |
Il dispositivo dell'utente non dispone di spazio di archiviazione sufficiente per installare l'app. Questo problema può essere risolto liberando spazio di archiviazione sul dispositivo. L'installazione o l'aggiornamento dell'app riprenderà automaticamente quando il dispositivo avrà spazio di archiviazione sufficiente. |
SpecificNonComplianceReason
Maggiori 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 di 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. è impostato su . |
PASSWORD_POLICIES_PASSWORD_EXPIRED |
La password del dispositivo o del profilo è scaduta. è impostato. è impostato su . |
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT |
La password del dispositivo non soddisfa i requisiti della password. è impostato. è impostato su . |
ONC_WIFI_INVALID_VALUE |
Nella configurazione Wi-Fi ONC è presente un valore errato. specifica quale valore del campo non è corretto. è impostato. è 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 quale valore del campo non è supportato. è impostato. è impostato su . |
ONC_WIFI_INVALID_ENTERPRISE_CONFIG |
Nella rete Wi-Fi aziendale manca la CA radice o il nome di dominio. è impostato su . |
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK |
L'utente deve rimuovere manualmente la rete Wi-Fi configurata. Ciò è applicabile solo ai profili di lavoro sui 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 . |
PERMISSIBLE_USAGE_RESTRICTION |
Questa impostazione dei criteri è limitata e non può essere impostata per questo progetto Google Cloud Platform. Per maggiori dettagli (incluso come attivare l'utilizzo di questa impostazione di policy), consulta le Norme sull'utilizzo consentito. è impostato su . |
REQUIRED_ACCOUNT_NOT_IN_ENTERPRISE |
L'account di lavoro richiesto dall'impostazione del criterio non fa più parte dell'azienda. è impostato su . |
NEW_ACCOUNT_NOT_IN_ENTERPRISE |
L'account di lavoro aggiunto dall'utente non fa parte dell'azienda. è impostato su . |
SpecificNonComplianceContext
Contesto aggiuntivo per
.SpecificNonComplianceReason
Rappresentazione JSON |
---|
{ "oncWifiContext": { object ( |
Campi | |
---|---|
oncWifiContext |
Contesto aggiuntivo per la mancata conformità relativa alla configurazione Wi-Fi. Vedi |
passwordPoliciesContext |
Contesto aggiuntivo per la mancata conformità relativa alle norme sulle password. Leggi |
OncWifiContext
Contesto aggiuntivo per la mancata 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 mancata conformità relativa alle norme sulle 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 all'utente. Ad esempio, |
androidDevicePolicyVersionCode |
Il codice di versione dell'app Android Device Policy. |
androidDevicePolicyVersionName |
La versione dell'app Android Device Policy visualizzata dall'utente. |
androidBuildNumber |
Stringa ID build Android destinata alla visualizzazione per l'utente. Ad esempio, |
deviceKernelVersion |
Versione del kernel, ad esempio |
bootloaderVersion |
Il numero di versione del bootloader di sistema, ad esempio |
androidBuildTime |
Tempo di compilazione. Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
securityPatchLevel |
Livello patch di sicurezza, ad esempio |
primaryLanguageCode |
Un codice lingua IETF BCP 47 per le impostazioni internazionali principali 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 |
L'ora in cui l'aggiornamento è stato reso 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 Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
UpdateStatus
Lo stato di un aggiornamento: se esiste un aggiornamento e di che tipo è.
Enum | |
---|---|
UPDATE_STATUS_UNKNOWN |
Non è noto se è presente un aggiornamento di sistema in attesa. Ciò accade, ad esempio, quando il livello API del dispositivo è inferiore a 26 o se la versione di Android Device Policy è obsoleta. |
UP_TO_DATE |
Non è disponibile alcun aggiornamento di sistema in attesa sul dispositivo. |
UNKNOWN_UPDATE_AVAILABLE |
È disponibile un aggiornamento di sistema in attesa, ma il relativo 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 nelle norme 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,
"euiccChipInfo": [
{
object ( |
Campi | |
---|---|
brand |
Il 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 di limitazione della batteria in gradi Celsius per ogni batteria del dispositivo. |
cpuShutdownTemperatures[] |
Soglie di temperatura di spegnimento 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 spegnimento della GPU in gradi Celsius per ogni GPU sul dispositivo. |
gpuThrottlingTemperatures[] |
Soglie di temperatura di throttling della GPU in gradi Celsius per ogni GPU sul dispositivo. |
skinShutdownTemperatures[] |
Soglie di temperatura di spegnimento del dispositivo in gradi Celsius. |
skinThrottlingTemperatures[] |
Soglie di temperatura di limitazione della temperatura cutanea 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 registrato con la stessa organizzazione, questo ID viene mantenuto durante le configurazioni e anche dopo i ripristini 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. |
euiccChipInfo[] |
Solo output. Informazioni relative al chip eUICC. |
EuiccChipInfo
Informazioni relative al chip eUICC.
Rappresentazione JSON |
---|
{ "eid": string } |
Campi | |
---|---|
eid |
Solo output. L'Embedded Identity Document (EID) che identifica il chip eUICC per ogni chip eUICC sul dispositivo. Questa funzionalità è disponibile sui dispositivi di proprietà aziendale con Android 13 e versioni successive. |
Display
Informazioni sul display del dispositivo.
Rappresentazione JSON |
---|
{
"name": string,
"displayId": integer,
"refreshRate": integer,
"state": enum ( |
Campi | |
---|---|
name |
Il nome del display. |
displayId |
ID display univoco. |
refreshRate |
Frequenza di aggiornamento del display in frame al secondo. |
state |
Stato del display. |
width |
Larghezza del display in pixel. |
height |
Altezza del display in pixel. |
density |
Compattezza visualizzazione espressa in 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 è in modalità sospensione a basso consumo |
SUSPENDED |
Il display è in modalità sospensione in uno stato di basso consumo. |
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 visualizzata dall'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 delle 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 come 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 applicazione. |
keyedAppStates[] |
Elenco degli stati dell'app con chiave segnalati dall'app. |
userFacingType |
Indica se l'app è rivolta agli utenti. |
ApplicationEvent
Un evento correlato a un'app.
Rappresentazione JSON |
---|
{
"eventType": enum ( |
Campi | |
---|---|
eventType |
Tipo di evento app. |
createTime |
L'ora di creazione dell'evento. Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
ApplicationEventType
Un tipo di evento correlato all'app.
Enum | |
---|---|
APPLICATION_EVENT_TYPE_UNSPECIFIED |
Questo valore non è consentito. |
INSTALLED |
L'app è stata installata. |
CHANGED |
L'app è stata modificata, ad esempio un componente è stato attivato o disattivato. |
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
L'origine che ha fornito un'app.
Enum | |
---|---|
APPLICATION_SOURCE_UNSPECIFIED |
L'app è stata caricata lateralmente da una fonte non specificata. |
SYSTEM_APP_FACTORY_VERSION |
Si tratta di un'app di sistema dell'immagine di fabbrica del dispositivo. |
SYSTEM_APP_UPDATED_VERSION |
Si tratta di 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. Funge da punto di riferimento per lo stato fornito dall'app. Ad esempio, quando fornisci un 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 valore specifico (ad es. un valore di configurazione gestita), questo deve essere incluso nel messaggio. |
data |
(Facoltativo) Un valore leggibile da computer da leggere da EMM. Ad esempio, impostando valori che l'amministratore può scegliere di interrogare nella console EMM (ad es. "comunicami se i dati battery_warning < 10"). |
createTime |
L'ora di creazione dello stato dell'app sul dispositivo. Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
lastUpdateTime |
L'ora dell'ultimo aggiornamento dello stato dell'app. Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". 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 le condizioni di errore reali che un'organizzazione di gestione deve correggere. |
UserFacingType
Indica se l'app è rivolta agli utenti.
Enum | |
---|---|
USER_FACING_TYPE_UNSPECIFIED |
Il tipo di utente 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 |
L'indirizzo MAC Wi-Fi del dispositivo. Ad esempio, |
networkOperatorName |
Nome alfabetico dell'operatore registrato attuale. Ad esempio, Vodafone. |
telephonyInfos[] |
Fornisce informazioni sulla telefonia associate a ogni scheda SIM sul dispositivo. Supportato solo sui dispositivi completamente gestiti a partire dal livello API Android 23. |
TelephonyInfo
Informazioni sulla telefonia associate a una determinata scheda SIM sul dispositivo. Supportato solo sui dispositivi completamente gestiti a partire dal livello API Android 23.
Rappresentazione JSON |
---|
{ "phoneNumber": string, "carrierName": string, "iccId": string, "activationState": enum ( |
Campi | |
---|---|
phoneNumber |
Il numero di telefono associato a questa scheda SIM. |
carrierName |
Il nome dell'operatore associato a questa scheda SIM. |
iccId |
Solo output. L'ICCID associato a questa scheda SIM. |
activationState |
Solo output. Stato di attivazione della scheda SIM sul dispositivo. Questo vale solo per le eSIM. Questa funzionalità è supportata su tutti i dispositivi per il livello API 35 e versioni successive. Questo valore è sempre |
configMode |
Solo output. La modalità di configurazione della scheda SIM sul dispositivo. Questo vale solo per le eSIM. Questa funzionalità è supportata su tutti i dispositivi per il livello API 35 e versioni successive. Questo valore è sempre |
ActivationState
Stato di attivazione della scheda SIM sul dispositivo.
Enum | |
---|---|
ACTIVATION_STATE_UNSPECIFIED |
Lo stato di attivazione non è specificato. |
ACTIVATED |
La scheda SIM è attivata. |
NOT_ACTIVATED |
La scheda SIM non è attivata. |
ConfigMode
La modalità di configurazione della scheda SIM sul dispositivo.
Enum | |
---|---|
CONFIG_MODE_UNSPECIFIED |
La modalità di configurazione non è specificata. |
ADMIN_CONFIGURED |
L'amministratore ha configurato questa SIM. |
USER_CONFIGURED |
L'utente ha configurato questa 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 |
Spazio di archiviazione interno totale sul dispositivo in byte. |
MemoryEvent
Un evento correlato alle misurazioni di memoria e 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. Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
byteCount |
Il numero di byte liberi nel supporto 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 segnalato è la capacità totale del supporto di archiviazione. |
EXTERNAL_STORAGE_REMOVED |
Un supporto di archiviazione esterno è stato rimosso. Il conteggio dei byte segnalato è 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. Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
batteryLevel |
Per gli 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 |
Il dispositivo ha iniziato a caricarsi. |
POWER_DISCONNECTED |
Il dispositivo ha smesso di caricarsi. |
BATTERY_LOW |
Il dispositivo è entrato in modalità a basso consumo. |
BATTERY_OKAY |
Il dispositivo non è più in modalità di risparmio energetico. |
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 lo stato 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. Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
batteryTemperatures[] |
Temperature attuali della batteria in gradi Celsius per ogni batteria del dispositivo. |
cpuTemperatures[] |
Le temperature attuali della CPU in gradi Celsius per ogni CPU sul dispositivo. |
gpuTemperatures[] |
Le temperature attuali della GPU in gradi Celsius per ogni GPU sul dispositivo. |
skinTemperatures[] |
Le temperature cutanee attuali del dispositivo in gradi Celsius. |
fanSpeeds[] |
Velocità della ventola in RPM per ogni ventola del dispositivo. Un array vuoto indica che non sono presenti ventole o che la velocità della ventola non è supportata sul sistema. |
cpuUsages[] |
Utilizzo della CPU in percentuale per ogni core disponibile sul dispositivo. L'utilizzo è pari a 0 per ogni core scollegato. Un array vuoto implica 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 |
Indica se il dispositivo è protetto con PIN/password. |
unknownSourcesEnabled |
Indica se è attivata l'installazione di app da origini sconosciute. |
developmentSettingsEnabled |
Indica se la modalità sviluppatore è attiva sul dispositivo. |
adbEnabled |
Indica se ADB è attivato sul dispositivo. |
isEncrypted |
Indica se la crittografia dello spazio di archiviazione è attivata. |
encryptionStatus |
Stato della crittografia da DevicePolicyManager. |
verifyAppsEnabled |
Se la verifica di Google Play Protect è applicata sul 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 è collegata al profilo utente. |
SecurityPosture
La security posture del dispositivo, determinata dallo stato attuale del dispositivo e dalle norme applicate.
Rappresentazione JSON |
---|
{ "devicePosture": enum ( |
Campi | |
---|---|
devicePosture |
Valore della postura di sicurezza del dispositivo. |
postureDetails[] |
Ulteriori dettagli sulla postura di sicurezza del dispositivo. |
DevicePosture
Possibili valori della postura di sicurezza di un dispositivo gestito.
Enum | |
---|---|
POSTURE_UNSPECIFIED |
Non specificato. Non sono presenti dettagli per questo valore di 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 compromesso e i dati aziendali potrebbero essere accessibili a malintenzionati non autorizzati. |
PostureDetail
Ulteriori dettagli sulla postura di sicurezza del dispositivo.
Rappresentazione JSON |
---|
{ "securityRisk": enum ( |
Campi | |
---|---|
securityRisk |
Un rischio per la sicurezza specifico che influisce negativamente sulla postura di sicurezza del dispositivo. |
advice[] |
Consigli corrispondenti rivolti agli amministratori per mitigare questo rischio per la sicurezza e migliorare la postura di sicurezza del dispositivo. |
SecurityRisk
Il rischio che impedisce al dispositivo di trovarsi 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 basicIntegrity non riesce). |
HARDWARE_BACKED_EVALUATION_FAILED |
L'API Play Integrity rileva che il dispositivo non offre una forte 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 nei Common Criteria for Information Technology Security Evaluation (CC).
Queste informazioni sono disponibili solo se statusReportingSettings.commonCriteriaModeEnabled
è true
nelle norme del dispositivo.
Rappresentazione JSON |
---|
{ "commonCriteriaModeStatus": enum ( |
Campi | |
---|---|
commonCriteriaModeStatus |
Se la modalità Common Criteria è attivata. |
policySignatureVerificationStatus |
Solo output. Lo stato della verifica della firma delle norme. |
CommonCriteriaModeStatus
Se la modalità Common Criteria è attivata.
Enum | |
---|---|
COMMON_CRITERIA_MODE_STATUS_UNKNOWN |
Stato sconosciuto. |
COMMON_CRITERIA_MODE_DISABLED |
La modalità Common Criteria è attualmente disattivata. |
COMMON_CRITERIA_MODE_ENABLED |
Al momento è attiva la modalità Common Criteria. |
PolicySignatureVerificationStatus
Lo stato della verifica della firma delle norme.
Enum | |
---|---|
POLICY_SIGNATURE_VERIFICATION_STATUS_UNSPECIFIED |
Non specificato. Lo stato della verifica non è stato segnalato. Questo valore viene impostato solo se è false. |
POLICY_SIGNATURE_VERIFICATION_DISABLED |
La verifica della firma del criterio è disattivata sul dispositivo perché è impostato su false. |
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED |
La verifica della firma della policy è riuscita. |
POLICY_SIGNATURE_VERIFICATION_NOT_SUPPORTED |
La verifica della firma dei criteri non è supportata, ad esempio perché il dispositivo è stato registrato con una versione di CloudDPC che non la supporta. |
POLICY_SIGNATURE_VERIFICATION_FAILED |
La verifica della firma della policy non è riuscita. La norma non è stata applicata. |
DpcMigrationInfo
Informazioni relative alla migrazione di questo dispositivo dalla gestione 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, questo è il nome del pacchetto. Altrimenti non viene compilato. |
additionalData |
Solo output. Se questo dispositivo è stato migrato da un altro DPC, il campo |
Metodi |
|
---|---|
|
Elimina un dispositivo. |
|
Recupera un dispositivo. |
|
Invia un comando a un dispositivo. |
|
Elenca i dispositivi per una determinata azienda. |
|
Aggiorna un dispositivo. |