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 di Android Device Policy viene utilizzato dal dispositivo. Ciò influisce sulle impostazioni dei criteri supportate.

state

enum (DeviceState)

Lo stato da applicare al dispositivo. Questo campo può essere modificato tramite una richiesta di applicazione 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 alle norme.

nonComplianceDetails[]

object (NonComplianceDetail)

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

enrollmentTime

string (Timestamp format)

Data e ora della registrazione del dispositivo.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "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 nel formato RFC3339 UTC "Zulu" 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 nel formato RFC3339 UTC "Zulu" 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 nel formato RFC3339 UTC "Zulu" 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 tramite una richiesta di applicazione 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 contiene questi 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 della disattivazione del dispositivo. Questo campo può essere modificato tramite una richiesta di applicazione patch.

softwareInfo

object (SoftwareInfo)

Informazioni dettagliate sul software del dispositivo. Queste informazioni sono disponibili soltanto se il valore softwareInfoEnabled è impostato su true nei criteri del dispositivo.

hardwareInfo

object (HardwareInfo)

Informazioni dettagliate sull'hardware del dispositivo.

displays[]

object (Display)

Informazioni dettagliate sulle visualizzazioni sul dispositivo. Queste informazioni sono disponibili soltanto se il valore displayInfoEnabled è impostato su true nei criteri 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 dei dispositivi precedenti. Il numero di serie viene utilizzato come identificatore univoco per determinare se lo stesso dispositivo fisico si è già registrato in precedenza. I nomi sono in ordine cronologico.

networkInfo

object (NetworkInfo)

Informazioni sulla rete del dispositivo. Queste informazioni sono disponibili soltanto se il valore networkInfoEnabled è impostato su true nei criteri del dispositivo.

memoryInfo

object (MemoryInfo)

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

memoryEvents[]

object (MemoryEvent)

Eventi relativi alle misurazioni della memoria e dello spazio di archiviazione in ordine cronologico. Queste informazioni sono disponibili soltanto se il valore memoryInfoEnabled è impostato su true nei criteri del dispositivo.

Gli eventi vengono conservati per un determinato periodo di tempo e quelli precedenti vengono eliminati.

powerManagementEvents[]

object (PowerManagementEvent)

Eventi di gestione dell'alimentazione sul dispositivo in ordine cronologico. Queste informazioni sono disponibili soltanto se il valore powerManagementEventsEnabled è impostato su true nei criteri del dispositivo.

hardwareStatusSamples[]

object (HardwareStatus)

Campioni 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 soltanto se il valore deviceSettingsEnabled è impostato su 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. Queste informazioni sono disponibili soltanto se il valore systemPropertiesEnabled è impostato su 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 security posture del dispositivo, che riflette il livello di sicurezza del dispositivo.

ownership

enum (Ownership)

Proprietà del dispositivo gestito.

commonCriteriaModeInfo

object (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 nei criteri del dispositivo in cui 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 all'eventuale migrazione di questo dispositivo dalla gestione da parte di un altro controller dei criteri dei dispositivi (DPC).

DeviceState

Stati applicabili a un dispositivo.

Enum
DEVICE_STATE_UNSPECIFIED Questo valore non è consentito.
ACTIVE Il dispositivo è attivo.
DISABLED Il dispositivo è disattivato.
DELETED Il dispositivo è stato eliminato. Questo stato non viene mai restituito da una chiamata API, ma viene utilizzato nel report di stato finale quando il dispositivo conferma l'eliminazione. Se il dispositivo viene eliminato tramite la chiamata API, questo stato viene pubblicato in Pub/Sub. Se l'utente elimina il profilo di lavoro o reimposta il dispositivo, lo stato del dispositivo rimarrà sconosciuto al server.
PROVISIONING È in corso il provisioning del dispositivo. I dispositivi appena registrati rimangono in questo stato finché non viene applicato un criterio.
LOST Il dispositivo è stato smarrito. Questo stato è possibile solo sui dispositivi di proprietà dell'organizzazione.
PREPARING_FOR_MIGRATION Il dispositivo è in fase di preparazione per la migrazione all'API Android Management. Non sono necessarie ulteriori azioni per continuare la migrazione.
DEACTIVATED_BY_DEVICE_FINANCE Questo è un dispositivo finanziato che è stato "bloccato" da parte dell'agente finanziario. Ciò significa che sono state applicate alcune impostazioni dei criteri che limitano la funzionalità del dispositivo fino allo "sbloccato" del dispositivo da parte dell'agente finanziario. Il dispositivo continuerà ad applicare le impostazioni dei criteri, escluse quelle sostituite dall'agente finanziario. Quando il dispositivo è "bloccato", lo stato viene indicato in appliedState come DEACTIVATED_BY_DEVICE_FINANCE.

NonComplianceDetail

Fornisce dettagli sulla mancata conformità a un'impostazione di criteri.

Rappresentazione JSON
{
  "settingName": string,
  "nonComplianceReason": enum (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 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 è 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 dei criteri, il valore attuale dell'impostazione sul dispositivo.

installationFailureReason

enum (InstallationFailureReason)

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

Un errore di rete sul dispositivo dell'utente ha impedito il completamento dell'installazione. Questo accade in genere quando la connettività a internet del dispositivo è ridotta, non disponibile o c'è un problema di configurazione di rete. Assicurati che il dispositivo abbia accesso alla connettività internet completa su una rete che soddisfa 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 si può risolvere liberando spazio di archiviazione sul dispositivo. L'installazione o l'aggiornamento delle app riprenderà automaticamente quando il dispositivo avrà spazio di archiviazione sufficiente.

SpecificNonComplianceReason

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

Enum
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED Il motivo specifico della mancata conformità non è specificato. I campi in 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 impostata su USER_ACTION.
PASSWORD_POLICIES_PASSWORD_EXPIRED La password del dispositivo o del profilo è scaduta. Impostazione passwordPoliciesContext impostata. nonComplianceReason impostata su USER_ACTION.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT La password del dispositivo non soddisfa i requisiti delle password. Impostazione passwordPoliciesContext impostata. 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. Impostazione oncWifiContext impostata. nonComplianceReason impostata 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 quale valore del campo non è supportato. Impostazione oncWifiContext impostata. nonComplianceReason impostata 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 impostata su INVALID_VALUE.
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK L'utente deve rimuovere manualmente la rete Wi-Fi configurata. Questa opzione si applica solo ai profili di lavoro sui dispositivi di proprietà personale. 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. 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 non conformità in relazione 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 pensata per essere mostrata 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)

Ora della creazione.

Un timestamp nel formato RFC3339 UTC "Zulu" 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 la lingua 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 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, ovvero 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. Il valore zero indica che questo campo non è impostato. Questo campo viene impostato solo se è disponibile un aggiornamento (ovvero updateStatus non è né UPDATE_STATUS_UNKNOWNUP_TO_DATE).

Un timestamp nel formato RFC3339 UTC "Zulu" 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, ovvero se esiste un aggiornamento e di che tipo.

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

HardwareInfo

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

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

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 la limitazione 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 la limitazione della GPU in Celsius per ogni GPU sul dispositivo.

skinShutdownTemperatures[]

number

Soglie della temperatura di spegnimento della pelle 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 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 display 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.

DisplayState

Lo stato di una visualizzazione.

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

ApplicationReport

Sono state segnalate informazioni su un'app installata.

Rappresentazione JSON
{
  "packageName": string,
  "versionName": string,
  "versionCode": integer,
  "events": [
    {
      object (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 da un numero esadecimale a due cifre.

signingKeyCertFingerprints[]

string

L'hash SHA-1 di ogni android.content.pm.Signature associato al pacchetto dell'app. Ciascun 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)

Origine del pacchetto.

state

enum (ApplicationState)

Stato dell'applicazione.

keyedAppStates[]

object (KeyedAppState)

Elenco di stati dell'app con 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 nel formato RFC3339 UTC "Zulu" 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 quella precedente.
RESTARTED L'app è stata riavviata.
PINNED L'app è stata bloccata in primo piano.
UNPINNED L'app è stata sbloccata.

ApplicationSource

La fonte che ha fornito un'app.

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

ApplicationState

Lo stato attuale dell'installazione.

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

KeyedAppState

Stato dell'app con chiave segnalato dall'app.

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

string

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

severity

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 es. un valore di configurazione gestita), questo valore deve essere incluso nel messaggio.

data

string

Facoltativamente, un valore leggibile dalla macchina che deve essere letto dall'EMM. Ad esempio, l'impostazione di valori su cui l'amministratore può scegliere di eseguire una query nella console EMM (ad es. "invia una notifica se i dati della batteria_avviso sono inferiori a 10").

createTime

string (Timestamp format)

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

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

lastUpdateTime

string (Timestamp format)

L'ora in cui lo stato dell'app è stato aggiornato più di recente.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "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 autentiche che devono essere risolte da un'organizzazione di gestione.

UserFacingType

Se l'app è rivolta agli utenti.

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

NetworkInfo

Informazioni sulla rete del dispositivo.

Rappresentazione JSON
{
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperatorName": string,
  "telephonyInfos": [
    {
      object (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 relative alla telefonia associate a ogni scheda SIM sul dispositivo. Funzionalità supportata solo su dispositivi completamente gestiti a partire dal livello API Android 23.

TelephonyInfo

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

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

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

Evento relativo alle misurazioni della memoria e dello spazio di archiviazione.

Per distinguere tra eventi nuovi e vecchi, ti consigliamo di utilizzare il campo createTime.

Rappresentazione JSON
{
  "eventType": enum (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 RFC3339 UTC "Zulu" 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 mezzo di archiviazione.

MemoryEventType

Il tipo di evento.

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

PowerManagementEvent

Un evento di gestione dell'alimentazione.

Rappresentazione JSON
{
  "eventType": enum (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 RFC3339 UTC "Zulu" 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 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 ha questo tipo.
BATTERY_LEVEL_COLLECTED È stato misurato il livello della batteria.
POWER_CONNECTED La ricarica del dispositivo è iniziata.
POWER_DISCONNECTED La ricarica del dispositivo è stata interrotta.
BATTERY_LOW Il dispositivo è entrato in modalità a basso consumo.
BATTERY_OKAY Il dispositivo è uscito dalla modalità a basso consumo.
BOOT_COMPLETED Il dispositivo si è avviato.
SHUTDOWN Il dispositivo si è spento.

HardwareStatus

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

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

string (Timestamp format)

L'ora in cui sono state effettuate le misurazioni.

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

batteryTemperatures[]

number

Temperature attuali della batteria in Celsius per ogni batteria del dispositivo.

cpuTemperatures[]

number

Le temperature attuali della CPU in gradi Celsius per ogni CPU sul dispositivo.

gpuTemperatures[]

number

Temperature GPU attuali in Celsius per ogni GPU sul dispositivo.

skinTemperatures[]

number

Temperature cutanea attuali del dispositivo in gradi Celsius.

fanSpeeds[]

number

Velocità della ventola in rpm per ogni ventola sul dispositivo. Un array vuoto indica che non sono presenti ventole o che la velocità delle ventole non è supportata dal sistema.

cpuUsages[]

number

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

DeviceSettings

Informazioni sulle impostazioni di sicurezza del dispositivo sul dispositivo.

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

boolean

Se il dispositivo è protetto con PIN/password.

unknownSourcesEnabled

boolean

Se l'installazione di app da origini sconosciute è attiva.

developmentSettingsEnabled

boolean

Se la modalità sviluppatore è attiva sul dispositivo.

adbEnabled

boolean

Indica se ADB è abilitato sul dispositivo.

isEncrypted

boolean

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

SecurityPosture

Il livello di sicurezza del dispositivo, come determinato dallo stato attuale del dispositivo e dai criteri applicati.

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

enum (DevicePosture)

Valore della security posture del dispositivo.

postureDetails[]

object (PostureDetail)

Ulteriori dettagli relativi alla security posture del dispositivo.

DevicePosture

Possibili valori della security posture di un dispositivo gestito.

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

PostureDetail

Ulteriori dettagli relativi alla security posture del dispositivo.

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

enum (SecurityRisk)

Un rischio per la sicurezza specifico che influisce negativamente sulla condizione di sicurezza del dispositivo.

advice[]

object (UserFacingMessage)

Consigli corrispondenti rivolti agli amministratori per mitigare questo rischio per la sicurezza e migliorare la condizione di sicurezza del dispositivo.

SecurityRisk

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

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

CommonCriteriaModeInfo

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

Queste informazioni sono disponibili solo se il criterio statusReportingSettings.commonCriteriaModeEnabled è true nei criteri del dispositivo.

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

enum (CommonCriteriaModeStatus)

Indica se è attivata la modalità Common Criteria.

CommonCriteriaModeStatus

Indica se è attivata la modalità Common Criteria.

Enum
COMMON_CRITERIA_MODE_STATUS_UNKNOWN Stato sconosciuto.
COMMON_CRITERIA_MODE_DISABLED La modalità Common Criteria è attualmente disattivata.
COMMON_CRITERIA_MODE_ENABLED Al momento è abilitata la modalità Common Criteria.

DpcMigrationInfo

Informazioni relative all'eventuale migrazione di questo dispositivo dalla gestione da parte di un altro controller dei criteri dei dispositivi (DPC).

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

string

Solo output. Se questo dispositivo è stato migrato da un altro DPC, si tratta del nome del pacchetto. Non viene 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

Recupera un dispositivo.

issueCommand

Invia un comando a un dispositivo.

list

Elenca i dispositivi di una determinata azienda.

patch

Consente di aggiornare un dispositivo.