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 utilizzata da Android Device Policy sul dispositivo. Questo 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 attivare lo stato DELETED del dispositivo, chiama enterprises.devices.delete.
appliedState

enum (DeviceState)

Lo stato attualmente applicato al dispositivo.
policyCompliant

boolean

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

object (NonComplianceDetail)

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

string (Timestamp format)

L'ora della registrazione dei dispositivi.

Un timestamp in 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 di stato.

Un timestamp in 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".
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

Deprecato.

Un timestamp in 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" 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".
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 il policyId quando chiami enterprises.devices.patch, a condizione che 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 e sono stati forniti dati aggiuntivi, questo campo contiene quei dati.
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, sul dispositivo viene visualizzato un messaggio facoltativo 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. Questa informazione è disponibile solo se softwareInfoEnabled è true nei criteri del dispositivo.
hardwareInfo

object (HardwareInfo)

Informazioni dettagliate sull'hardware del dispositivo.
displays[]

object (Display)

Informazioni dettagliate sui display sul dispositivo. Questa informazione è disponibile solo se displayInfoEnabled è true nei criteri del dispositivo.
applicationReports[]

object (ApplicationReport)

Report per app installate sul dispositivo. Queste informazioni sono disponibili soltanto se applicationReportsEnabled è true nei criteri del dispositivo.
previousDeviceNames[]

string

Se lo stesso dispositivo fisico è stato registrato più volte, questo campo contiene i nomi dei dispositivi precedenti. Il numero di serie viene utilizzato come identificatore univoco per determinare se lo stesso dispositivo fisico è stato registrato in precedenza. I nomi sono in ordine cronologico.
networkInfo

object (NetworkInfo)

Informazioni sulla rete del dispositivo. Questa informazione è disponibile solo se networkInfoEnabled è true nei criteri 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. Questa informazione è disponibile solo se memoryInfoEnabled è true nei criteri 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. Questa informazione è disponibile solo se powerManagementEventsEnabled è true nei criteri del dispositivo.
hardwareStatusSamples[]

object (HardwareStatus)

Esempi di stato hardware in ordine cronologico. Questa informazione è disponibile solo se hardwareStatusEnabled è true nei criteri del dispositivo.
deviceSettings

object (DeviceSettings)

Informazioni sulle impostazioni del dispositivo. Questa informazione è disponibile solo se deviceSettingsEnabled è true nei criteri 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. Questa informazione è disponibile solo se systemPropertiesEnabled è true nei criteri 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 strategia di sicurezza del dispositivo, che riflette il suo livello di sicurezza.
ownership

enum (Ownership)

Proprietà del dispositivo gestito.
commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

Informazioni sulla modalità Common Criteria: standard di sicurezza definiti nel documento Common Criteria for Information Technology Security Evaluation (CC).

Queste informazioni sono disponibili solo se statusReportingSettings.commonCriteriaModeEnabled è true nei criteri del dispositivo.
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 che indicano se è stata eseguita la migrazione di questo dispositivo affinché non sia più gestito da un altro controller dei criteri dei dispositivi (DPC).

DeviceState

Stati che possono essere applicati a un dispositivo.

Enum
DEVICE_STATE_UNSPECIFIED Questo valore non è consentito.
ACTIVE Il dispositivo è attivo.
DISABLED Il dispositivo è disattivato.
DELETED Il dispositivo è stato eliminato. Questo stato non viene mai restituito da una chiamata API, ma viene utilizzato nel report dello stato finale quando il dispositivo conferma l'eliminazione. Se il dispositivo viene eliminato tramite la chiamata API, questo stato viene pubblicato in Pub/Sub. Se l'utente elimina il profilo di lavoro o reimposta il dispositivo, lo stato del dispositivo rimarrà sconosciuto al server.
PROVISIONING È in corso il provisioning del dispositivo. I dispositivi appena registrati rimangono in questo stato finché non viene applicato un criterio.
LOST Il dispositivo è stato smarrito. Questo stato è possibile solo sui dispositivi di proprietà dell'organizzazione.
PREPARING_FOR_MIGRATION Il dispositivo è in fase di preparazione per la migrazione all'API Android Management. Non sono necessarie ulteriori azioni per continuare la migrazione.

NonComplianceDetail

Fornisce dettagli sulla non conformità a un'impostazione dei criteri.

Rappresentazione JSON 
{
  "settingName": string,
  "nonComplianceReason": enum (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 di un 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 particolare campo nidificato non è conforme, viene specificato il percorso completo del campo in questione. La formattazione del percorso è la stessa del campo JSON del criterio a cui fa riferimento in JavaScript, ovvero: 1) Per i campi di tipo oggetto, il nome del campo è seguito da un punto e poi da un nome di sottocampo. 2) Per i campi di tipo array, il nome del campo è seguito dall'indice dell'array racchiuso tra parentesi. Ad esempio, per indicare un problema con il campo url nel campo externalData della terza applicazione, il percorso sarà applications[2].externalData.url
currentValue

value (Value format)

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

enum (InstallationFailureReason)

Se il criterio packageName è impostato e il motivo della non conformità è APP_NOT_INSTALLED o APP_NOT_UPDATED, il motivo dettagliato per cui non è possibile installare o aggiornare l'app.
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. Ecco alcuni potenziali motivi: lo spazio di archiviazione sul dispositivo non è sufficiente, la connessione di rete del dispositivo è inaffidabile o l'installazione sta richiedendo più tempo del previsto. L'installazione verrà ritentata automaticamente.
IN_PROGRESS L'installazione è ancora in corso.
NOT_FOUND App non trovata in Google Play.
NOT_COMPATIBLE_WITH_DEVICE L'app non è compatibile con il dispositivo.
NOT_APPROVED L'app non è stata approvata dall'amministratore.
PERMISSIONS_NOT_ACCEPTED L'app ha nuove autorizzazioni che non sono state accettate dall'amministratore.
NOT_AVAILABLE_IN_COUNTRY Lʼapp non è disponibile nel paese in cui risiedono gli utenti.
NO_LICENSES_REMAINING Non sono disponibili licenze da assegnare all'utente.
NOT_ENROLLED L'azienda non è più registrata alla versione gestita di Google Play oppure l'amministratore non ha accettato i Termini di servizio della versione gestita di Google Play più recenti.
USER_INVALID L'utente non è più valido. L'utente potrebbe essere stato eliminato o disattivato.
NETWORK_ERROR_UNRELIABLE_CONNECTION

Un errore di rete sul dispositivo dell'utente ha impedito il completamento dell'installazione. Questo accade solitamente quando la connettività internet del dispositivo è ridotta, non disponibile o si verifica un problema di configurazione della rete. Assicurati che il dispositivo abbia accesso alla connettività internet completa su una rete conforme a Android Enterprise Network Requirements. L'installazione o l'aggiornamento delle app riprenderà automaticamente al momento opportuno.
INSUFFICIENT_STORAGE Sul dispositivo dell'utente non è disponibile spazio di archiviazione sufficiente per installare l'app. Per risolvere il problema, libera spazio di archiviazione sul dispositivo. L'installazione o l'aggiornamento delle app riprenderà automaticamente quando lo spazio di archiviazione sul dispositivo sarà sufficiente.

SpecificNonComplianceReason

Maggiori dettagli sul motivo per cui un dispositivo potrebbe non essere conforme a un'impostazione dei criteri. In futuro sarà possibile aggiungere nuovi valori all'enum.

Enum
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED Il motivo specifico della non conformità non è stato specificato. I campi in 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. nonComplianceReason è impostato su USER_ACTION.
PASSWORD_POLICIES_PASSWORD_EXPIRED La password del dispositivo o del profilo è scaduta. Impostazione passwordPoliciesContext impostata. nonComplianceReason è impostato su USER_ACTION.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT La password del dispositivo non soddisfa i requisiti per le password. Impostazione passwordPoliciesContext impostata. nonComplianceReason è impostato su USER_ACTION.
ONC_WIFI_INVALID_VALUE È presente un valore errato nella configurazione Wi-Fi ONC. fieldPath specifica il valore del campo errato. Impostazione oncWifiContext impostata. nonComplianceReason è impostato 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. Impostazione oncWifiContext impostata. nonComplianceReason è impostato su API_LEVEL.
ONC_WIFI_INVALID_ENTERPRISE_CONFIG Nella rete Wi-Fi aziendale manca l'autorità di certificazione principale o il nome di dominio. nonComplianceReason è impostato 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 su dispositivi di proprietà personale. nonComplianceReason è impostato 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. nonComplianceReason è impostato 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à relativa alla configurazione Wi-Fi. Vedi ONC_WIFI_INVALID_VALUE e ONC_WIFI_API_LEVEL
passwordPoliciesContext

object (PasswordPoliciesContext)

Contesto aggiuntivo per la non conformità relativa ai criteri relativi alle password. Leggi i PASSWORD_POLICIES_PASSWORD_EXPIRED e le PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT.

OncWifiContext

Contesto aggiuntivo per la non conformità relativa 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à relativa 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 di versione di Android visibile all'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 ID build Android da mostrare all'utente. Ad esempio, shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys.
deviceKernelVersion

string

Versione del 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)

Ora della creazione.

Un timestamp in 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".
securityPatchLevel

string

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

string

Un codice lingua IETF BCP 47 per l'impostazione internazionale principale sul 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 del 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)

La data e l'ora in cui l'aggiornamento è stato disponibile per la prima volta. Un valore pari a zero indica che questo campo non è impostato. Questo campo viene impostato solo se è disponibile un aggiornamento, ovvero updateStatus non è né UPDATE_STATUS_UNKNOWN né UP_TO_DATE.

Un timestamp in 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".

UpdateStatus

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

Enum
UPDATE_STATUS_UNKNOWN Non è noto se ci sia un aggiornamento di sistema in sospeso. Questo accade, ad esempio, se il livello API del dispositivo è inferiore a 26 o se la versione di Android Device Policy è obsoleta.
UP_TO_DATE Nessun aggiornamento di sistema in attesa disponibile sul dispositivo.
UNKNOWN_UPDATE_AVAILABLE È disponibile un aggiornamento di sistema in attesa, ma il tipo non è noto.
SECURITY_UPDATE_AVAILABLE È disponibile un aggiornamento della sicurezza in attesa.
OS_UPDATE_AVAILABLE È disponibile un aggiornamento del sistema operativo in attesa.

HardwareInfo

Informazioni sull'hardware del dispositivo. I campi relativi alle soglie di temperatura sono disponibili solo se hardwareStatusEnabled è true nel criterio del dispositivo.

Rappresentazione JSON 
{
  "brand": string,
  "hardware": string,
  "deviceBasebandVersion": string,
  "manufacturer": string,
  "serialNumber": string,
  "model": string,
  "batteryShutdownTemperatures": [
    number
  ],
  "batteryThrottlingTemperatures": [
    number
  ],
  "cpuShutdownTemperatures": [
    number
  ],
  "cpuThrottlingTemperatures": [
    number
  ],
  "gpuShutdownTemperatures": [
    number
  ],
  "gpuThrottlingTemperatures": [
    number
  ],
  "skinShutdownTemperatures": [
    number
  ],
  "skinThrottlingTemperatures": [
    number
  ],
  "enterpriseSpecificId": string
}
Campi
brand

string

Marca 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 di limitazione della batteria in gradi Celsius per ogni batteria del dispositivo.
cpuShutdownTemperatures[]

number

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

number

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

number

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

number

Soglie di temperatura di limitazione della GPU in gradi Celsius per ogni GPU del dispositivo.
skinShutdownTemperatures[]

number

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

number

Soglie di temperatura di 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 è registrato con la stessa organizzazione, questo ID persiste per tutte le configurazioni e anche per i ripristini dei dati di fabbrica. Questo ID è disponibile sui dispositivi di proprietà personale con un profilo di lavoro su dispositivi con Android 12 e versioni successive.

Display

Informazioni di visualizzazione del dispositivo.

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

string

Nome del display.
displayId

integer

ID visualizzato univoco.
refreshRate

integer

Frequenza di aggiornamento del display in frame al secondo.
state

enum (DisplayState)

Stato del display.
width

integer

Larghezza visualizzazione in pixel.
height

integer

Altezza visualizzazione in pixel.
density

integer

Densità del display espressa come punti per pollice.

DisplayState

Lo stato di un display.

Enum
DISPLAY_STATE_UNSPECIFIED Questo valore non è consentito.
OFF Il display è spento.
ON Il display è acceso.
DOZE Il display è sospeso in stato di basso consumo
SUSPENDED Il display è sospeso in stato di sospensione a bassa potenza.

ApplicationReport

Informazioni segnalate su un'app installata.

Rappresentazione JSON 
{
  "packageName": string,
  "versionName": string,
  "versionCode": integer,
  "events": [
    {
      object (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 degli eventi dell'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 da un 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 da 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 di stati dell'app associati a una chiave segnalati dall'app.
userFacingType

enum (UserFacingType)

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)

L'ora di creazione dell'evento.

Un timestamp in 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".

ApplicationEventType

Un tipo di evento relativo all'app.

Enum
APPLICATION_EVENT_TYPE_UNSPECIFIED Questo valore non è consentito.
INSTALLED L'app è stata installata.
CHANGED L'app è stata modificata, ad esempio è stato attivato o disattivato un componente.
DATA_CLEARED I dati dell'app sono stati cancellati.
REMOVED L'app è stata rimossa.
REPLACED È stata installata una nuova versione dell'app, che sostituisce la versione precedente.
RESTARTED L'app è stata riavviata.
PINNED L'app è stata bloccata in primo piano.
UNPINNED L'app è stata sbloccata.

ApplicationSource

L'origine che ha fornito un'app.

Enum
APPLICATION_SOURCE_UNSPECIFIED L'app è stata installata tramite sideload da un'origine non specificata.
SYSTEM_APP_FACTORY_VERSION Si tratta di un'app di sistema dall'immagine di fabbrica del dispositivo.
SYSTEM_APP_UPDATED_VERSION Questa è un'app di sistema aggiornata.
INSTALLED_FROM_PLAY_STORE L'app è stata installata dal Google Play Store.

ApplicationState

Lo stato di installazione attuale.

Enum
APPLICATION_STATE_UNSPECIFIED Lo stato dell'app non è specificato
REMOVED L'app è stata rimossa dal dispositivo
INSTALLED L'app è installata sul dispositivo

KeyedAppState

Stato dell'app con chiave segnalato dall'app.

Rappresentazione JSON 
{
  "key": string,
  "severity": enum (Severity),
  "message": string,
  "data": string,
  "createTime": string,
  "lastUpdateTime": string
}
Campi
key

string

La chiave per lo stato dell'app. Funge da punto di riferimento per lo stato fornito dall'app. Ad esempio, se fornisci il feedback sulla configurazione gestita, questa chiave potrebbe essere la chiave di configurazione gestita.
severity

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

string

Facoltativamente, un valore leggibile dal computer che deve essere letto dal provider EMM. Ad esempio, impostare i valori su cui l'amministratore può scegliere di eseguire una query nella console EMM (ad es. "avvisami se i dati di battery_warning sono inferiori a 10").
createTime

string (Timestamp format)

L'ora di creazione dello stato dell'app sul dispositivo.

Un timestamp in formato "Zulu" RFC3339 UTC, con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "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 in 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 un'organizzazione di gestione deve intervenire per risolvere.

UserFacingType

Se l'app è rivolta agli utenti.

Enum
USER_FACING_TYPE_UNSPECIFIED Il tipo di visualizzazione rivolto agli utenti dell'app non è specificato.
NOT_USER_FACING L'app non è rivolta agli utenti.
USER_FACING L'app è rivolta agli utenti.

NetworkInfo

Informazioni sulla rete del dispositivo.

Rappresentazione JSON 
{
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperatorName": string,
  "telephonyInfos": [
    {
      object (TelephonyInfo)
    }
  ]
}
Campi
imei

string

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

string

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

string

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

string

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

object (TelephonyInfo)

Fornisce informazioni sulle telefonate associate a ogni scheda SIM del dispositivo. Funzionalità supportata solo sui dispositivi completamente gestiti a partire dal livello API Android 23.

TelephonyInfo

Informazioni di telefonia associate a una determinata scheda SIM sul dispositivo. Funzionalità supportata solo sui dispositivi completamente gestiti a partire dal livello API Android 23.

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

string

Il numero di telefono associato a questa scheda SIM.
carrierName

string

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

string (int64 format)

RAM totale sul dispositivo in byte.
totalInternalStorage

string (int64 format)

Memoria interna totale sul dispositivo in byte.

MemoryEvent

Un evento relativo alle misurazioni della memoria e dello spazio di archiviazione.

Per distinguere gli eventi nuovi da quelli precedenti, ti consigliamo di utilizzare il campo createTime.

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

enum (MemoryEventType)

Tipo di evento.
createTime

string (Timestamp format)

L'ora di creazione dell'evento.

Un timestamp in 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 senza costi nel mezzo 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 con questo tipo.
RAM_MEASURED È stato misurato lo spazio libero nella RAM.
INTERNAL_STORAGE_MEASURED È stato misurato lo spazio libero nella memoria interna.
EXTERNAL_STORAGE_DETECTED È stato rilevato un nuovo supporto di archiviazione esterno. Il conteggio dei byte segnalati è la capacità totale del mezzo di archiviazione.
EXTERNAL_STORAGE_REMOVED Un supporto di archiviazione esterno è stato rimosso. Il conteggio dei byte segnalati è pari a zero.
EXTERNAL_STORAGE_MEASURED È stato misurato lo spazio libero in un supporto di archiviazione esterno.

PowerManagementEvent

Un evento di gestione dell'alimentazione.

Rappresentazione JSON 
{
  "eventType": enum (PowerManagementEventType),
  "createTime": string,
  "batteryLevel": number
}
Campi
eventType

enum (PowerManagementEventType)

Tipo di evento.
createTime

string (Timestamp format)

L'ora di creazione dell'evento.

Un timestamp in 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".
batteryLevel

number

Per gli 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 con questo tipo.
BATTERY_LEVEL_COLLECTED Il livello della batteria è stato misurato.
POWER_CONNECTED La ricarica del dispositivo è iniziata.
POWER_DISCONNECTED La ricarica del dispositivo è stata interrotta.
BATTERY_LOW Sul dispositivo è stata attivata la modalità a basso consumo.
BATTERY_OKAY Il dispositivo è uscito dalla modalità a basso consumo.
BOOT_COMPLETED Il dispositivo è stato avviato.
SHUTDOWN Il dispositivo si è spento.

HardwareStatus

Stato dell'hardware. Le temperature possono essere confrontate con le soglie di temperatura disponibili in hardwareInfo per determinare l'integrità dell'hardware.

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

string (Timestamp format)

L'ora in cui sono state effettuate le misurazioni.

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

number

Le temperature attuali della batteria in Celsius per ogni batteria del dispositivo.
cpuTemperatures[]

number

Le attuali temperature della CPU in Celsius per ogni CPU sul dispositivo.
gpuTemperatures[]

number

Temperature GPU attuali in Celsius per ogni GPU del dispositivo.
skinTemperatures[]

number

Temperature cutanea attuali del dispositivo in Celsius.
fanSpeeds[]

number

Velocità della ventola in RPM per ciascuna ventola sul dispositivo. Un array vuoto indica che non ci sono ventole o che la velocità della ventola non è supportata sull'impianto.
cpuUsages[]

number

Utilizzi della CPU in percentuale per ogni core disponibile sul dispositivo. L'utilizzo è 0 per ogni core scollegato. Un array vuoto indica che l'utilizzo della CPU non è supportato nel sistema.

DeviceSettings

Informazioni sulle impostazioni del dispositivo relative alla sicurezza.

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

boolean

Se il dispositivo è protetto con PIN/password.
unknownSourcesEnabled

boolean

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

boolean

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

boolean

Indica se ADB è abilitato sul dispositivo.
isEncrypted

boolean

Indica se la crittografia dello spazio di archiviazione è abilitata.
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 deve avere questo tipo.
UNSUPPORTED La crittografia non è supportata dal dispositivo.
INACTIVE La crittografia è supportata dal dispositivo, ma al momento non è attiva.
ACTIVATING La crittografia non è attualmente attiva, ma è in fase di attivazione.
ACTIVE La crittografia è attiva.
ACTIVE_DEFAULT_KEY La crittografia è attiva, ma l'utente non ha impostato una chiave di crittografia.
ACTIVE_PER_USER La crittografia è attiva e la chiave di crittografia è legata al profilo utente.

SecurityPosture

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

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

enum (DevicePosture)

Valore della strategia di sicurezza del dispositivo.
postureDetails[]

object (PostureDetail)

Ulteriori dettagli relativi alla postura di sicurezza del dispositivo.

DevicePosture

Possibili valori della strategia di sicurezza di un dispositivo gestito.

Enum
POSTURE_UNSPECIFIED Non specificato. Nessun dettaglio posture per questo valore posture.
SECURE Questo dispositivo è sicuro.
AT_RISK Questo dispositivo potrebbe essere più vulnerabile a malintenzionati di quanto non sia consigliato per l'uso con i dati aziendali.
POTENTIALLY_COMPROMISED Questo dispositivo potrebbe essere stato compromesso e i dati aziendali potrebbero essere accessibili a soggetti non autorizzati.

PostureDetail

Ulteriori dettagli relativi alla postura di sicurezza del dispositivo.

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

enum (SecurityRisk)

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

object (UserFacingMessage)

Consiglio dell'amministratore corrispondente per mitigare questo rischio per la sicurezza e migliorare la condizione di sicurezza del dispositivo.

SecurityRisk

Il rischio che il dispositivo non si trovi nello stato più sicuro.

Enum
SECURITY_RISK_UNSPECIFIED Non specificato.
UNKNOWN_OS L'API Play Integrity rileva che sul dispositivo è in esecuzione un sistema operativo sconosciuto (il controllo BasicIntegrity ha esito positivo, ma ctsProfileMatch ha esito negativo).
COMPROMISED_OS L'API Play Integrity rileva che sul dispositivo è in esecuzione un sistema operativo compromesso (il controllo di BasicIntegrity non va a buon fine).
HARDWARE_BACKED_EVALUATION_FAILED L'API Play Integrity rileva che il dispositivo non ha una solida garanzia di integrità del sistema se l'etichetta MEETS_STRONG_INTEGRITY non viene mostrata nel campo relativo all'integrità del dispositivo.

CommonCriteriaModeInfo

Informazioni sulla modalità Common Criteria: standard di sicurezza definiti nel documento Common Criteria for Information Technology Security Evaluation (CC).

Questa informazione è disponibile solo se statusReportingSettings.commonCriteriaModeEnabled è true nei criteri del dispositivo.

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

enum (CommonCriteriaModeStatus)

Indica se la modalità Common Criteria è abilitata.

CommonCriteriaModeStatus

Indica se la modalità Common Criteria è abilitata.

Enum
COMMON_CRITERIA_MODE_STATUS_UNKNOWN Stato sconosciuto.
COMMON_CRITERIA_MODE_DISABLED La modalità Common Criteria è attualmente disabilitata.
COMMON_CRITERIA_MODE_ENABLED La modalità Common Criteria è attualmente attiva.

DpcMigrationInfo

Informazioni che indicano se è stata eseguita la migrazione di questo dispositivo affinché non sia più gestito da un altro controller dei criteri dei dispositivi (DPC).

Rappresentazione JSON 
{
  "previousDpc": string,
  "additionalData": string
}
Campi
previousDpc

string

Solo output. Se questo dispositivo è stato migrato da un altro DPC, questo è il nome del pacchetto. Non compilato negli altri casi.
additionalData

string

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

Metodi

delete

 Elimina un dispositivo.

get

 Riceve un dispositivo.

issueCommand

 Invia un comando a un dispositivo.

list

 Elenca i dispositivi di una determinata azienda.

patch

 Aggiorna un dispositivo.