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)
    }
  ]
}
Campi
name

string

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

string

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

enum (ManagementMode)

Il tipo di modalità di gestione che Android Device Policy ha sul dispositivo. Questa operazione 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 alle sue norme.
nonComplianceDetails[]

object (NonComplianceDetail)

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

string (Timestamp format)

L'ora di registrazione del dispositivo.

Un timestamp nel formato "Zulu" UTC RFC3339, con una risoluzione di 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 nel formato "Zulu" UTC RFC3339, con una risoluzione di 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 nel formato "Zulu" UTC RFC3339, con una risoluzione di 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 nel formato "Zulu" UTC RFC3339, con una risoluzione di 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 soltanto 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, questo campo conterrà tali 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, viene visualizzato un messaggio facoltativo che indica il motivo per cui il dispositivo è disattivato. 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 il criterio softwareInfoEnabled è vero nel criterio del dispositivo.
hardwareInfo

object (HardwareInfo)

Informazioni dettagliate sull'hardware del dispositivo.
displays[]

object (Display)

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

object (ApplicationReport)

Report per le app installate sul dispositivo. Queste informazioni sono disponibili solo se applicationReportsEnabled è true nel criterio 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 si è registrato in precedenza. I nomi sono in ordine cronologico.
networkInfo

object (NetworkInfo)

Informazioni di rete del dispositivo. Queste informazioni sono disponibili solo se il criterio networkInfoEnabled è vero 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 alla misurazione della memoria e dello spazio di archiviazione in ordine cronologico. Queste informazioni sono disponibili solo se il criterio memoryInfoEnabled è vero nel criterio del dispositivo.
powerManagementEvents[]

object (PowerManagementEvent)

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

object (HardwareStatus)

Esempi di stato dell'hardware in ordine cronologico. Queste informazioni sono disponibili solo se il criterio hardwareStatusEnabled è vero nel criterio del dispositivo.
deviceSettings

object (DeviceSettings)

Informazioni sulle impostazioni del dispositivo. Queste informazioni sono disponibili solo se il criterio deviceSettingsEnabled è vero 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 relativi al dispositivo. Queste informazioni sono disponibili solo se il criterio systemPropertiesEnabled è vero 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 strategia di sicurezza del dispositivo che riflette quanto è sicuro il dispositivo.
ownership

enum (Ownership)

Proprietà del dispositivo gestito.
commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

Informazioni sulla modalità Common Criteria, standard di sicurezza definiti nella sezione Common Criteria for Information Technology Security Evaluation (CC).

Queste informazioni sono disponibili solo se il criterio statusReportingSettings.commonCriteriaModeEnabled è impostato su true nel criterio del dispositivo.
appliedPasswordPolicies[]

object (PasswordRequirements)

I requisiti di 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.

DeviceState

Stati applicabili a un dispositivo.

Enum
DEVICE_STATE_UNSPECIFIED Questo valore non è consentito.
ACTIVE Il dispositivo è attivo.
DISABLED Il dispositivo è disattivato.
DELETED Il dispositivo è stato eliminato. Questo stato non viene mai restituito da una chiamata API, ma viene utilizzato nel report di stato finale quando il dispositivo conferma l'eliminazione. Se il dispositivo viene eliminato tramite la chiamata API, questo stato viene pubblicato su 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 rimarranno in questo stato fino all'applicazione di un criterio.
LOST Il dispositivo è stato smarrito. Questo stato è possibile solo sui dispositivi di proprietà dell'organizzazione.

Non conformitàDettaglio

Fornisce informazioni dettagliate 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 dei criteri. Si tratta del nome 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, viene specificato il percorso completo del campo in questione. Il percorso è formattato nello stesso modo in cui viene 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 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 del 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 corrente 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 per il criterio in cui il dispositivo non è conforme all'impostazione.
specificNonComplianceContext

object (SpecificNonComplianceContext)

Contesto aggiuntivo per specificNonComplianceReason.

Motivo errore di installazione

Motivi per cui un'installazione dell'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 possibili motivi sono l'inaffidabilità dello spazio di archiviazione sul dispositivo, la connessione di rete del dispositivo o l'installazione che richiede più tempo del previsto. Verrà effettuato automaticamente un nuovo tentativo di installazione.
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 Nessuna licenza disponibile da assegnare all'utente.
NOT_ENROLLED L'azienda non è più registrata con la versione gestita di Google Play oppure l'amministratore non ha accettato i più recenti Termini di servizio della versione gestita di Google Play.
USER_INVALID L'utente non è più valido. L'utente potrebbe essere stato eliminato o disattivato.

Motivo della non conformità specifica

Ulteriori dettagli sul motivo per cui un dispositivo potrebbe non essere conforme a un'impostazione dei criteri. In futuro è possibile aggiungere nuovi valori all'enumerazione.

Enum
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED Il motivo specifico di non 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. nonComplianceReason è impostato su USER_ACTION.
PASSWORD_POLICIES_PASSWORD_EXPIRED La password del dispositivo o del profilo è scaduta. passwordPoliciesContext impostato. nonComplianceReason è impostato su USER_ACTION.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT La password del dispositivo non soddisfa i requisiti della password. passwordPoliciesContext impostato. nonComplianceReason è impostato su USER_ACTION.
ONC_WIFI_INVALID_VALUE La configurazione Wi-Fi di ONC contiene un valore errato. fieldPath specifica il valore del campo errato. oncWifiContext impostato. nonComplianceReason è impostato su INVALID_VALUE.
ONC_WIFI_API_LEVEL L'impostazione Wi-Fi ONC non è supportata nel livello API della versione Android in esecuzione sul dispositivo. fieldPath specifica il valore del campo non supportato. oncWifiContext impostato. nonComplianceReason è impostato su API_LEVEL.
ONC_WIFI_INVALID_ENTERPRISE_CONFIG Nella rete Wi-Fi aziendale manca la CA radice o il nome di dominio. nonComplianceReason è impostato su INVALID_VALUE.

ContestoNonConformitàspecifico

Contesto aggiuntivo per SpecificNonComplianceReason.

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

object (OncWifiContext)

Contesto aggiuntivo per la mancata conformità relativa alla configurazione Wi-Fi. Visualizza ONC_WIFI_INVALID_VALUE e ONC_WIFI_API_LEVEL
passwordPoliciesContext

object (PasswordPoliciesContext)

Contesto aggiuntivo relativo alla non conformità relativa alle norme relative alle password. Leggi i PASSWORD_POLICIES_PASSWORD_EXPIRED e la PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT.

OncWifiContext

Contesto aggiuntivo per la mancata conformità relativa alla configurazione Wi-Fi.

Rappresentazione JSON 
{
  "wifiGuid": string
}
Campi
wifiGuid

string

Il GUID della configurazione Wi-Fi non conforme.

ContestoCriteriNorme password

Contesto aggiuntivo relativo alla non conformità relativa alle norme relative alle password.

Rappresentazione JSON 
{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}
Campi
passwordPolicyScope

enum (PasswordPolicyScope)

L'ambito della password non conforme.

Informazioni software

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 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 pensata per essere mostrata 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, ad esempio 0.6.7.
androidBuildTime

string (Timestamp format)

Ora di creazione.

Un timestamp nel formato "Zulu" UTC RFC3339, con una risoluzione di 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 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 del sistema non sia stata modificata.
systemUpdateInfo

object (SystemUpdateInfo)

Informazioni su un potenziale aggiornamento di sistema in attesa.

Info di aggiornamento di sistema

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 disponibile per la prima volta. Il valore zero indica che questo campo non è impostato. Questo campo è impostato solo se è disponibile un aggiornamento (ovvero updateStatus non è né UPDATE_STATUS_UNKNOWN né UP_TO_DATE).

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

Stato aggiornamento

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

Enum
UPDATE_STATUS_UNKNOWN Non è noto se ci sono aggiornamenti 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.

Informazioni hardware

Informazioni sull'hardware del dispositivo. I campi relativi alle soglie di temperatura sono disponibili solo se il valore hardwareStatusEnabled è vero 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

La 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 per lo spegnimento della batteria in gradi Celsius per ogni batteria del dispositivo.
batteryThrottlingTemperatures[]

number

Soglie di temperatura di limitazione della batteria in 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 di limitazione della CPU in Celsius per ogni CPU sul dispositivo.
gpuShutdownTemperatures[]

number

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

number

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

number

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

number

Soglie di temperatura di limitazione della temperatura del dispositivo in 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 viene mantenuto in tutte le configurazioni e viene eseguito 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 del dispositivo visualizzate.

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

string

Il 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 di visualizzazione in pixel.
height

integer

Altezza di visualizzazione in pixel.
density

integer

Densità del display espressa in punti per pollice.

Stato Display

Lo stato di un display.

Enum
DISPLAY_STATE_UNSPECIFIED Questo valore non è consentito.
OFF Il display è spento.
ON Il display è attivo.
DOZE Il display si addormenta quando il dispositivo è in carica bassa
SUSPENDED Il display si addormenta in stato di basso consumo sospeso.

ReportApplicazione

Informazioni relative a 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 della versione dell'app, che può essere utilizzato per determinare se una versione è più recente di un'altra.
events[]

object (ApplicationEvent)

L'elenco di eventi delle 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 stato modificato. Ogni byte del valore hash è rappresentato da un numero esadecimale di due cifre.
signingKeyCertFingerprints[]

string

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

string

Il nome del pacchetto dell'app che l'ha installata.
applicationSource

enum (ApplicationSource)

L'origine del pacchetto.
state

enum (ApplicationState)

Stato applicazione.
keyedAppStates[]

object (KeyedAppState)

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

enum (UserFacingType)

Indica se l'app è rivolta all'utente.

Eventoapplicazione

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 nel formato "Zulu" UTC RFC3339, con una risoluzione di nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

Tipo di evento applicazione

Un tipo di evento relativo alle app.

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

OrigineApplicazione

L'origine che ha fornito un'app.

Enum
APPLICATION_SOURCE_UNSPECIFIED L'app è stata sottoposta a sideload da un'origine non specificata.
SYSTEM_APP_FACTORY_VERSION Si tratta di un'app di sistema proveniente 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.

StatoApplicazione

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

KeyAppState

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 indicato 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

Facoltativamente, una stringa di messaggio in formato libero per spiegare lo stato dell'app. Se lo stato è stato attivato da un determinato valore, ad esempio un valore di configurazione gestita, deve essere incluso nel messaggio.
data

string

Facoltativamente, un valore leggibile dal computer che deve essere letto dal provider EMM. Ad esempio, l'impostazione dei valori per i quali l'amministratore può eseguire query nella console EMM (ad es. "Inviami una notifica se i dati di batteria_warning < 10").
createTime

string (Timestamp format)

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

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

string (Timestamp format)

La data dell'ultimo aggiornamento dello stato dell'app.

Un timestamp nel formato "Zulu" UTC RFC3339, con una risoluzione di 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 dovrebbe essere impostato solo per le condizioni di errore originali che un'organizzazione di gestione deve intraprendere per risolvere il problema.

Tipo utente

Indica se l'app è rivolta all'utente.

Enum
USER_FACING_TYPE_UNSPECIFIED Tipo di app rivolto agli utenti non specificato.
NOT_USER_FACING L'app non è rivolta all'utente.
USER_FACING L'app è rivolta all'utente.

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 attualmente registrato. Ad esempio, Vodafone.
telephonyInfos[]

object (TelephonyInfo)

Fornisce informazioni di telefonia associate a ogni scheda SIM sul dispositivo. Funzionalità supportata solo su dispositivi completamente gestiti a partire dal livello API Android 23.

Informazioni sulla telefonia

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

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

string

Il numero di telefono associato a questa scheda SIM.
carrierName

string

Il nome dell'operatore associato a questa scheda SIM.

Informazioni sulla memoria

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.

Evento memoria

Un evento relativo alle misurazioni di memoria e archiviazione.

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 nel formato "Zulu" UTC RFC3339, con una risoluzione di 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.

Tipo di evento memoria

Il tipo di evento.

Enum
MEMORY_EVENT_TYPE_UNSPECIFIED Non specificato. Nessun evento ha questo tipo.
RAM_MEASURED È stato misurato lo spazio libero in RAM.
INTERNAL_STORAGE_MEASURED È stato misurato lo spazio libero nella memoria interna.
EXTERNAL_STORAGE_DETECTED È stato rilevato un nuovo supporto di archiviazione esterno. Il numero di byte riportati è la capacità totale del supporto di archiviazione.
EXTERNAL_STORAGE_REMOVED Un supporto di archiviazione esterno è stato rimosso. Il numero di byte riportati è pari a zero.
EXTERNAL_STORAGE_MEASURED È stato misurato lo spazio libero in un supporto di archiviazione esterno.

Evento PowerManagement

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 nel formato "Zulu" UTC RFC3339, con una risoluzione di 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 è espresso in percentuale.

Tipo di evento PowerManagementEventType

Il tipo di evento.

Enum
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED Non specificato. Nessun evento ha questo tipo.
BATTERY_LEVEL_COLLECTED Il livello della batteria è stato misurato.
POWER_CONNECTED La ricarica del dispositivo è stata avviata.
POWER_DISCONNECTED La ricarica del dispositivo è stata interrotta.
BATTERY_LOW Il dispositivo è passato alla modalità a basso consumo.
BATTERY_OKAY Il dispositivo è uscito dalla modalità a basso consumo.
BOOT_COMPLETED Il dispositivo si è avviato.
SHUTDOWN Il dispositivo si è spento.

Stato hardware

Stato hardware. Le temperature possono essere confrontate con le soglie di temperatura disponibili nel mese di 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)

Il momento in cui sono state effettuate le misurazioni.

Un timestamp nel formato "Zulu" UTC RFC3339, con una risoluzione di 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

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

number

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

number

Temperatura cutanea attuale del dispositivo in gradi Celsius.
fanSpeeds[]

number

La velocità della ventola in RPM per ogni ventola sul dispositivo. Un array vuoto indica che non ci sono ventole o che la velocità della ventola non è supportata sul 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.

Impostazioni dispositivo

Informazioni sulle impostazioni relative alla sicurezza del dispositivo.

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 è abilitata.
developmentSettingsEnabled

boolean

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

boolean

Indica se ADB è attivo 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 sul dispositivo.

StatoCrittografia

Stato di 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.

Strategia di sicurezza

Il livello di sicurezza del dispositivo, determinato 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)

Dettagli aggiuntivi sul livello di sicurezza del dispositivo.

Strategia del dispositivo

Valori possibili di strategia di sicurezza di un dispositivo in gestione.

Enum
POSTURE_UNSPECIFIED Non specificato. Non sono presenti dettagli sulla strategia per questo valore.
SECURE Questo dispositivo è sicuro.
AT_RISK Questo dispositivo potrebbe essere più vulnerabile agli utenti malintenzionati rispetto a quanto consigliato per l'uso con i dati aziendali.
POTENTIALLY_COMPROMISED Questo dispositivo potrebbe essere compromesso e i dati aziendali potrebbero essere accessibili ad attori non autorizzati.

Dettaglio posturale

Dettagli aggiuntivi sul livello di sicurezza del dispositivo.

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

enum (SecurityRisk)

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

object (UserFacingMessage)

Consiglio rivolto agli amministratori per mitigare questo rischio per la sicurezza e migliorare il livello di sicurezza del dispositivo.

Rischio di sicurezza

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

Enum
SECURITY_RISK_UNSPECIFIED Non specificato.
UNKNOWN_OS SafetyNet rileva che sul dispositivo è in esecuzione un sistema operativo sconosciuto (il controllo basicIntegrity ha esito positivo, ma ctsProfileMatch non riesce).
COMPROMISED_OS SafetyNet rileva che il dispositivo esegue un sistema operativo compromesso (il controllo basicIntegrity non riesce).
HARDWARE_BACKED_EVALUATION_FAILED SafetyNet rileva che il dispositivo non ha una solida garanzia di integrità del sistema, ad esempio un archivio chiavi basato su hardware.

CommonCriteriaModeInfo

Informazioni sulla modalità Common Criteria, standard di sicurezza definiti nella sezione 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)
}
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à Criteri comuni è attualmente disabilitata.
COMMON_CRITERIA_MODE_ENABLED La modalità Common Criteria è attualmente abilitata.

Metodi

delete

 Elimina un dispositivo.

get

 Prende un dispositivo.

issueCommand

 Emette un comando a un dispositivo.

list

 Elenca i dispositivi di una determinata azienda.

patch

 Aggiorna un dispositivo.