REST Resource: enterprises.devices

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 (ManagementMode),
  "state": enum (DeviceState),
  "appliedState": enum (DeviceState),
  "policyCompliant": boolean,
  "nonComplianceDetails": [
    {
      object (NonComplianceDetail)
    }
  ],
  "enrollmentTime": string,
  "lastStatusReportTime": string,
  "lastPolicyComplianceReportTime": string,
  "lastPolicySyncTime": string,
  "policyName": string,
  "appliedPolicyName": string,
  "appliedPolicyVersion": string,
  "apiLevel": integer,
  "enrollmentTokenData": string,
  "enrollmentTokenName": string,
  "disabledReason": {
    object (UserFacingMessage)
  },
  "softwareInfo": {
    object (SoftwareInfo)
  },
  "hardwareInfo": {
    object (HardwareInfo)
  },
  "displays": [
    {
      object (Display)
    }
  ],
  "applicationReports": [
    {
      object (ApplicationReport)
    }
  ],
  "previousDeviceNames": [
    string
  ],
  "networkInfo": {
    object (NetworkInfo)
  },
  "memoryInfo": {
    object (MemoryInfo)
  },
  "memoryEvents": [
    {
      object (MemoryEvent)
    }
  ],
  "powerManagementEvents": [
    {
      object (PowerManagementEvent)
    }
  ],
  "hardwareStatusSamples": [
    {
      object (HardwareStatus)
    }
  ],
  "deviceSettings": {
    object (DeviceSettings)
  },
  "user": {
    object (User)
  },
  "systemProperties": {
    string: string,
    ...
  },
  "securityPosture": {
    object (SecurityPosture)
  },
  "ownership": enum (Ownership),
  "commonCriteriaModeInfo": {
    object (CommonCriteriaModeInfo)
  },
  "appliedPasswordPolicies": [
    {
      object (PasswordRequirements)
    }
  ],
  "dpcMigrationInfo": {
    object (DpcMigrationInfo)
  }
}
Campi
name

string

Il nome del dispositivo nel formato enterprises/{enterpriseId}/devices/{deviceId}.
userName

string

Il nome della risorsa dell'utente proprietario di questo dispositivo nel formato enterprises/{enterpriseId}/users/{userId}.
managementMode

enum (ManagementMode)

Il tipo di modalità di gestione che Android Device Policy assume sul dispositivo. Ciò influisce sulle impostazioni dei criteri supportate.
state

enum (DeviceState)

Lo stato da applicare al dispositivo. Questo campo può essere modificato da una richiesta di patch. Tieni presente che quando chiami enterprises.devices.patch, ACTIVE e DISABLED sono gli unici valori consentiti. Per impostare il dispositivo nello stato DELETED, chiama enterprises.devices.delete.
appliedState

enum (DeviceState)

Lo stato attualmente applicato al dispositivo.
policyCompliant

boolean

Se il dispositivo è conforme ai suoi criteri.
nonComplianceDetails[]

object (NonComplianceDetail)

Dettagli sulle impostazioni dei criteri con cui il dispositivo non è conforme.
enrollmentTime

string (Timestamp format)

La data e l'ora di registrazione del dispositivo.

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
lastStatusReportTime

string (Timestamp format)

L'ultima volta che il dispositivo ha inviato un report sullo stato.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

Deprecato.

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
lastPolicySyncTime

string (Timestamp format)

L'ultima volta che il dispositivo ha recuperato il criterio.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
policyName

string

Il nome del criterio applicato al dispositivo, nel formato enterprises/{enterpriseId}/policies/{policyId}. Se non specificato, viene applicato il policyName per l'utente del dispositivo. Questo campo può essere modificato da una richiesta di patch. Puoi specificare solo policyId quando chiami enterprises.devices.patch, purché policyId non contenga barre. Il resto del nome del criterio viene dedotto.
appliedPolicyName

string

Il nome del criterio attualmente applicato al dispositivo.
appliedPolicyVersion

string (int64 format)

La versione del criterio attualmente applicata al dispositivo.
apiLevel

integer

Il livello API della versione della piattaforma Android in esecuzione sul dispositivo.
enrollmentTokenData

string

Se il dispositivo è stato registrato con un token di registrazione con dati aggiuntivi forniti, questo campo li contiene.
enrollmentTokenName

string

Se il dispositivo è stato registrato con un token di registrazione, questo campo contiene il nome del token.
disabledReason

object (UserFacingMessage)

Se lo stato del dispositivo è DISABLED, un messaggio facoltativo visualizzato sul dispositivo che indica il motivo della disattivazione. Questo campo può essere modificato da una richiesta di patch.
softwareInfo

object (SoftwareInfo)

Informazioni dettagliate sul software del dispositivo. Queste informazioni sono disponibili solo se softwareInfoEnabled è true nel criterio del dispositivo.
hardwareInfo

object (HardwareInfo)

Informazioni dettagliate sull'hardware del dispositivo.
displays[]

object (Display)

Informazioni dettagliate sui display del dispositivo. Queste informazioni sono disponibili solo se displayInfoEnabled è true nel criterio del dispositivo.
applicationReports[]

object (ApplicationReport)

Report relativi alle app installate sul dispositivo. Queste informazioni sono disponibili soltanto quando il valore applicationReportsEnabled è impostato su true nei criteri del dispositivo.
previousDeviceNames[]

string

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 si è già registrato in precedenza. I nomi sono in ordine cronologico.
networkInfo

object (NetworkInfo)

Informazioni sulla rete del dispositivo. Queste informazioni sono disponibili solo se networkInfoEnabled è true nel criterio del dispositivo.
memoryInfo

object (MemoryInfo)

Informazioni sulla memoria: contiene informazioni sulla memoria e sullo spazio di archiviazione del dispositivo.
memoryEvents[]

object (MemoryEvent)

Eventi relativi alle misurazioni di memoria e spazio di archiviazione in ordine cronologico. Queste informazioni sono disponibili solo se memoryInfoEnabled è true nel criterio del dispositivo.

Gli eventi vengono conservati per un determinato periodo di tempo e quelli vecchi vengono eliminati.
powerManagementEvents[]

object (PowerManagementEvent)

Eventi di gestione dell'alimentazione sul dispositivo in ordine cronologico. Queste informazioni sono disponibili solo se powerManagementEventsEnabled è true nel criterio del dispositivo.
hardwareStatusSamples[]

object (HardwareStatus)

Esempi di stato dell'hardware in ordine cronologico. Queste informazioni sono disponibili soltanto se il valore hardwareStatusEnabled è impostato su true nei criteri del dispositivo.
deviceSettings

object (DeviceSettings)

Informazioni sulle impostazioni del dispositivo. Queste informazioni sono disponibili solo se deviceSettingsEnabled è true nel criterio del dispositivo.
user

object (User)

L'utente proprietario del dispositivo.
systemProperties

map (key: string, value: string)

Mappa del nome e del valore delle proprietà di sistema selezionate relative al dispositivo. Queste informazioni sono disponibili solo se systemPropertiesEnabled è true nel criterio del dispositivo.

Un oggetto contenente un elenco di "key": value coppie. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
securityPosture

object (SecurityPosture)

Il valore della posizione di sicurezza del dispositivo che riflette il livello di sicurezza del dispositivo.
ownership

enum (Ownership)

La proprietà del dispositivo gestito.
commonCriteriaModeInfo

object (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 nei criteri del dispositivo e il dispositivo è di proprietà dell'azienda.
appliedPasswordPolicies[]

object (PasswordRequirements)

I requisiti per le password attualmente applicati al dispositivo.

  • In alcuni casi, i requisiti applicati potrebbero essere leggermente diversi da quelli specificati in passwordPolicies.
  • fieldPath è impostato in base a passwordPolicies.
dpcMigrationInfo

object (DpcMigrationInfo)

Solo output. Informazioni relative al fatto che la migrazione di questo dispositivo sia avvenuta da 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 sullo stato finale quando il dispositivo conferma l'eliminazione. Se il dispositivo viene eliminato tramite la chiamata all'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 si trovano 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 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 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 delle norme.

Rappresentazione JSON 
{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string,
  "fieldPath": string,
  "currentValue": value,
  "installationFailureReason": enum (InstallationFailureReason),
  "specificNonComplianceReason": enum (SpecificNonComplianceReason),
  "specificNonComplianceContext": {
    object (SpecificNonComplianceContext)
  }
}
Campi
settingName

string

Il nome dell'impostazione del criterio. Si tratta del nome del campo JSON di un campo Policy di primo livello.
nonComplianceReason

enum (NonComplianceReason)

Il motivo per cui il dispositivo non è conforme all'impostazione.
packageName

string

Il nome del pacchetto che indica quale app non è conforme, se applicabile.
fieldPath

string

Per le impostazioni con campi nidificati, se un determinato campo nidificato non è conforme, verrà specificato il percorso completo del campo in questione. Il percorso viene 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 url nel campo externalData nella terza applicazione, il percorso sarà applications[2].externalData.url
currentValue

value (Value format)

Se non è stato possibile applicare l'impostazione del criterio, il valore corrente dell'impostazione sul dispositivo.
installationFailureReason

enum (InstallationFailureReason)

Se packageName è impostato e il motivo della mancata conformità è APP_NOT_INSTALLED o APP_NOT_UPDATED, il motivo dettagliato per cui l'app non può essere installata o aggiornata.
specificNonComplianceReason

enum (SpecificNonComplianceReason)

Il motivo specifico del criterio per cui il dispositivo non è conforme all'impostazione.
specificNonComplianceContext

object (SpecificNonComplianceContext)

Contesto aggiuntivo per specificNonComplianceReason.

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. Alcuni potenziali motivi sono che il dispositivo non dispone di spazio di archiviazione sufficiente, la connessione di rete del dispositivo non è affidabile o l'installazione sta impiegando più tempo del previsto. L'installazione verrà ritentata automaticamente.
IN_PROGRESS L'installazione è ancora in corso.
NOT_FOUND L'app non è stata trovata in 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 o l'amministratore non ha accettato i Termini di servizio più recenti della versione gestita di Google Play.
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 si verifica un problema di configurazione di rete. Assicurati che il dispositivo abbia accesso alla connettività a internet completa su una rete che soddisfi i requisiti di Android Enterprise Network Requirements. In questo caso, l'installazione o l'aggiornamento delle app riprenderà automaticamente.
INSUFFICIENT_STORAGE Lo spazio di archiviazione sul dispositivo dell'utente non è sufficiente per installare l'app. Il problema può essere risolto 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 di criteri. In futuro è possibile aggiungere nuovi valori all'enum.

Enum
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED Il motivo specifico della mancata conformità non è specificato. I campi in specificNonComplianceContext non sono impostati.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED L'utente deve confermare le credenziali inserendo il blocco schermo. I campi in specificNonComplianceContext non sono impostati. L'opzione nonComplianceReason è impostata su USER_ACTION.
PASSWORD_POLICIES_PASSWORD_EXPIRED La password del dispositivo o del profilo è scaduta. L'opzione passwordPoliciesContext è impostata. L'opzione nonComplianceReason è impostata su USER_ACTION.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT La password del dispositivo non soddisfa i requisiti. passwordPoliciesContext impostato. nonComplianceReason impostata su USER_ACTION.
ONC_WIFI_INVALID_VALUE Nella configurazione Wi-Fi ONC è presente un valore errato. fieldPath specifica il valore del campo errato. oncWifiContext impostato. L'opzione nonComplianceReason è impostata su INVALID_VALUE.
ONC_WIFI_API_LEVEL L'impostazione Wi-Fi ONC non è supportata nel livello API della versione di Android in esecuzione sul dispositivo. fieldPath specifica il valore del campo non supportato. L'opzione oncWifiContext è impostata. L'opzione nonComplianceReason è impostata su API_LEVEL.
ONC_WIFI_INVALID_ENTERPRISE_CONFIG Nella rete Wi-Fi aziendale manca la CA principale o il nome di dominio. L'opzione nonComplianceReason è impostata su INVALID_VALUE.
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK L'utente deve rimuovere manualmente la rete Wi-Fi configurata. Questo vale solo per i profili di lavoro sui dispositivi di proprietà personale. L'opzione nonComplianceReason è impostata su USER_ACTION.
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY L'alias della coppia di chiavi specificato tramite il campo ClientCertKeyPairAlias in openNetworkConfiguration non corrisponde a una chiave esistente installata sul dispositivo. L'opzione nonComplianceReason è impostata su INVALID_VALUE.

SpecificNonComplianceContext

Contesto aggiuntivo per SpecificNonComplianceReason.

Rappresentazione JSON 
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  }
}
Campi
oncWifiContext

object (OncWifiContext)

Contesto aggiuntivo per la non conformità in relazione alla configurazione Wi-Fi. Vedi ONC_WIFI_INVALID_VALUE e ONC_WIFI_API_LEVEL
passwordPoliciesContext

object (PasswordPoliciesContext)

Contesto aggiuntivo per la mancata conformità ai criteri relativi alle password. Consulta i PASSWORD_POLICIES_PASSWORD_EXPIRED e le PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT.

OncWifiContext

Contesto aggiuntivo per la non conformità in relazione alla configurazione Wi-Fi.

Rappresentazione JSON 
{
  "wifiGuid": string
}
Campi
wifiGuid

string

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 (PasswordPolicyScope)
}
Campi
passwordPolicyScope

enum (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 (SystemUpdateInfo)
  }
}
Campi
androidVersion

string

La stringa della versione di Android visibile dall'utente. Ad esempio, 6.0.1.
androidDevicePolicyVersionCode

integer

Il codice di versione dell'app Android Device Policy.
androidDevicePolicyVersionName

string

La versione dell'app Android Device Policy mostrata all'utente.
androidBuildNumber

string

Stringa dell'ID build Android da mostrare all'utente. Ad esempio, shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys.
deviceKernelVersion

string

Versione kernel, ad esempio 2.6.32.9-g103d848.
bootloaderVersion

string

Il numero di versione del bootloader di sistema, ad esempio 0.6.7.
androidBuildTime

string (Timestamp format)

Tempo di compilazione.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
securityPatchLevel

string

Livello patch di sicurezza, ad esempio 2016-05-01.
primaryLanguageCode

string

Un codice lingua IETF BCP 47 per le impostazioni internazionali principali del dispositivo.
deviceBuildSignature

string

Hash SHA-256 di android.content.pm.Signature associato al pacchetto di sistema, che può essere utilizzato per verificare che la build di sistema non sia stata modificata.
systemUpdateInfo

object (SystemUpdateInfo)

Informazioni su un potenziale aggiornamento di sistema in attesa.

SystemUpdateInfo

Informazioni su un potenziale aggiornamento di sistema in attesa.

Rappresentazione JSON 
{
  "updateStatus": enum (UpdateStatus),
  "updateReceivedTime": string
}
Campi
updateStatus

enum (UpdateStatus)

Lo stato di un aggiornamento: se esiste un aggiornamento e di che tipo.
updateReceivedTime

string (Timestamp format)

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 updateStatus non è né UPDATE_STATUS_UNKNOWN né UP_TO_DATE).

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

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 sono disponibili aggiornamenti 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 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

string

Brand del dispositivo. Ad esempio, Google.
hardware

string

Nome dell'hardware. Ad esempio, Angler.
deviceBasebandVersion

string

Versione banda di base. Ad esempio, MDM9625_104662.22.05.34p.
manufacturer

string

Produttore. Ad esempio, Motorola.
serialNumber

string

Il numero di serie del dispositivo.
model

string

Il modello del dispositivo. Ad esempio, Asus Nexus 7.
batteryShutdownTemperatures[]

number

Soglie di temperatura di spegnimento della batteria in gradi Celsius per ogni batteria del dispositivo.
batteryThrottlingTemperatures[]

number

Soglie di temperatura per il throttling della batteria in gradi Celsius per ogni batteria del dispositivo.
cpuShutdownTemperatures[]

number

Soglie di temperatura di arresto della CPU in Celsius per ogni CPU sul dispositivo.
cpuThrottlingTemperatures[]

number

Soglie di temperatura per la limitazione della CPU in Celsius per ogni CPU sul dispositivo.
gpuShutdownTemperatures[]

number

Soglie di temperatura di arresto della GPU in Celsius per ogni GPU sul dispositivo.
gpuThrottlingTemperatures[]

number

Soglie di temperatura per il throttling della GPU in gradi Celsius per ogni GPU sul dispositivo.
skinShutdownTemperatures[]

number

Soglie di temperatura di spegnimento del corpo del dispositivo in gradi Celsius.
skinThrottlingTemperatures[]

number

Soglie di temperatura per la limitazione della pelle del dispositivo in gradi Celsius.
enterpriseSpecificId

string

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 sul display del dispositivo.

Rappresentazione JSON 
{
  "name": string,
  "displayId": integer,
  "refreshRate": integer,
  "state": enum (DisplayState),
  "width": integer,
  "height": integer,
  "density": integer
}
Campi
name

string

Nome del display.
displayId

integer

ID display univoco.
refreshRate

integer

Frequenza di aggiornamento del display in frame al secondo.
state

enum (DisplayState)

Stato del display.
width

integer

Larghezza del display in pixel.
height

integer

Altezza del display in pixel.
density

integer

Compattezza visualizzazione espressa in punti per pollice.

DisplayState

Lo stato di una visualizzazione.

Enum
DISPLAY_STATE_UNSPECIFIED Questo valore non è consentito.
OFF Il display è spento.
ON Il display è attivo.
DOZE Il display è inattivo in stato di basso consumo
SUSPENDED Il display è in modalità sospensione in uno stato di basso consumo.

ApplicationReport

Sono state segnalate informazioni su un'app installata.

Rappresentazione JSON 
{
  "packageName": string,
  "versionName": string,
  "versionCode": integer,
  "events": [
    {
      object (ApplicationEvent)
    }
  ],
  "displayName": string,
  "packageSha256Hash": string,
  "signingKeyCertFingerprints": [
    string
  ],
  "installerPackageName": string,
  "applicationSource": enum (ApplicationSource),
  "state": enum (ApplicationState),
  "keyedAppStates": [
    {
      object (KeyedAppState)
    }
  ],
  "userFacingType": enum (UserFacingType)
}
Campi
packageName

string

Nome del pacchetto dell'app.
versionName

string

La versione dell'app mostrata all'utente.
versionCode

integer

Il codice di versione dell'app, che può essere utilizzato per determinare se una versione è più recente di un'altra.
events[]

object (ApplicationEvent)

L'elenco di eventi app che si sono verificati nelle ultime 30 ore.
displayName

string

Il nome visualizzato dell'app.
packageSha256Hash

string

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 numero esadecimale a due cifre.
signingKeyCertFingerprints[]

string

L'hash SHA-1 di ogni android.content.pm.Signature associato al pacchetto dell'app. Ogni byte di ogni valore hash è rappresentato come un numero esadecimale a due cifre.
installerPackageName

string

Il nome del pacchetto dell'app che ha installato questa app.
applicationSource

enum (ApplicationSource)

L'origine del pacchetto.
state

enum (ApplicationState)

Stato dell'applicazione.
keyedAppStates[]

object (KeyedAppState)

Elenco degli stati delle app con chiave segnalati dall'app.
userFacingType

enum (UserFacingType)

Indica se l'app è rivolta agli utenti.

ApplicationEvent

Un evento relativo all'app.

Rappresentazione JSON 
{
  "eventType": enum (ApplicationEventType),
  "createTime": string
}
Campi
eventType

enum (ApplicationEventType)

Tipo di evento app.
createTime

string (Timestamp format)

La data e l'ora di creazione dell'evento.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

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 è 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 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 installata tramite sideload 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 (Severity),
  "message": string,
  "data": string,
  "createTime": string,
  "lastUpdateTime": string
}
Campi
key

string

La chiave per lo stato dell'app. Agisce come 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

enum (Severity)

La gravità dello stato dell'app.
message

string

(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 gestito), deve essere incluso nel messaggio.
data

string

Facoltativamente, un valore leggibile da una macchina da leggere dall'EMM. Ad esempio, impostando i valori su cui l'amministratore può scegliere di eseguire query nella console EMM (ad es. "Avvisa se i dati di battery_warning sono < 10").
createTime

string (Timestamp format)

La data e l'ora di creazione dello stato dell'app sul dispositivo.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
lastUpdateTime

string (Timestamp format)

L'ora dell'ultimo aggiornamento dello stato dell'app.

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

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 richiedono l'intervento di un'organizzazione di gestione per la correzione.

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 (TelephonyInfo)
    }
  ]
}
Campi
imei

string

Numero IMEI del dispositivo GSM. Ad esempio, A1000031212.
meid

string

Numero MEID del dispositivo CDMA. Ad esempio, A00000292788E1.
wifiMacAddress

string

L'indirizzo MAC Wi-Fi del dispositivo. Ad esempio, 7c:11:11:11:11:11.
networkOperatorName
(deprecated)

string

Nome alfabetico dell'operatore registrato attuale. ad esempio Vodafone.
telephonyInfos[]

object (TelephonyInfo)

Fornisce informazioni di telefonia associate a ogni scheda SIM del dispositivo. Supportato 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 su dispositivi completamente gestiti a partire dal livello API Android 23.

Rappresentazione JSON 
{
  "phoneNumber": string,
  "carrierName": string,
  "iccId": string
}
Campi
phoneNumber

string

Il numero di telefono associato a questa scheda SIM.
carrierName

string

Il nome dell'operatore associato a questa scheda SIM.
iccId

string

Solo output. L'ICCID associato a questa scheda SIM.

MemoryInfo

Informazioni sulla memoria e sullo spazio di archiviazione del dispositivo.

Rappresentazione JSON 
{
  "totalRam": string,
  "totalInternalStorage": string
}
Campi
totalRam

string (int64 format)

RAM totale sul dispositivo in byte.
totalInternalStorage

string (int64 format)

Memoria interna totale sul dispositivo in byte.

MemoryEvent

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 (MemoryEventType),
  "createTime": string,
  "byteCount": string
}
Campi
eventType

enum (MemoryEventType)

Tipo di evento.
createTime

string (Timestamp format)

La data e l'ora di creazione dell'evento.

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
byteCount

string (int64 format)

Il numero di byte liberi nel supporto o, per EXTERNAL_STORAGE_DETECTED, la capacità totale in byte del supporto di archiviazione.

MemoryEventType

Il tipo di evento.

Enum
MEMORY_EVENT_TYPE_UNSPECIFIED Non specificato. Nessun evento di 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 registrato corrisponde alla capacità totale del supporto di archiviazione.
EXTERNAL_STORAGE_REMOVED È stato rimosso un supporto di archiviazione esterno. Il numero di byte registrato è 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 (PowerManagementEventType),
  "createTime": string,
  "batteryLevel": number
}
Campi
eventType

enum (PowerManagementEventType)

Tipo di evento.
createTime

string (Timestamp format)

La data e l'ora di creazione dell'evento.

Un timestamp in formato "Zulu" UTC RFC3339, con risoluzione a livello di nanosecondo e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
batteryLevel

number

Per eventi BATTERY_LEVEL_COLLECTED, il livello della batteria in percentuale.

PowerManagementEventType

Il tipo di evento.

Enum
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED Non specificato. Nessun evento di questo tipo.
BATTERY_LEVEL_COLLECTED È stato misurato il livello della batteria.
POWER_CONNECTED Il dispositivo ha iniziato a caricarsi.
POWER_DISCONNECTED La ricarica del dispositivo si è 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 è 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 di salute dell'hardware.

Rappresentazione JSON 
{
  "createTime": string,
  "batteryTemperatures": [
    number
  ],
  "cpuTemperatures": [
    number
  ],
  "gpuTemperatures": [
    number
  ],
  "skinTemperatures": [
    number
  ],
  "fanSpeeds": [
    number
  ],
  "cpuUsages": [
    number
  ]
}
Campi
createTime

string (Timestamp format)

L'ora in cui sono state effettuate le misurazioni.

Un timestamp nel formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
batteryTemperatures[]

number

Temperature attuali della batteria in gradi Celsius per ogni batteria del dispositivo.
cpuTemperatures[]

number

Temperature attuali della CPU in gradi Celsius per ogni CPU del dispositivo.
gpuTemperatures[]

number

Temperature attuali della GPU in gradi Celsius per ogni GPU sul dispositivo.
skinTemperatures[]

number

Temperature cutanee attuali del dispositivo in gradi Celsius.
fanSpeeds[]

number

Velocità della ventola in RPM per ogni ventola del dispositivo. Un array vuoto indica che non sono presenti ventole o che la velocità delle ventole non è supportata dal sistema.
cpuUsages[]

number

Utilizzi 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 del dispositivo relative alla sicurezza.

Rappresentazione JSON 
{
  "isDeviceSecure": boolean,
  "unknownSourcesEnabled": boolean,
  "developmentSettingsEnabled": boolean,
  "adbEnabled": boolean,
  "isEncrypted": boolean,
  "encryptionStatus": enum (EncryptionStatus),
  "verifyAppsEnabled": boolean
}
Campi
isDeviceSecure

boolean

Indica se il dispositivo è protetto con PIN/password.
unknownSourcesEnabled

boolean

Indica se l'installazione di app da origini sconosciute è attivata.
developmentSettingsEnabled

boolean

Indica se la modalità sviluppatore è attivata sul dispositivo.
adbEnabled

boolean

Indica se ADB è attivo sul dispositivo.
isEncrypted

boolean

Indica se la crittografia dello spazio di archiviazione è attivata.
encryptionStatus

enum (EncryptionStatus)

Stato della crittografia da DevicePolicyManager.
verifyAppsEnabled

boolean

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 è 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 è associata al profilo utente.

SecurityPosture

La posizione di sicurezza del dispositivo, determinata dallo stato attuale del dispositivo e dai criteri applicati.

Rappresentazione JSON 
{
  "devicePosture": enum (DevicePosture),
  "postureDetails": [
    {
      object (PostureDetail)
    }
  ]
}
Campi
devicePosture

enum (DevicePosture)

Valore della posizione di sicurezza del dispositivo.
postureDetails[]

object (PostureDetail)

Ulteriori dettagli sulla postura di sicurezza del dispositivo.

DevicePosture

Possibili valori della posizione di sicurezza di un dispositivo gestito.

Enum
POSTURE_UNSPECIFIED Non specificato. Non sono disponibili dettagli sulla postura per questo valore.
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 soggetti non autorizzati.

PostureDetail

Ulteriori dettagli sulla postura di sicurezza del dispositivo.

Rappresentazione JSON 
{
  "securityRisk": enum (SecurityRisk),
  "advice": [
    {
      object (UserFacingMessage)
    }
  ]
}
Campi
securityRisk

enum (SecurityRisk)

Un rischio per la sicurezza specifico che influisce negativamente sulla postura di sicurezza del dispositivo.
advice[]

object (UserFacingMessage)

Consigli per gli amministratori corrispondenti per mitigare questo rischio per la sicurezza e migliorare la postura 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 di integrità di base va a buon fine, 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 garanzia solida dell'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 statusReportingSettings.commonCriteriaModeEnabled è true nel criterio del dispositivo.

Rappresentazione JSON 
{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus),
  "policySignatureVerificationStatus": enum (PolicySignatureVerificationStatus)
}
Campi
commonCriteriaModeStatus

enum (CommonCriteriaModeStatus)

Indica se la modalità Common Criteria è attivata.
policySignatureVerificationStatus

enum (PolicySignatureVerificationStatus)

Solo output. Lo stato della verifica della firma delle norme.

CommonCriteriaModeStatus

Indica 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. Non è stato segnalato lo stato della verifica. Viene impostato solo se statusReportingSettings.commonCriteriaModeEnabled è falso.
POLICY_SIGNATURE_VERIFICATION_DISABLED La verifica della firma dei criteri è disattivata sul dispositivo perché il criterio commonCriteriaMode è impostato su false.
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED La verifica della firma dei criteri è 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 supporta la verifica della firma dei criteri.
POLICY_SIGNATURE_VERIFICATION_FAILED La verifica della firma del criterio non è riuscita. Il criterio non è stato applicato.

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

string

Solo output. Se la migrazione di questo dispositivo è stata eseguita da un altro DPC, questo è il nome del pacchetto. Non compilato in caso contrario.
additionalData

string

Solo output. Se per questo dispositivo è stata eseguita la migrazione da un altro DPC, il campo additionalData del token di migrazione viene compilato qui.

Metodi

delete

 Elimina un dispositivo.

get

 Recupera un dispositivo.

issueCommand

 Invia un comando a un dispositivo.

list

 Elenca i dispositivi di una determinata azienda.

patch

 Aggiorna un dispositivo.