MCP Tools Reference: Android Device Management MCP Server

Herramienta: list_devices

Enumera los dispositivos de una empresa determinada. Se requiere el ID de la empresa en el campo principal (p.ej., enterprises/{enterpriseId}).

En el siguiente ejemplo, se muestra cómo usar curl para invocar la herramienta de MCP list_devices.

Solicitud de Curl 
                  
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": "list_devices",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Esquema de entrada

Es una solicitud para enumerar los dispositivos de una empresa determinada.

ListDevicesRequest

Representación JSON 
{
  "parent": string,
  "pageSize": integer,
  "pageToken": string
}
Campos
parent

string

Nombre de la empresa en el formato enterprises/{enterpriseId}.
pageSize

integer

Es el tamaño de página solicitado. Si no se especifica, se devolverán, como máximo, 10 dispositivos. El valor máximo es 100, y los valores superiores se convertirán a 100. Los límites pueden cambiar con el tiempo.
pageToken

string

Es un token que identifica una página de resultados que devuelve el servidor.

Esquema de salida

Es la respuesta a una solicitud para enumerar los dispositivos de una empresa determinada.

ListDevicesResponse

Representación JSON 
{
  "devices": [
    {
      object (Device)
    }
  ],
  "nextPageToken": string
}
Campos
devices[]

object (Device)

Es la lista de dispositivos.
nextPageToken

string

Si hay más resultados, se incluye un token para recuperar la siguiente página de resultados.

Dispositivo

Representación 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)
    }
  ]
}
Campos
name

string

Nombre del dispositivo con el formato enterprises/{enterpriseId}/devices/{deviceId}.
userName

string

Es el nombre del recurso del usuario propietario de este dispositivo con el formato enterprises/{enterpriseId}/users/{userId}.
managementMode

enum (ManagementMode)

Es el tipo de modo de administración que adopta la política de Android Device Policy en el dispositivo. Esto influye en la configuración de políticas que se admite.
state

enum (DeviceState)

Es el estado que se aplicará al dispositivo. Este campo se puede modificar con una solicitud de parche. Ten en cuenta que, cuando llamas a enterprises.devices.patch, ACTIVE y DISABLED son los únicos valores permitidos. Para que el dispositivo entre en un estado DELETED, llama a enterprises.devices.delete.
appliedState

enum (DeviceState)

Es el estado que se aplica actualmente al dispositivo.
policyCompliant

boolean

Indica si el dispositivo cumple con su política.
nonComplianceDetails[]

object (NonComplianceDetail)

Son los detalles sobre la configuración de políticas con la que no cumple el dispositivo.
enrollmentTime

string (Timestamp format)

Es la fecha y hora de inscripción del dispositivo.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
lastStatusReportTime

string (Timestamp format)

Es la última vez que el dispositivo envió un informe de estado.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

Obsoleta.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
lastPolicySyncTime

string (Timestamp format)

Fecha y hora en que el dispositivo recuperó su política por última vez.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
policyName

string

Nombre de la política aplicada al dispositivo, con el formato enterprises/{enterpriseId}/policies/{policyId}. Si no se especifica, se aplica el policy_name del usuario del dispositivo. Este campo se puede modificar con una solicitud de parche. Solo puedes especificar policyId cuando llamas a enterprises.devices.patch, siempre y cuando policyId no contenga barras. Se infiere el resto del nombre de la política.
appliedPolicyName

string

Es el nombre de la política que se aplica actualmente al dispositivo.
appliedPolicyVersion

string (int64 format)

Es la versión de la política que se aplica actualmente al dispositivo.
apiLevel

integer

Es el nivel de API de la versión de la plataforma Android que se ejecuta en el dispositivo.
enrollmentTokenData

string

Si el dispositivo se inscribió con un token de inscripción con datos adicionales proporcionados, este campo contiene esos datos.
enrollmentTokenName

string

Si el dispositivo se inscribió con un token de inscripción, este campo contiene el nombre del token.
disabledReason

object (UserFacingMessage)

Si el estado del dispositivo es DISABLED, se muestra un mensaje opcional en el dispositivo que indica el motivo por el que está inhabilitado. Este campo se puede modificar con una solicitud de parche.
softwareInfo

object (SoftwareInfo)

Información detallada sobre el software del dispositivo. Esta información solo está disponible si softwareInfoEnabled es verdadero en la política del dispositivo.
hardwareInfo

object (HardwareInfo)

Es información detallada sobre el hardware del dispositivo.
displays[]

object (Display)

Es información detallada sobre las pantallas del dispositivo. Esta información solo está disponible si displayInfoEnabled es verdadero en la política del dispositivo.
applicationReports[]

object (ApplicationReport)

Son informes sobre las apps instaladas en el dispositivo. Esta información solo está disponible cuando application_reports_enabled es verdadero en la política del dispositivo.
previousDeviceNames[]

string

Si el mismo dispositivo físico se inscribió varias veces, este campo contiene sus nombres anteriores. El número de serie se usa como identificador único para determinar si el mismo dispositivo físico se inscribió anteriormente. Los nombres están en orden cronológico.
networkInfo

object (NetworkInfo)

Información de la red del dispositivo Esta información solo está disponible si networkInfoEnabled es verdadero en la política del dispositivo.
memoryInfo

object (MemoryInfo)

Información de la memoria: Contiene información sobre la memoria y el almacenamiento del dispositivo.
memoryEvents[]

object (MemoryEvent)

Eventos relacionados con las mediciones de memoria y almacenamiento en orden cronológico. Esta información solo está disponible si memoryInfoEnabled es verdadero en la política del dispositivo.

Los eventos se conservan durante un período determinado y los eventos antiguos se borran.
powerManagementEvents[]

object (PowerManagementEvent)

Eventos de administración de energía en el dispositivo, en orden cronológico. Esta información solo está disponible si powerManagementEventsEnabled es verdadero en la política del dispositivo.
hardwareStatusSamples[]

object (HardwareStatus)

Son muestras del estado del hardware en orden cronológico. Esta información solo está disponible si hardwareStatusEnabled es verdadero en la política del dispositivo.
deviceSettings

object (DeviceSettings)

Es la información de configuración del dispositivo. Esta información solo está disponible si deviceSettingsEnabled es verdadero en la política del dispositivo.
user

object (User)

Es el usuario propietario del dispositivo.
systemProperties

map (key: string, value: string)

Es un mapa del nombre y el valor de las propiedades del sistema seleccionadas relacionadas con el dispositivo. Esta información solo está disponible si systemPropertiesEnabled es verdadero en la política del dispositivo.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
securityPosture

object (SecurityPosture)

Es el valor de la posición de seguridad del dispositivo que refleja qué tan seguro es el dispositivo.
ownership

enum (Ownership)

Propiedad del dispositivo administrado.
commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

Información sobre el modo Common Criteria: estándares de seguridad definidos en los Common Criteria for Information Technology Security Evaluation (CC).

Esta información solo está disponible si statusReportingSettings.commonCriteriaModeEnabled es true en la política del dispositivo, y este pertenece a la empresa.
appliedPasswordPolicies[]

object (PasswordRequirements)

Son los requisitos de contraseña que se aplican actualmente al dispositivo.

  • Este campo existe porque, en algunos casos, los requisitos aplicados pueden ser ligeramente diferentes de los especificados en passwordPolicies.
  • Ten en cuenta que este campo no proporciona información sobre el cumplimiento de la contraseña. Para obtener información sobre el incumplimiento, consulta nonComplianceDetails.
  • NonComplianceDetail.fieldPath se configura según passwordPolicies, no según este campo.
dpcMigrationInfo

object (DpcMigrationInfo)

Solo salida. Es información relacionada con si este dispositivo se migró desde otro controlador de políticas de dispositivo (DPC).
defaultApplicationInfo[]

object (DefaultApplicationInfo)

Solo salida. Es la información predeterminada de la aplicación para DefaultApplicationType. Esta información solo está disponible si defaultApplicationInfoReportingEnabled es verdadero en la política del dispositivo. Disponible en Android 16 y versiones posteriores.

Todos los tipos de apps se registran en dispositivos completamente administrados. Los tipos DEFAULT_BROWSER, DEFAULT_CALL_REDIRECTION, DEFAULT_CALL_SCREENING y DEFAULT_DIALER se registran para los perfiles de trabajo en dispositivos propiedad de la empresa con un perfil de trabajo y en dispositivos personales. DEFAULT_WALLET también se informa para los dispositivos empresariales con un perfil de trabajo, pero solo incluirá la información del perfil de trabajo.

NonComplianceDetail

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

string

Es el nombre del parámetro de configuración de la política. Es el nombre del campo JSON de un campo Policy de nivel superior.
nonComplianceReason

enum (NonComplianceReason)

Es el motivo por el que el dispositivo no cumple con el parámetro de configuración.
packageName

string

Nombre del paquete que indica qué app no cumple con las políticas, si corresponde.
fieldPath

string

En el caso de los parámetros de configuración con campos anidados, si un campo anidado en particular no cumple con los requisitos, se especifica la ruta de acceso completa al campo infractor. La ruta de acceso tiene el mismo formato que el campo JSON de la política tendría en JavaScript, es decir: 1) Para los campos con tipo de objeto, el nombre del campo está seguido de un punto y, luego, de un nombre de subcampo. 2) En el caso de los campos de tipo array, el nombre del campo está seguido del índice del array entre corchetes. Por ejemplo, para indicar un problema con el campo url en el campo externalData de la 3ª solicitud, la ruta sería applications[2].externalData.url.
currentValue

value (Value format)

Es el valor actual del parámetro de configuración en el dispositivo si no se pudo aplicar el parámetro de configuración de la política.
installationFailureReason

enum (InstallationFailureReason)

Si se establece package_name y el motivo de incumplimiento es APP_NOT_INSTALLED o APP_NOT_UPDATED, se indica el motivo detallado por el que no se puede instalar o actualizar la app.
specificNonComplianceReason

enum (SpecificNonComplianceReason)

Es el motivo específico de la política por el que el dispositivo no cumple con el parámetro de configuración.
specificNonComplianceContext

object (SpecificNonComplianceContext)

Es el contexto adicional para specific_non_compliance_reason.

Valor

Representación 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.
}
Campos
Campo de unión kind. Es el tipo de valor. kind puede ser solo uno de los parámetros siguientes:
nullValue

null

Representa un valor nulo.
numberValue

number

Representa un valor doble.
stringValue

string

Representa un valor de cadena.
boolValue

boolean

Representa un valor booleano.
structValue

object (Struct format)

Representa un valor estructurado.
listValue

array (ListValue format)

Representa un Value repetido.

Struct

Representación JSON 
{
  "fields": {
    string: value,
    ...
  }
}
Campos
fields

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

Es un mapa no ordenado de valores escritos de forma dinámica.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

FieldsEntry

Representación JSON 
{
  "key": string,
  "value": value
}
Campos
key

string
value

value (Value format)

ListValue

Representación JSON 
{
  "values": [
    value
  ]
}
Campos
values[]

value (Value format)

Es un campo repetido de valores escritos de forma dinámica.

SpecificNonComplianceContext

Representación JSON 
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  },
  "defaultApplicationContext": {
    object (DefaultApplicationContext)
  }
}
Campos
oncWifiContext

object (OncWifiContext)

Contexto adicional sobre el incumplimiento relacionado con la configuración de Wi-Fi. Consulta ONC_WIFI_INVALID_VALUE y ONC_WIFI_API_LEVEL.
passwordPoliciesContext

object (PasswordPoliciesContext)

Es contexto adicional sobre el incumplimiento relacionado con las políticas de contraseñas. Consulta PASSWORD_POLICIES_PASSWORD_EXPIRED y PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT.
defaultApplicationContext

object (DefaultApplicationContext)

Solo salida. Es contexto adicional sobre el incumplimiento relacionado con la configuración predeterminada de la aplicación. Consulta los DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE.

OncWifiContext

Representación JSON 
{
  "wifiGuid": string
}
Campos
wifiGuid

string

Es el GUID de la configuración de Wi-Fi que no cumple con los requisitos.

PasswordPoliciesContext

Representación JSON 
{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}
Campos
passwordPolicyScope

enum (PasswordPolicyScope)

Es el alcance de la contraseña que no cumple con los requisitos.

DefaultApplicationContext

Representación JSON 
{
  "defaultApplicationScope": enum (DefaultApplicationScope)
}
Campos
defaultApplicationScope

enum (DefaultApplicationScope)

Solo salida. Es el alcance del parámetro de configuración de la aplicación predeterminada que no cumple con los requisitos.

Marca de tiempo

Representación JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Representa los segundos de la hora UTC desde la época de Unix 1970-01-01T00:00:00Z. Debe estar entre -62135596800 y 253402300799 inclusive (lo que corresponde a 0001-01-01T00:00:00Z a 9999-12-31T23:59:59Z).
nanos

integer

Fracciones no negativas de un segundo a una resolución de nanosegundos. Este campo es la parte de la duración en nanosegundos, no una alternativa a los segundos. Los valores de segundos negativos con fracciones deben tener valores nanos no negativos que se cuentan hacia adelante en el tiempo. Debe ser un valor entre 0 y 999,999,999, inclusive.

UserFacingMessage

Representación JSON 
{
  "localizedMessages": {
    string: string,
    ...
  },
  "defaultMessage": string
}
Campos
localizedMessages

map (key: string, value: string)

Es un mapa que contiene pares <configuración regional, mensaje>, en el que la configuración regional es un código de idioma BCP 47 bien formado, como en-US, es-ES o fr.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
defaultMessage

string

Es el mensaje predeterminado que se muestra si no se especifica ningún mensaje localizado o si la configuración regional del usuario no coincide con ninguno de los mensajes localizados. Se debe proporcionar un mensaje predeterminado si se proporcionan mensajes localizados.

LocalizedMessagesEntry

Representación JSON 
{
  "key": string,
  "value": string
}
Campos
key

string
value

string

SoftwareInfo

Representación JSON 
{
  "androidVersion": string,
  "androidDevicePolicyVersionCode": integer,
  "androidDevicePolicyVersionName": string,
  "androidBuildNumber": string,
  "deviceKernelVersion": string,
  "bootloaderVersion": string,
  "androidBuildTime": string,
  "securityPatchLevel": string,
  "primaryLanguageCode": string,
  "deviceBuildSignature": string,
  "systemUpdateInfo": {
    object (SystemUpdateInfo)
  }
}
Campos
androidVersion

string

Es la cadena de versión de Android visible para el usuario. Por ejemplo, 6.0.1.
androidDevicePolicyVersionCode

integer

Es el código de versión de la app de Android Device Policy.
androidDevicePolicyVersionName

string

Es la versión de la app de Device Policy para Android que se muestra al usuario.
androidBuildNumber

string

Es la cadena de ID de compilación de Android que se muestra al usuario. Por ejemplo, shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys.
deviceKernelVersion

string

Versión del kernel, por ejemplo, 2.6.32.9-g103d848.
bootloaderVersion

string

Número de versión del cargador de arranque del sistema, p.ej., 0.6.7.
androidBuildTime

string (Timestamp format)

Tiempo de compilación

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
securityPatchLevel

string

Nivel de parche de seguridad, p.ej., 2016-05-01.
primaryLanguageCode

string

Es un código de idioma IETF BCP 47 para la configuración regional principal del dispositivo.
deviceBuildSignature

string

Es el hash SHA-256 de android.content.pm.Signature asociado con el paquete del sistema, que se puede usar para verificar que no se haya modificado la compilación del sistema.
systemUpdateInfo

object (SystemUpdateInfo)

Es información sobre una posible actualización del sistema pendiente.

SystemUpdateInfo

Representación JSON 
{
  "updateStatus": enum (UpdateStatus),
  "updateReceivedTime": string
}
Campos
updateStatus

enum (UpdateStatus)

Es el estado de una actualización: indica si existe una actualización y de qué tipo es.
updateReceivedTime

string (Timestamp format)

Fecha y hora en que la actualización estuvo disponible por primera vez. Un valor cero indica que este campo no está configurado. Este campo solo se configura si hay una actualización disponible (es decir, updateStatus no es UPDATE_STATUS_UNKNOWN ni UP_TO_DATE).

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

HardwareInfo

Representación 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)
    }
  ]
}
Campos
brand

string

Marca del dispositivo. Por ejemplo, Google.
hardware

string

Nombre del hardware. Por ejemplo, Angler.
deviceBasebandVersion

string

Es la versión de banda base. Por ejemplo, MDM9625_104662.22.05.34p.
manufacturer

string

Fabricante Por ejemplo, Motorola.
serialNumber

string

Es el número de serie del dispositivo. Sin embargo, para los dispositivos personales que ejecutan Android 12 y versiones posteriores, es lo mismo que enterpriseSpecificId.
model

string

Modelo del dispositivo Por ejemplo, Asus Nexus 7.
batteryShutdownTemperatures[]

number

Son los umbrales de temperatura de apagado de la batería en grados Celsius para cada batería del dispositivo.
batteryThrottlingTemperatures[]

number

Son los umbrales de temperatura de regulación de la batería en grados Celsius para cada batería del dispositivo.
cpuShutdownTemperatures[]

number

Son los umbrales de temperatura de apagado de la CPU en grados Celsius para cada CPU del dispositivo.
cpuThrottlingTemperatures[]

number

Umbrales de temperatura de limitación de la CPU en grados Celsius para cada CPU del dispositivo.
gpuShutdownTemperatures[]

number

Son los umbrales de temperatura de apagado de la GPU en grados Celsius para cada GPU del dispositivo.
gpuThrottlingTemperatures[]

number

Son los umbrales de temperatura de regulación de la GPU en grados Celsius para cada GPU del dispositivo.
skinShutdownTemperatures[]

number

Son los umbrales de temperatura de apagado de la carcasa del dispositivo en grados Celsius.
skinThrottlingTemperatures[]

number

Son los umbrales de temperatura de estrangulamiento de la piel del dispositivo en grados Celsius.
enterpriseSpecificId

string

Solo salida. Es el ID que identifica de forma única un dispositivo personal en una organización específica. En el mismo dispositivo físico cuando se inscribe con la misma organización, este ID persiste en todas las configuraciones y hasta en los restablecimientos de la configuración de fábrica. Este ID está disponible en dispositivos personales con un perfil de trabajo que ejecutan Android 12 y versiones posteriores.
euiccChipInfo[]

object (EuiccChipInfo)

Solo salida. Es información relacionada con el chip de la eUICC.

EuiccChipInfo

Representación JSON 
{
  "eid": string
}
Campos
eid

string

Solo salida. Documento de identidad integrado (EID) que identifica el chip de la eUICC para cada chip de la eUICC del dispositivo. Esta función está disponible en dispositivos propiedad de la empresa que ejecutan Android 13 y versiones posteriores.

Display

Representación JSON 
{
  "name": string,
  "displayId": integer,
  "refreshRate": integer,
  "state": enum (DisplayState),
  "width": integer,
  "height": integer,
  "density": integer
}
Campos
name

string

Nombre de la pantalla.
displayId

integer

Es el ID único de la pantalla.
refreshRate

integer

Frecuencia de actualización de la pantalla en fotogramas por segundo.
state

enum (DisplayState)

Es el estado de la pantalla.
width

integer

Ancho de la pantalla en píxeles.
height

integer

Altura de la pantalla en píxeles.
density

integer

Es la densidad de pantalla expresada en puntos por pulgada.

ApplicationReport

Representación 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)
}
Campos
packageName

string

Es el nombre del paquete de la app.
versionName

string

Es la versión de la app que se muestra al usuario.
versionCode

integer

Es el código de versión de la app, que se puede usar para determinar si una versión es más reciente que otra.
events[]

object (ApplicationEvent)

Es la lista de eventos de la app que se produjeron en las últimas 30 horas.
displayName

string

Es el nombre visible de la app.
packageSha256Hash

string

Es el hash SHA-256 del archivo APK de la app, que se puede usar para verificar que la app no se haya modificado. Cada byte del valor hash se representa como un número hexadecimal de dos dígitos.
signingKeyCertFingerprints[]

string

Es el hash SHA-1 de cada android.content.pm.Signature asociado con el paquete de la app. Cada byte de cada valor de hash se representa como un número hexadecimal de dos dígitos.
installerPackageName

string

Es el nombre del paquete de la app que instaló esta app.
applicationSource

enum (ApplicationSource)

Es la fuente del paquete.
state

enum (ApplicationState)

Es el estado de la aplicación.
keyedAppStates[]

object (KeyedAppState)

Es la lista de estados de la app con clave que informa la app.
userFacingType

enum (UserFacingType)

Indica si la app está orientada al usuario.

ApplicationEvent

Representación JSON 
{
  "eventType": enum (ApplicationEventType),
  "createTime": string
}
Campos
eventType

enum (ApplicationEventType)

Es el tipo de evento de la aplicación.
createTime

string (Timestamp format)

Es la hora de creación del evento.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

KeyedAppState

Representación JSON 
{
  "key": string,
  "severity": enum (Severity),
  "message": string,
  "data": string,
  "createTime": string,
  "lastUpdateTime": string
}
Campos
key

string

Es la clave del estado de la app. Actúa como punto de referencia para el estado que proporciona la app. Por ejemplo, cuando se proporciona comentarios sobre la configuración administrada, esta clave podría ser la clave de configuración administrada.
severity

enum (Severity)

Es la gravedad del estado de la app.
message

string

Es una cadena de mensaje de formato libre opcional para explicar el estado de la app. Si el estado se activó por un valor en particular (p.ej., un valor de configuración administrada), se debe incluir en el mensaje.
data

string

Es un valor legible por máquina que el EMM puede leer de forma opcional. Por ejemplo, establecer valores con los que el administrador puede realizar consultas en la consola del EMM (p.ej., “Notifícame si los datos de battery_warning son inferiores a 10”).
createTime

string (Timestamp format)

Es la fecha y hora de creación del estado de la app en el dispositivo.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
lastUpdateTime

string (Timestamp format)

Fecha y hora en la que se actualizó el estado de la app por última vez.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

NetworkInfo

Representación JSON 
{
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperatorName": string,
  "telephonyInfos": [
    {
      object (TelephonyInfo)
    }
  ]
}
Campos
imei

string

Número de IMEI del dispositivo GSM. Por ejemplo, A1000031212.
meid

string

Número de MEID del dispositivo CDMA. Por ejemplo, A00000292788E1.
wifiMacAddress

string

Dirección MAC de Wi-Fi del dispositivo. Por ejemplo, 7c:11:11:11:11:11.
networkOperatorName
(deprecated)

string

Nombre alfabético del operador registrado actual. Por ejemplo, Vodafone.
telephonyInfos[]

object (TelephonyInfo)

Proporciona información de telefonía asociada a cada tarjeta SIM del dispositivo. Solo se admite en dispositivos completamente administrados a partir del nivel de API 23 de Android.

TelephonyInfo

Representación JSON 
{
  "phoneNumber": string,
  "carrierName": string,
  "iccId": string,
  "activationState": enum (ActivationState),
  "configMode": enum (ConfigMode)
}
Campos
phoneNumber

string

Es el número de teléfono asociado a esta tarjeta SIM.
carrierName

string

Es el nombre del operador asociado con esta tarjeta SIM.
iccId

string

Solo salida. Es el ICCID asociado con esta tarjeta SIM.
activationState

enum (ActivationState)

Solo salida. Es el estado de activación de la tarjeta SIM en el dispositivo. Esto solo se aplica a las eSIM. Esta función es compatible con todos los dispositivos para el nivel de API 35 y versiones posteriores. Siempre es ACTIVATION_STATE_UNSPECIFIED para las SIM físicas y para los dispositivos con un nivel de API inferior a 35.
configMode

enum (ConfigMode)

Solo salida. Es el modo de configuración de la tarjeta SIM en el dispositivo. Esto solo se aplica a las eSIM. Esta función es compatible con todos los dispositivos para el nivel de API 35 y versiones posteriores. Siempre es CONFIG_MODE_UNSPECIFIED para las SIM físicas y para los dispositivos con un nivel de API inferior a 35.

MemoryInfo

Representación JSON 
{
  "totalRam": string,
  "totalInternalStorage": string
}
Campos
totalRam

string (int64 format)

Es la RAM total del dispositivo en bytes.
totalInternalStorage

string (int64 format)

Es el almacenamiento interno total del dispositivo en bytes.

MemoryEvent

Representación JSON 
{
  "eventType": enum (MemoryEventType),
  "createTime": string,
  "byteCount": string
}
Campos
eventType

enum (MemoryEventType)

Es el tipo de evento.
createTime

string (Timestamp format)

Es la hora de creación del evento.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
byteCount

string (int64 format)

Cantidad de bytes libres en el medio o, para EXTERNAL_STORAGE_DETECTED, capacidad total en bytes del medio de almacenamiento.

PowerManagementEvent

Representación JSON 
{
  "eventType": enum (PowerManagementEventType),
  "createTime": string,
  "batteryLevel": number
}
Campos
eventType

enum (PowerManagementEventType)

Es el tipo de evento.
createTime

string (Timestamp format)

Es la hora de creación del evento.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
batteryLevel

number

Para los eventos de BATTERY_LEVEL_COLLECTED, el nivel de batería como porcentaje.

HardwareStatus

Representación JSON 
{
  "createTime": string,
  "batteryTemperatures": [
    number
  ],
  "cpuTemperatures": [
    number
  ],
  "gpuTemperatures": [
    number
  ],
  "skinTemperatures": [
    number
  ],
  "fanSpeeds": [
    number
  ],
  "cpuUsages": [
    number
  ]
}
Campos
createTime

string (Timestamp format)

Es la fecha y hora en que se tomaron las mediciones.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
batteryTemperatures[]

number

Temperaturas actuales de la batería en grados Celsius para cada batería del dispositivo.
cpuTemperatures[]

number

Temperaturas actuales de la CPU en grados Celsius para cada CPU del dispositivo.
gpuTemperatures[]

number

Temperaturas actuales de la GPU en grados Celsius para cada GPU del dispositivo.
skinTemperatures[]

number

Temperaturas cutáneas actuales del dispositivo en grados Celsius.
fanSpeeds[]

number

Velocidades del ventilador en RPM para cada ventilador del dispositivo. Un array vacío significa que no hay ventiladores o que el sistema no admite la velocidad del ventilador.
cpuUsages[]

number

Uso de CPU en porcentaje para cada núcleo disponible en el dispositivo. El uso es 0 para cada núcleo desconectado. Un array vacío implica que el uso de CPU no es compatible con el sistema.

DeviceSettings

Representación JSON 
{
  "isDeviceSecure": boolean,
  "unknownSourcesEnabled": boolean,
  "developmentSettingsEnabled": boolean,
  "adbEnabled": boolean,
  "isEncrypted": boolean,
  "encryptionStatus": enum (EncryptionStatus),
  "verifyAppsEnabled": boolean
}
Campos
isDeviceSecure

boolean

Indica si el dispositivo está protegido con un PIN o una contraseña.
unknownSourcesEnabled

boolean

Indica si está habilitada la instalación de apps desde fuentes desconocidas.
developmentSettingsEnabled

boolean

Indica si el modo de desarrollador está habilitado en el dispositivo.
adbEnabled

boolean

Indica si ADB está habilitado en el dispositivo.
isEncrypted

boolean

Indica si la encriptación de almacenamiento está habilitada.
encryptionStatus

enum (EncryptionStatus)

Es el estado de encriptación de DevicePolicyManager.
verifyAppsEnabled

boolean

Indica si se aplica la verificación de Google Play Protect en el dispositivo.

Usuario

Representación JSON 
{
  "accountIdentifier": string
}
Campos
accountIdentifier

string

Es un identificador único que creas para este usuario, como user342 o asset#44418. Este campo se debe establecer cuando se crea el usuario y no se puede actualizar. Este campo no debe contener información de identificación personal (PII). Este identificador debe tener 1,024 caracteres o menos. De lo contrario, fallará la solicitud de política de actualización.

SystemPropertiesEntry

Representación JSON 
{
  "key": string,
  "value": string
}
Campos
key

string
value

string

SecurityPosture

Representación JSON 
{
  "devicePosture": enum (DevicePosture),
  "postureDetails": [
    {
      object (PostureDetail)
    }
  ]
}
Campos
devicePosture

enum (DevicePosture)

Es el valor de la postura de seguridad del dispositivo.
postureDetails[]

object (PostureDetail)

Son detalles adicionales sobre la postura de seguridad del dispositivo.

PostureDetail

Representación JSON 
{
  "securityRisk": enum (SecurityRisk),
  "advice": [
    {
      object (UserFacingMessage)
    }
  ]
}
Campos
securityRisk

enum (SecurityRisk)

Es un riesgo de seguridad específico que afecta negativamente la postura de seguridad del dispositivo.
advice[]

object (UserFacingMessage)

Asesoramiento correspondiente para el administrador para mitigar este riesgo de seguridad y mejorar la postura de seguridad del dispositivo.

CommonCriteriaModeInfo

Representación JSON 
{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus),
  "policySignatureVerificationStatus": enum (PolicySignatureVerificationStatus)
}
Campos
commonCriteriaModeStatus

enum (CommonCriteriaModeStatus)

Indica si el modo Common Criteria está habilitado.
policySignatureVerificationStatus

enum (PolicySignatureVerificationStatus)

Solo salida. Es el estado de la verificación de la firma de la política.

PasswordRequirements

Representación 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)
}
Campos
passwordMinimumLength

integer

Es la longitud mínima permitida de la contraseña. Un valor de 0 significa que no hay restricciones. Solo se aplica cuando password_quality es NUMERIC, NUMERIC_COMPLEX, ALPHABETIC, ALPHANUMERIC o COMPLEX.
passwordMinimumLetters

integer

Cantidad mínima de letras requeridas en la contraseña. Solo se aplica cuando password_quality es COMPLEX.
passwordMinimumLowerCase

integer

Cantidad mínima de letras minúsculas requeridas en la contraseña. Solo se aplica cuando password_quality es COMPLEX.
passwordMinimumNonLetter

integer

Cantidad mínima de caracteres que no sean letras (dígitos numéricos o símbolos) requeridos en la contraseña. Solo se aplica cuando password_quality es COMPLEX.
passwordMinimumNumeric

integer

Cantidad mínima de dígitos numéricos requeridos en la contraseña. Solo se aplica cuando password_quality es COMPLEX.
passwordMinimumSymbols

integer

Cantidad mínima de símbolos requeridos en la contraseña. Solo se aplica cuando password_quality es COMPLEX.
passwordMinimumUpperCase

integer

Cantidad mínima de letras mayúsculas requeridas en la contraseña. Solo se aplica cuando password_quality es COMPLEX.
passwordQuality

enum (PasswordQuality)

Calidad de contraseña requerida.
passwordHistoryLength

integer

Es la longitud del historial de contraseñas. Después de configurar este campo, el usuario no podrá ingresar una contraseña nueva que sea igual a alguna contraseña del historial. Un valor de 0 significa que no hay restricciones.
maximumFailedPasswordsForWipe

integer

Cantidad de contraseñas incorrectas para desbloquear el dispositivo que se pueden ingresar antes de que se limpie el dispositivo. Un valor de 0 significa que no hay restricciones.
passwordExpirationTimeout

string (Duration format)

Es el tiempo de espera de caducidad de la contraseña.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".
passwordScope

enum (PasswordPolicyScope)

Es el alcance al que se aplica el requisito de contraseña.
requirePasswordUnlock

enum (RequirePasswordUnlock)

Es el período que transcurre después de que se desbloquea un dispositivo o un perfil de trabajo con una forma de autenticación sólida (contraseña, PIN, patrón) y durante el cual se puede desbloquear con cualquier otro método de autenticación (p.ej., huella dactilar, agentes de confianza, rostro). Una vez que transcurre el período especificado, solo se pueden usar formas sólidas de autenticación para desbloquear el dispositivo o el perfil de trabajo.
unifiedLockSettings

enum (UnifiedLockSettings)

Controla si se permite un bloqueo unificado para el dispositivo y el perfil de trabajo en dispositivos con Android 9 y versiones posteriores que tengan un perfil de trabajo. Solo se puede establecer si password_scope se establece como SCOPE_PROFILE; de lo contrario, se rechazará la política. Si el usuario no configuró un bloqueo de trabajo independiente y este campo está establecido en REQUIRE_SEPARATE_WORK_LOCK, se informa un NonComplianceDetail con nonComplianceReason establecido en USER_ACTION.

Duración

Representación JSON 
{
  "seconds": string,
  "nanos": integer
}
Campos
seconds

string (int64 format)

Son los segundos firmados del período. Debe estar entre -315,576,000,000 y +315,576,000,000, inclusive. Nota: Estos límites se calculan de la siguiente manera: 60 s/min * 60 min/h * 24 h/día * 365.25 días/año * 10,000 años.
nanos

integer

Fracciones firmadas de un segundo con una resolución de nanosegundos del período. Las duraciones inferiores a un segundo se representan con un campo seconds igual a 0 y un campo nanos positivo o negativo. Para duraciones de un segundo o más, un valor distinto de cero para el campo nanos debe tener el mismo signo que el campo seconds. Debe ser un valor entre -999,999,999 y +999,999,999, inclusive.

DpcMigrationInfo

Representación JSON 
{
  "previousDpc": string,
  "additionalData": string
}
Campos
previousDpc

string

Solo salida. Si este dispositivo se migró desde otro DPC, este es su nombre de paquete. De lo contrario, no se propaga.
additionalData

string

Solo salida. Si este dispositivo se migró desde otro DPC, aquí se completará el campo additionalData del token de migración.

DefaultApplicationInfo

Representación JSON 
{
  "defaultApplicationType": enum (DefaultApplicationType),
  "packageName": string,
  "defaultApplicationSettingAttempts": [
    {
      object (DefaultApplicationSettingAttempt)
    }
  ]
}
Campos
defaultApplicationType

enum (DefaultApplicationType)

Solo salida. Es el tipo de aplicación predeterminado.
packageName

string

Solo salida. Es el nombre del paquete de la aplicación predeterminada actual.
defaultApplicationSettingAttempts[]

object (DefaultApplicationSettingAttempt)

Solo salida. Son detalles sobre los intentos de configuración predeterminada de la aplicación, en el mismo orden en que se enumeran en defaultApplications.

DefaultApplicationSettingAttempt

Representación JSON 
{
  "packageName": string,
  "attemptOutcome": enum (AttemptOutcome)
}
Campos
packageName

string

Solo salida. Es el nombre del paquete de la aplicación que se intentó iniciar.
attemptOutcome

enum (AttemptOutcome)

Solo salida. Es el resultado de establecer la app como predeterminada.

Anotaciones de herramientas

Sugerencia destructiva: ❌ | Sugerencia idempotente: ✅ | Sugerencia de solo lectura: ✅ | Sugerencia de mundo abierto: ❌