MCP Tools Reference: Android Device Management MCP Server

Strumento: get_device

Recupera i dettagli del dispositivo per un determinato ID dispositivo e azienda. Richiede il nome della risorsa nel formato: enterprises/{enterpriseId}/devices/{deviceId}.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP get_device.

Curl Request 
                  
curl --location 'https://androidmanagement.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_device",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Richiesta di ricevere un dispositivo.

GetDeviceRequest

Rappresentazione JSON 
{
  "name": string
}
Campi
name

string

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

Schema di output

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.

Dispositivo

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)
  },
  "defaultApplicationInfo": [
    {
      object (DefaultApplicationInfo)
    }
  ]
}
Campi
name

string

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

string

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

enum (ManagementMode)

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

enum (DeviceState)

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

enum (DeviceState)

Lo stato attualmente applicato al dispositivo.
policyCompliant

boolean

Se il dispositivo è conforme al criterio.
nonComplianceDetails[]

object (NonComplianceDetail)

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

string (Timestamp format)

L'ora di registrazione del dispositivo.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
lastStatusReportTime

string (Timestamp format)

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

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

Deprecato.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
lastPolicySyncTime

string (Timestamp format)

L'ultima volta che il dispositivo ha recuperato i criteri.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
policyName

string

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

string

Il nome del criterio attualmente applicato al dispositivo.
appliedPolicyVersion

string (int64 format)

La versione del criterio attualmente applicato 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 i 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, un messaggio facoltativo visualizzato sul dispositivo 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 softwareInfoEnabled è true nelle norme del dispositivo.
hardwareInfo

object (HardwareInfo)

Informazioni dettagliate sull'hardware del dispositivo.
displays[]

object (Display)

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

object (ApplicationReport)

Report per le app installate sul dispositivo. Queste informazioni sono disponibili solo quando application_reports_enabled è impostato su true nel criterio del dispositivo.
previousDeviceNames[]

string

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

object (NetworkInfo)

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

object (MemoryInfo)

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

object (MemoryEvent)

Eventi correlati alle misurazioni di memoria e spazio di archiviazione in ordine cronologico. Queste informazioni sono disponibili solo se memoryInfoEnabled è true nelle norme del dispositivo.

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

object (PowerManagementEvent)

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

object (HardwareStatus)

Esempi di stato dell'hardware in ordine cronologico. Queste informazioni sono disponibili solo se hardwareStatusEnabled è true nelle norme del dispositivo.
deviceSettings

object (DeviceSettings)

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

object (User)

L'utente proprietario del dispositivo.
systemProperties

map (key: string, value: string)

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

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

object (SecurityPosture)

Valore della postura di sicurezza 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 nei Common Criteria for Information Technology Security Evaluation (CC).

Queste informazioni sono disponibili solo se statusReportingSettings.commonCriteriaModeEnabled è true nelle norme del dispositivo di proprietà dell'azienda.
appliedPasswordPolicies[]

object (PasswordRequirements)

I requisiti di password attualmente applicati al dispositivo.

  • Questo campo esiste perché i requisiti applicati potrebbero essere leggermente diversi da quelli specificati in passwordPolicies in alcuni casi.
  • Tieni presente che questo campo non fornisce informazioni sulla conformità della password. Per informazioni sulla mancata conformità, vedi nonComplianceDetails.
  • NonComplianceDetail.fieldPath è impostato in base a passwordPolicies, non a questo campo.
dpcMigrationInfo

object (DpcMigrationInfo)

Solo output. Informazioni relative alla migrazione di questo dispositivo dalla gestione di un altro controller dei criteri dei dispositivi (DPC).
defaultApplicationInfo[]

object (DefaultApplicationInfo)

Solo output. Le informazioni predefinite sull'applicazione per DefaultApplicationType. Queste informazioni sono disponibili solo se defaultApplicationInfoReportingEnabled è true nelle norme del dispositivo. Disponibile su Android 16 e versioni successive.

Tutti i tipi di app vengono segnalati sui dispositivi completamente gestiti. I tipi DEFAULT_BROWSER, DEFAULT_CALL_REDIRECTION, DEFAULT_CALL_SCREENING e DEFAULT_DIALER vengono segnalati per i profili di lavoro sui dispositivi di proprietà dell'azienda con un profilo di lavoro e sui dispositivi di proprietà personale. DEFAULT_WALLET viene segnalato anche per i dispositivi di proprietà dell'azienda con un profilo di lavoro, ma includerà solo le informazioni del profilo di lavoro.

NonComplianceDetail

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. Questo è il nome del campo JSON di un campo Policy di primo livello.
nonComplianceReason

enum (NonComplianceReason)

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

string

Il nome del pacchetto che indica l'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 violazione. Il percorso è formattato nello stesso modo in cui viene fatto riferimento al campo JSON della norma in JavaScript, ovvero: 1) Per i campi di tipo oggetto, il nome del campo è seguito da un punto e poi da un nome di sottocampo. 2) Per i campi di tipo array, il nome del campo è seguito dall'indice dell'array racchiuso tra parentesi. Ad esempio, per indicare un problema con il campo url nel campo externalData della terza applicazione, il percorso sarebbe applications[2].externalData.url
currentValue

value (Value format)

Se l'impostazione del criterio non è stata applicata, il valore corrente dell'impostazione sul dispositivo.
installationFailureReason

enum (InstallationFailureReason)

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

enum (SpecificNonComplianceReason)

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

object (SpecificNonComplianceContext)

Contesto aggiuntivo per specific_non_compliance_reason.

Valore

Rappresentazione JSON 
{

  // Union field kind can be only one of the following:
  "nullValue": null,
  "numberValue": number,
  "stringValue": string,
  "boolValue": boolean,
  "structValue": {
    object
  },
  "listValue": array
  // End of list of possible types for union field kind.
}
Campi
Campo unione kind. Il tipo di valore. kind può essere solo uno dei seguenti tipi:
nullValue

null

Rappresenta un valore null.
numberValue

number

Rappresenta un valore doppio.
stringValue

string

Rappresenta un valore stringa.
boolValue

boolean

Rappresenta un valore booleano.
structValue

object (Struct format)

Rappresenta un valore strutturato.
listValue

array (ListValue format)

Rappresenta un Value ripetuto.

Struct

Rappresentazione JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Campi
fields

map (key: string, value: value (Value format))

Mappa non ordinata di valori digitati dinamicamente.

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

FieldsEntry

Rappresentazione JSON 
{
  "key": string,
  "value": value
}
Campi
key

string
value

value (Value format)

ListValue

Rappresentazione JSON 
{
  "values": [
    value
  ]
}
Campi
values[]

value (Value format)

Campo ripetuto di valori con tipo dinamico.

SpecificNonComplianceContext

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

object (OncWifiContext)

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

object (PasswordPoliciesContext)

Contesto aggiuntivo per la mancata conformità relativa alle norme sulle password. Leggi PASSWORD_POLICIES_PASSWORD_EXPIRED e PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT.
defaultApplicationContext

object (DefaultApplicationContext)

Solo output. Contesto aggiuntivo per la mancata conformità relativa alle impostazioni predefinite dell'applicazione. Leggi i DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE.

OncWifiContext

Rappresentazione JSON 
{
  "wifiGuid": string
}
Campi
wifiGuid

string

Il GUID della configurazione Wi-Fi non conforme.

PasswordPoliciesContext

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

enum (PasswordPolicyScope)

L'ambito della password non conforme.

DefaultApplicationContext

Rappresentazione JSON 
{
  "defaultApplicationScope": enum (DefaultApplicationScope)
}
Campi
defaultApplicationScope

enum (DefaultApplicationScope)

Solo output. L'ambito dell'impostazione predefinita dell'applicazione non conforme.

Timestamp

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Rappresenta i secondi di tempo UTC dall'epoca di Unix 1970-01-01T00:00:00Z. Deve essere compreso tra -62135596800 e 253402300799 inclusi (corrispondenti a 0001-01-01T00:00:00Z e 9999-12-31T23:59:59Z).
nanos

integer

Frazioni di secondo non negative con risoluzione in nanosecondi. Questo campo è la parte in nanosecondi della durata, non un'alternativa ai secondi. I valori negativi dei secondi con frazioni devono comunque avere valori di nanosecondi non negativi che vengono conteggiati in avanti nel tempo. Deve essere compreso tra 0 e 999.999.999 inclusi.

UserFacingMessage

Rappresentazione JSON 
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
Campi
localizedMessages

map (key: string, value: string)

Una mappa contenente coppie <locale, messaggio>, dove locale è un codice di lingua BCP 47 ben formato, ad esempio en-US, es-ES o fr.

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

string

Il messaggio predefinito visualizzato se non viene specificato alcun messaggio localizzato o se le impostazioni internazionali dell'utente non corrispondono a nessuno dei messaggi localizzati. Se vengono forniti messaggi localizzati, è necessario fornire un messaggio predefinito.

LocalizedMessagesEntry

Rappresentazione JSON 
{
  "key": string,
  "value": string
}
Campi
key

string
value

string

SoftwareInfo

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 visualizzata dall'utente.
androidBuildNumber

string

Stringa ID build Android destinata alla visualizzazione per l'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)

Tempo di compilazione.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
securityPatchLevel

string

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

string

Un codice lingua IETF BCP 47 per le impostazioni internazionali principali 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

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

enum (UpdateStatus)

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

string (Timestamp format)

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

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

HardwareInfo

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

string

Il 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. Tuttavia, per i dispositivi di proprietà personale con Android 12 e versioni successive, è uguale a enterpriseSpecificId.
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 spegnimento 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 spegnimento della GPU in gradi Celsius per ogni GPU sul dispositivo.
gpuThrottlingTemperatures[]

number

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

number

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

number

Soglie di temperatura di limitazione della temperatura cutanea 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 registrato con la stessa organizzazione, questo ID viene mantenuto durante le configurazioni e anche dopo i ripristini dei dati di fabbrica. Questo ID è disponibile sui dispositivi di proprietà personale con un profilo di lavoro sui dispositivi con Android 12 e versioni successive.
euiccChipInfo[]

object (EuiccChipInfo)

Solo output. Informazioni relative al chip eUICC.

EuiccChipInfo

Rappresentazione JSON 
{
  "eid": string
}
Campi
eid

string

Solo output. L'Embedded Identity Document (EID) che identifica il chip eUICC per ogni chip eUICC sul dispositivo. Questa funzionalità è disponibile sui dispositivi di proprietà aziendale con Android 13 e versioni successive.

Display

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 display univoco.
refreshRate

integer

Frequenza di aggiornamento del display in frame al secondo.
state

enum (DisplayState)

Stato del display.
width

integer

Larghezza del display in pixel.
height

integer

Altezza del display in pixel.
density

integer

Compattezza visualizzazione espressa in punti per pollice.

ApplicationReport

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 visualizzata dall'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 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 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 come un numero esadecimale a due cifre.
installerPackageName

string

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

enum (ApplicationSource)

L'origine del pacchetto.
state

enum (ApplicationState)

Stato dell'applicazione.
keyedAppStates[]

object (KeyedAppState)

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

enum (UserFacingType)

Indica se l'app è rivolta agli utenti.

ApplicationEvent

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.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

KeyedAppState

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, quando fornisci un feedback sulla configurazione gestita, questa chiave potrebbe essere la chiave di configurazione gestita.
severity

enum (Severity)

La gravità dello stato dell'app.
message

string

(Facoltativo) Una stringa di messaggio in formato libero per spiegare lo stato dell'app. Se lo stato è stato attivato da un valore specifico (ad es. un valore di configurazione gestita), questo deve essere incluso nel messaggio.
data

string

(Facoltativo) Un valore leggibile da computer da leggere da EMM. Ad esempio, impostando valori che l'amministratore può scegliere di interrogare nella console EMM (ad es. "comunica se i dati battery_warning < 10").
createTime

string (Timestamp format)

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

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
lastUpdateTime

string (Timestamp format)

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

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

NetworkInfo

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 sulla telefonia associate a ogni scheda SIM sul dispositivo. Supportato solo sui dispositivi completamente gestiti a partire dal livello API Android 23.

TelephonyInfo

Rappresentazione JSON 
{
  "phoneNumber": string,
  "carrierName": string,
  "iccId": string,
  "activationState": enum (ActivationState),
  "configMode": enum (ConfigMode)
}
Campi
phoneNumber

string

Il numero di telefono associato a questa scheda SIM.
carrierName

string

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

string

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

enum (ActivationState)

Solo output. Stato di attivazione della scheda SIM sul dispositivo. Questo vale solo per le eSIM. Questa funzionalità è supportata su tutti i dispositivi per il livello API 35 e versioni successive. Questo valore è sempre ACTIVATION_STATE_UNSPECIFIED per le SIM fisiche e per i dispositivi con livello API inferiore a 35.
configMode

enum (ConfigMode)

Solo output. La modalità di configurazione della scheda SIM sul dispositivo. Questo vale solo per le eSIM. Questa funzionalità è supportata su tutti i dispositivi per il livello API 35 e versioni successive. Questo valore è sempre CONFIG_MODE_UNSPECIFIED per le SIM fisiche e per i dispositivi con livello API inferiore a 35.

MemoryInfo

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

string (int64 format)

RAM totale sul dispositivo in byte.
totalInternalStorage

string (int64 format)

Spazio di archiviazione interno totale sul dispositivo in byte.

MemoryEvent

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.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
byteCount

string (int64 format)

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

PowerManagementEvent

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.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
batteryLevel

number

Per gli eventi BATTERY_LEVEL_COLLECTED, il livello della batteria in percentuale.

HardwareStatus

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.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
batteryTemperatures[]

number

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

number

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

number

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

number

Le temperature cutanee attuali del dispositivo in gradi Celsius.
fanSpeeds[]

number

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

number

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

DeviceSettings

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 è attivata l'installazione di app da origini sconosciute.
developmentSettingsEnabled

boolean

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

boolean

Indica se ADB è attivato sul dispositivo.
isEncrypted

boolean

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

enum (EncryptionStatus)

Stato della crittografia da DevicePolicyManager.
verifyAppsEnabled

boolean

Se la verifica di Google Play Protect è applicata sul dispositivo.

Utente

Rappresentazione JSON 
{
  "accountIdentifier": string
}
Campi
accountIdentifier

string

Un identificatore univoco creato per questo utente, ad esempio user342 o asset#44418. Questo campo deve essere impostato al momento della creazione dell'utente e non può essere aggiornato. Questo campo non deve contenere informazioni che consentono l'identificazione personale (PII). Questo identificatore deve contenere al massimo 1024 caratteri, altrimenti la richiesta di aggiornamento delle norme non andrà a buon fine.

SystemPropertiesEntry

Rappresentazione JSON 
{
  "key": string,
  "value": string
}
Campi
key

string
value

string

SecurityPosture

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

enum (DevicePosture)

Valore della postura di sicurezza del dispositivo.
postureDetails[]

object (PostureDetail)

Ulteriori dettagli sulla postura di sicurezza del dispositivo.

PostureDetail

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

enum (SecurityRisk)

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

object (UserFacingMessage)

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

CommonCriteriaModeInfo

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

enum (CommonCriteriaModeStatus)

Se la modalità Common Criteria è attivata.
policySignatureVerificationStatus

enum (PolicySignatureVerificationStatus)

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

PasswordRequirements

Rappresentazione JSON 
{
  "passwordMinimumLength": integer,
  "passwordMinimumLetters": integer,
  "passwordMinimumLowerCase": integer,
  "passwordMinimumNonLetter": integer,
  "passwordMinimumNumeric": integer,
  "passwordMinimumSymbols": integer,
  "passwordMinimumUpperCase": integer,
  "passwordQuality": enum (PasswordQuality),
  "passwordHistoryLength": integer,
  "maximumFailedPasswordsForWipe": integer,
  "passwordExpirationTimeout": string,
  "passwordScope": enum (PasswordPolicyScope),
  "requirePasswordUnlock": enum (RequirePasswordUnlock),
  "unifiedLockSettings": enum (UnifiedLockSettings)
}
Campi
passwordMinimumLength

integer

La lunghezza minima consentita della password. Un valore pari a 0 indica che non esiste alcuna limitazione. Applicato solo quando password_quality è NUMERIC, NUMERIC_COMPLEX, ALPHABETIC, ALPHANUMERIC o COMPLEX.
passwordMinimumLetters

integer

Numero minimo di lettere richieste nella password. Applicato solo quando password_quality è COMPLEX.
passwordMinimumLowerCase

integer

Numero minimo di lettere minuscole richieste nella password. Applicato solo quando password_quality è COMPLEX.
passwordMinimumNonLetter

integer

Numero minimo di caratteri che non siano lettere (cifre numeriche o simboli) richiesti nella password. Applicato solo quando password_quality è COMPLEX.
passwordMinimumNumeric

integer

Numero minimo di cifre numeriche richieste nella password. Applicato solo quando password_quality è COMPLEX.
passwordMinimumSymbols

integer

Numero minimo di simboli richiesti nella password. Applicato solo quando password_quality è COMPLEX.
passwordMinimumUpperCase

integer

Numero minimo di lettere maiuscole richieste nella password. Applicato solo quando password_quality è COMPLEX.
passwordQuality

enum (PasswordQuality)

La qualità della password richiesta.
passwordHistoryLength

integer

La lunghezza della cronologia delle password. Dopo aver impostato questo campo, l'utente non potrà inserire una nuova password uguale a una delle password nella cronologia. Un valore pari a 0 indica che non esiste alcuna limitazione.
maximumFailedPasswordsForWipe

integer

Numero di password di sblocco del dispositivo errate che possono essere inserite prima della cancellazione dei dati del dispositivo. Un valore pari a 0 indica che non esiste alcuna limitazione.
passwordExpirationTimeout

string (Duration format)

Timeout scadenza password.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".
passwordScope

enum (PasswordPolicyScope)

L'ambito a cui si applica il requisito della password.
requirePasswordUnlock

enum (RequirePasswordUnlock)

Il periodo di tempo dopo che un dispositivo o un profilo di lavoro viene sbloccato utilizzando una forma di autenticazione avanzata (password, PIN, sequenza) durante il quale può essere sbloccato utilizzando qualsiasi altro metodo di autenticazione (ad es. impronta, agenti attendibili, volto). Trascorso il periodo di tempo specificato, per sbloccare il dispositivo o il profilo di lavoro possono essere utilizzate solo forme di autenticazione avanzata.
unifiedLockSettings

enum (UnifiedLockSettings)

Controlla se è consentito un blocco unificato per il dispositivo e il profilo di lavoro sui dispositivi con Android 9 e versioni successive con un profilo di lavoro. Può essere impostato solo se password_scope è impostato su SCOPE_PROFILE, altrimenti il criterio verrà rifiutato. Se l'utente non ha impostato un blocco separato per le app di lavoro e questo campo è impostato su REQUIRE_SEPARATE_WORK_LOCK, viene segnalato un NonComplianceDetail con nonComplianceReason impostato su USER_ACTION.

Durata

Rappresentazione JSON 
{
  "seconds": string,
  "nanos": integer
}
Campi
seconds

string (int64 format)

Secondi firmati dell'intervallo di tempo. Deve essere compreso tra -315.576.000.000 e +315.576.000.000 inclusi. Nota: questi limiti vengono calcolati in base a: 60 sec/min * 60 min/ora * 24 ore/giorno * 365,25 giorni/anno * 10.000 anni
nanos

integer

Frazioni di secondo con segno con risoluzione in nanosecondi dell'intervallo di tempo. Le durate inferiori a un secondo sono rappresentate con un campo seconds pari a 0 e un campo nanos positivo o negativo. Per durate di un secondo o più, un valore diverso da zero per il campo nanos deve avere lo stesso segno del campo seconds. Deve essere compreso tra -999.999.999 e +999.999.999 inclusi.

DpcMigrationInfo

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

string

Solo output. Se questo dispositivo è stato migrato da un altro DPC, questo è il suo nome del pacchetto. Altrimenti non viene compilato.
additionalData

string

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

DefaultApplicationInfo

Rappresentazione JSON 
{
  "defaultApplicationType": enum (DefaultApplicationType),
  "packageName": string,
  "defaultApplicationSettingAttempts": [
    {
      object (DefaultApplicationSettingAttempt)
    }
  ]
}
Campi
defaultApplicationType

enum (DefaultApplicationType)

Solo output. Il tipo di applicazione predefinito.
packageName

string

Solo output. Il nome del pacchetto dell'applicazione predefinita corrente.
defaultApplicationSettingAttempts[]

object (DefaultApplicationSettingAttempt)

Solo output. Dettagli sui tentativi di impostazione dell'applicazione predefinita, nello stesso ordine in cui sono elencati in defaultApplications.

DefaultApplicationSettingAttempt

Rappresentazione JSON 
{
  "packageName": string,
  "attemptOutcome": enum (AttemptOutcome)
}
Campi
packageName

string

Solo output. Il nome del pacchetto dell'applicazione tentata.
attemptOutcome

enum (AttemptOutcome)

Solo output. Il risultato dell'impostazione dell'app come predefinita.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌