REST Resource: enterprises.devices

Recurso: Device

Es un dispositivo que pertenece a una empresa. A menos que se indique lo contrario, todos los campos son de solo lectura y enterprises.devices.patch no los puede modificar.

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)
  }
}
Campos
name

string

Es el nombre del dispositivo con el formato enterprises/{enterpriseId}/devices/{deviceId}.

userName

string

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

managementMode

enum (ManagementMode)

El tipo de modo de administración que Android Device Policy adopta en el dispositivo. Esto influye en la configuración de la política admitida.

state

enum (DeviceState)

El estado que se aplicará al dispositivo. Este campo se puede modificar mediante 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 estado DELETED, llama a enterprises.devices.delete.

appliedState

enum (DeviceState)

El estado que se aplica actualmente al dispositivo.

policyCompliant

boolean

Si el dispositivo cumple con su política

nonComplianceDetails[]

object (NonComplianceDetail)

Detalles sobre la configuración de la política con la que el dispositivo no cumple.

enrollmentTime

string (Timestamp format)

La hora de inscripción del dispositivo.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

lastStatusReportTime

string (Timestamp format)

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

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

Obsoleta.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

lastPolicySyncTime

string (Timestamp format)

La última vez que el dispositivo recuperó su política.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

policyName

string

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

appliedPolicyName

string

El nombre de la política que se aplica actualmente al dispositivo.

appliedPolicyVersion

string (int64 format)

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

apiLevel

integer

El nivel de API de la versión de la plataforma de 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 mostrará un mensaje opcional en el dispositivo que indicará el motivo por el que está inhabilitado. Este campo se puede modificar mediante una solicitud de parche.

softwareInfo

object (SoftwareInfo)

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

hardwareInfo

object (HardwareInfo)

Información detallada sobre el hardware del dispositivo.

displays[]

object (Display)

Información detallada sobre las pantallas en el dispositivo. Esta información solo estará disponible si el valor de displayInfoEnabled es verdadero en la política del dispositivo.

applicationReports[]

object (ApplicationReport)

Informes de apps instaladas en el dispositivo Esta información solo está disponible cuando el valor de applicationReportsEnabled es verdadero en la política del dispositivo.

previousDeviceNames[]

string

Si el mismo dispositivo físico se inscribió varias veces, este campo contiene los 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 red del dispositivo Esta información solo estará disponible si el valor de 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 estará disponible si el valor de memoryInfoEnabled es verdadero en la política del dispositivo.

Los eventos se conservan durante un período determinado y se borran los anteriores.

powerManagementEvents[]

object (PowerManagementEvent)

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

hardwareStatusSamples[]

object (HardwareStatus)

Ejemplos de estado del hardware en orden cronológico. Esta información solo estará disponible si el valor de hardwareStatusEnabled es verdadero en la política del dispositivo.

deviceSettings

object (DeviceSettings)

Información de la configuración del dispositivo. Esta información solo estará disponible si el valor de deviceSettingsEnabled es verdadero en la política del dispositivo.

user

object (User)

El usuario propietario del dispositivo.

systemProperties

map (key: string, value: string)

Mapa de las propiedades del sistema seleccionadas y su valor relacionados con el dispositivo. Esta información solo estará disponible si el valor de systemPropertiesEnabled es verdadero en la política del dispositivo.

Es 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 postura de seguridad del dispositivo que refleja la seguridad del dispositivo.

ownership

enum (Ownership)

Es la propiedad del dispositivo administrado.

commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

Información sobre el modo Common Criteria: estándares de seguridad definidos en los Common Criteria para la evaluación de la seguridad de la tecnología de la información (CC).

Esta información solo está disponible si statusReportingSettings.commonCriteriaModeEnabled es true en la política del dispositivo, el cual es propiedad de la empresa.

appliedPasswordPolicies[]

object (PasswordRequirements)

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

  • En algunos casos, los requisitos aplicados pueden diferir ligeramente de los especificados en passwordPolicies.
  • fieldPath se configuró en función de passwordPolicies.
dpcMigrationInfo

object (DpcMigrationInfo)

Solo salida. Información relacionada con si este dispositivo se migró para dejar de ser administrado por otro controlador de política de dispositivo (DPC).

DeviceState

Estados que se pueden aplicar a un dispositivo.

Enumeraciones
DEVICE_STATE_UNSPECIFIED No se permite este valor.
ACTIVE El dispositivo está activo.
DISABLED El dispositivo está inhabilitado.
DELETED Se borró el dispositivo. Una llamada a la API nunca devuelve este estado, pero se usa en el informe de estado final cuando el dispositivo confirma la eliminación. Si se borra el dispositivo mediante la llamada a la API, este estado se publica en Pub/Sub. Si el usuario borra el perfil de trabajo o restablece el dispositivo, el servidor no reconoce el estado del dispositivo.
PROVISIONING Se está aprovisionando el dispositivo. Los dispositivos inscritos recientemente permanecerán en este estado hasta que se les aplique una política.
LOST Se perdió el dispositivo. Este estado solo es posible en los dispositivos que pertenecen a la organización.
PREPARING_FOR_MIGRATION El dispositivo se está preparando para migrar a la API de Android Management. No es necesario que realices ninguna otra acción para que la migración continúe.
DEACTIVATED_BY_DEVICE_FINANCE Este es un dispositivo financiado que se “bloqueó” por el agente financiero. Esto significa que se aplicaron ciertas opciones de configuración de la política que limitan la funcionalidad del dispositivo hasta que se "desbloquee". por el agente financiero. El dispositivo seguirá aplicando la configuración de la política, excepto aquellas anuladas por el agente de financiación. Cuando el dispositivo está "bloqueado", el estado se informa en appliedState como DEACTIVATED_BY_DEVICE_FINANCE.

NonComplianceDetail

Proporciona detalles sobre el incumplimiento de una configuración de política.

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

El nombre de la configuración de la política. Este es el nombre de campo JSON de un campo Policy de nivel superior.

nonComplianceReason

enum (NonComplianceReason)

El motivo por el que el dispositivo no cumple con la configuración.

packageName

string

Es el nombre del paquete que indica qué aplicación no cumple con las políticas, si corresponde.

fieldPath

string

Para la configuración con campos anidados, si un campo anidado en particular no cumple con las políticas, esto especifica la ruta completa al campo infractor. La ruta de acceso se formatea de la misma manera que se haría referencia al campo JSON de la política en JavaScript, es decir: 1) En el caso de los campos de tipo de objeto, el nombre del campo va seguido de un punto y, luego, del nombre de un subcampo. 2) En el caso de los campos de tipo array, al nombre del campo le sigue el índice del array encerrado entre corchetes. Por ejemplo, para indicar un problema con el campo url en el campo externalData de la tercera aplicación, la ruta sería applications[2].externalData.url.

currentValue

value (Value format)

Si no se pudo aplicar la configuración de política, el valor actual de la configuración en el dispositivo.

installationFailureReason

enum (InstallationFailureReason)

Si se configura packageName y el motivo del incumplimiento es APP_NOT_INSTALLED o APP_NOT_UPDATED, la razón detallada por la que no se puede instalar o actualizar la app

specificNonComplianceReason

enum (SpecificNonComplianceReason)

El motivo específico de la política por el que el dispositivo no cumple con la configuración.

specificNonComplianceContext

object (SpecificNonComplianceContext)

Contexto adicional para specificNonComplianceReason.

InstallationFailureReason

Motivos por los que falla la instalación de una app

Enumeraciones
INSTALLATION_FAILURE_REASON_UNSPECIFIED No se permite este valor.
INSTALLATION_FAILURE_REASON_UNKNOWN Una condición desconocida impide que se instale la app. Algunas razones posibles son que el dispositivo no tiene suficiente almacenamiento, la conexión de red del dispositivo no es confiable o la instalación está tardando más de lo esperado. La instalación se volverá a intentar automáticamente.
IN_PROGRESS La instalación aún está en curso.
NOT_FOUND No se encontró la app en Play.
NOT_COMPATIBLE_WITH_DEVICE La app no es compatible con el dispositivo.
NOT_APPROVED El administrador no aprobó la app.
PERMISSIONS_NOT_ACCEPTED La app tiene permisos nuevos que el administrador no aceptó.
NOT_AVAILABLE_IN_COUNTRY La app no está disponible en el país del usuario.
NO_LICENSES_REMAINING No hay licencias disponibles para asignar al usuario.
NOT_ENROLLED La empresa ya no está inscrita en Google Play administrado o el administrador no aceptó las Condiciones del Servicio más recientes de Google Play administrado.
USER_INVALID El usuario ya no es válido. Es posible que el usuario se haya borrado o inhabilitado.
NETWORK_ERROR_UNRELIABLE_CONNECTION

Un error de red en el dispositivo del usuario impidió que la instalación se realizara correctamente. Por lo general, esto sucede cuando se degrada la conectividad a Internet del dispositivo, no está disponible o hay un problema de configuración de red. Asegúrate de que el dispositivo tenga acceso a una conexión a Internet completa en una red que cumpla con Android Enterprise Network Requirements. La instalación o actualización de apps se reanudará automáticamente una vez que esto ocurra.

INSUFFICIENT_STORAGE El dispositivo del usuario no tiene suficiente espacio de almacenamiento para instalar la app. Para resolver este problema, libera espacio de almacenamiento en el dispositivo. La instalación o actualización de apps se reanudará automáticamente una vez que el dispositivo tenga suficiente espacio de almacenamiento.

SpecificNonComplianceReason

Más detalles sobre el motivo por el que un dispositivo podría no cumplir con una configuración de política. Se podrán agregar valores nuevos a la enum en el futuro.

Enumeraciones
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED No se especifica el motivo específico del incumplimiento. No se configuraron los campos en specificNonComplianceContext.
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED El usuario debe confirmar las credenciales ingresando el bloqueo de pantalla. No se configuraron los campos en specificNonComplianceContext. nonComplianceReason se configura como USER_ACTION.
PASSWORD_POLICIES_PASSWORD_EXPIRED La contraseña del dispositivo o del perfil venció. Se estableció passwordPoliciesContext. nonComplianceReason se configura como USER_ACTION.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT La contraseña del dispositivo no cumple con los requisitos de contraseña. Se estableció passwordPoliciesContext. nonComplianceReason se configura como USER_ACTION.
ONC_WIFI_INVALID_VALUE Hay un valor incorrecto en la configuración de Wi-Fi de la ONC. fieldPath especifica qué valor de campo es incorrecto. Se estableció oncWifiContext. nonComplianceReason se configura como INVALID_VALUE.
ONC_WIFI_API_LEVEL El parámetro de configuración Wi-Fi de ONC no es compatible con el nivel de API de la versión de Android que se ejecuta en el dispositivo. fieldPath especifica qué valor de campo no es compatible. Se estableció oncWifiContext. nonComplianceReason se configura como API_LEVEL.
ONC_WIFI_INVALID_ENTERPRISE_CONFIG Falta la AC raíz o el nombre de dominio en la red Wi-Fi empresarial. nonComplianceReason se configura en INVALID_VALUE.
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK El usuario debe quitar manualmente la red Wi-Fi configurada. Esto solo se aplica a perfiles de trabajo en dispositivos de propiedad personal. nonComplianceReason se configura en USER_ACTION.
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY El alias del par de claves especificado a través del campo ClientCertKeyPairAlias en openNetworkConfiguration no corresponde a una clave existente instalada en el dispositivo. nonComplianceReason se configura como INVALID_VALUE.

SpecificNonComplianceContext

Contexto adicional para SpecificNonComplianceReason.

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

object (OncWifiContext)

Contexto adicional para los incumplimientos relacionados con la configuración de Wi-Fi. Ver ONC_WIFI_INVALID_VALUE y ONC_WIFI_API_LEVEL

passwordPoliciesContext

object (PasswordPoliciesContext)

Contexto adicional para los incumplimientos relacionados con las políticas de contraseñas. Consulta PASSWORD_POLICIES_PASSWORD_EXPIRED y PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT.

OncWifiContext

Contexto adicional para los incumplimientos relacionados con la configuración de Wi-Fi.

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

string

El GUID de la configuración de Wi-Fi que no cumple con las políticas.

PasswordPoliciesContext

Contexto adicional para los incumplimientos relacionados con las políticas de contraseñas.

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

enum (PasswordPolicyScope)

El alcance de la contraseña que no cumple con las políticas.

SoftwareInfo

Información sobre el software del dispositivo.

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

El código de versión de la app Android Device Policy.

androidDevicePolicyVersionName

string

La versión de la app Android Device Policy como se le muestra al usuario.

androidBuildNumber

string

Cadena de ID de compilación de Android diseñada para mostrarse al usuario Por ejemplo, shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys.

deviceKernelVersion

string

Versión de kernel, por ejemplo, 2.6.32.9-g103d848

bootloaderVersion

string

El número de versión del bootloader del sistema, p.ej., 0.6.7

androidBuildTime

string (Timestamp format)

Tiempo de compilación

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

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

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)

Información sobre una posible actualización pendiente del sistema.

SystemUpdateInfo

Información sobre una posible actualización pendiente del sistema.

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

enum (UpdateStatus)

El estado de una actualización, es decir, si existe y de qué tipo es.

updateReceivedTime

string (Timestamp format)

Indica la 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 establece si hay una actualización disponible (es decir, updateStatus no es UPDATE_STATUS_UNKNOWN ni UP_TO_DATE).

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

UpdateStatus

El estado de una actualización, es decir, si existe y de qué tipo es.

Enumeraciones
UPDATE_STATUS_UNKNOWN Se desconoce si hay una actualización del sistema pendiente. Esto sucede, por ejemplo, cuando el nivel de API del dispositivo es inferior al 26, o si la versión de Android Device Policy está desactualizada.
UP_TO_DATE No hay ninguna actualización del sistema pendiente disponible en el dispositivo.
UNKNOWN_UPDATE_AVAILABLE Hay una actualización del sistema pendiente disponible, pero se desconoce su tipo.
SECURITY_UPDATE_AVAILABLE Hay una actualización de seguridad pendiente disponible.
OS_UPDATE_AVAILABLE Hay una actualización pendiente del SO disponible.

HardwareInfo

Información sobre el hardware del dispositivo. Los campos relacionados con los umbrales de temperatura solo están disponibles si el valor de hardwareStatusEnabled es verdadero en la política del dispositivo.

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
}
Campos
brand

string

Es la marca del dispositivo. Por ejemplo, Google.

hardware

string

Nombre del hardware. Por ejemplo, Angler.

deviceBasebandVersion

string

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.

model

string

Indica el modelo del dispositivo. Por ejemplo, Asus Nexus 7.

batteryShutdownTemperatures[]

number

Los umbrales de temperatura de apagado de la batería en Celsius para cada batería del dispositivo.

batteryThrottlingTemperatures[]

number

Umbrales de temperatura de limitación de la batería en Celsius para cada batería del dispositivo

cpuShutdownTemperatures[]

number

Los umbrales de temperatura de apagado de la CPU en Celsius para cada CPU en el dispositivo.

cpuThrottlingTemperatures[]

number

Umbrales de temperatura de limitación de la CPU en Celsius para cada CPU del dispositivo.

gpuShutdownTemperatures[]

number

Los umbrales de temperatura de apagado de la GPU en Celsius para cada GPU del dispositivo.

gpuThrottlingTemperatures[]

number

Los umbrales de temperatura de limitación de la GPU en Celsius para cada GPU del dispositivo.

skinShutdownTemperatures[]

number

Los umbrales de temperatura de apagado de la máscara del dispositivo en grados Celsius.

skinThrottlingTemperatures[]

number

Umbrales de temperatura de limitación de la piel del dispositivo en Celsius.

enterpriseSpecificId

string

Solo salida. ID que identifica de manera inequívoca un dispositivo de propiedad personal en una organización determinada. En el mismo dispositivo físico, cuando está inscrito en la misma organización, este ID persiste en todas las configuraciones y hasta cuando se restablece la configuración de fábrica. Este ID está disponible en dispositivos personales con perfil de trabajo en dispositivos que ejecutan Android 12 y versiones posteriores.

Display

Información sobre la pantalla del dispositivo.

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

string

Es el nombre de la pantalla.

displayId

integer

ID visible único

refreshRate

integer

Es la frecuencia de actualización de la pantalla en fotogramas por segundo.

state

enum (DisplayState)

Estado de la pantalla.

width

integer

Es el ancho de la pantalla en píxeles.

height

integer

Indica la altura de la pantalla en píxeles.

density

integer

Es la densidad de la pantalla expresada como puntos por pulgada.

DisplayState

Es el estado de una pantalla.

Enumeraciones
DISPLAY_STATE_UNSPECIFIED No se permite este valor.
OFF La pantalla está apagada.
ON La pantalla está encendida.
DOZE La pantalla adormece cuando el dispositivo tiene poca batería
SUSPENDED La pantalla está adornada en estado de suspensión de bajo consumo.

ApplicationReport

Información que se informa sobre una app instalada.

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 de paquete de la app.

versionName

string

La versión de la app tal como se le muestra al usuario.

versionCode

integer

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 ocurrieron en las últimas 30 horas.

displayName

string

El nombre visible de la app.

packageSha256Hash

string

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

signingKeyCertFingerprints[]

string

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)

Estado de la aplicación.

keyedAppStates[]

object (KeyedAppState)

Lista de estados de app con clave que informó la app.

userFacingType

enum (UserFacingType)

Si la app está orientada al usuario

ApplicationEvent

Un evento relacionado con la app

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

enum (ApplicationEventType)

Tipo de evento de la aplicación.

createTime

string (Timestamp format)

Hora de creación del evento.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

ApplicationEventType

Es un tipo de evento relacionado con la app.

Enumeraciones
APPLICATION_EVENT_TYPE_UNSPECIFIED No se permite este valor.
INSTALLED Se instaló la app.
CHANGED Se cambió la app; por ejemplo, se habilitó o inhabilitó un componente.
DATA_CLEARED Se borraron los datos de la app.
REMOVED Se quitó la app.
REPLACED Se instaló una nueva versión de la app que reemplaza a la anterior.
RESTARTED Se reinició la app.
PINNED La app se fijó en primer plano.
UNPINNED Se dejó de fijar la app.

ApplicationSource

Es la fuente que proporcionó una app.

Enumeraciones
APPLICATION_SOURCE_UNSPECIFIED La app se transfirió desde una fuente no especificada.
SYSTEM_APP_FACTORY_VERSION Esta es una app del sistema que se obtiene de la imagen de fábrica del dispositivo.
SYSTEM_APP_UPDATED_VERSION Esta es una app del sistema actualizada.
INSTALLED_FROM_PLAY_STORE La app se instaló desde Google Play Store.

ApplicationState

El estado de la instalación actual.

Enumeraciones
APPLICATION_STATE_UNSPECIFIED No se especificó el estado de la app
REMOVED Se quitó la app del dispositivo
INSTALLED La app está instalada en el dispositivo

KeyedAppState

Estado de la app con clave que informa la app.

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

string

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

severity

enum (Severity)

La gravedad del estado de la app.

message

string

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

data

string

De forma opcional, un valor legible por máquina para que lo lea la EMM. Por ejemplo, establecer valores sobre los que el administrador puede elegir realizar consultas en la consola de EMM (p.ej., “notificarme si los datos de Battery_warning < 10”).

createTime

string (Timestamp format)

La hora de creación del estado de la app en el dispositivo.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

lastUpdateTime

string (Timestamp format)

La hora a la que se actualizó el estado de la app más recientemente.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

Gravedad

La gravedad del estado de la app.

Enumeraciones
SEVERITY_UNSPECIFIED Nivel de gravedad no especificado.
INFO Nivel de gravedad de la información.
ERROR Nivel de gravedad del error. Esto solo se debe establecer para condiciones de error genuinas que una organización de administración debe tomar medidas para solucionar.

UserFacingType

Si la app está orientada al usuario

Enumeraciones
USER_FACING_TYPE_UNSPECIFIED No se especifica el tipo de usuario de la app.
NOT_USER_FACING La app no está orientada al usuario.
USER_FACING La app está orientada al usuario.

NetworkInfo

Información de la red del dispositivo

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 MEID del dispositivo CDMA. Por ejemplo, A00000292788E1.

wifiMacAddress

string

Es la 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 es compatible con dispositivos completamente administrados a partir del nivel de API 23 de Android.

TelephonyInfo

Información de telefonía asociada a una tarjeta SIM determinada del dispositivo. Solo es compatible con dispositivos completamente administrados a partir del nivel de API 23 de Android.

Representación JSON
{
  "phoneNumber": string,
  "carrierName": string
}
Campos
phoneNumber

string

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

carrierName

string

Indica el nombre del operador asociado con esta tarjeta SIM.

MemoryInfo

Información sobre la memoria y el almacenamiento del dispositivo.

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

string (int64 format)

Total de RAM del dispositivo en bytes.

totalInternalStorage

string (int64 format)

Almacenamiento interno total en el dispositivo, expresado en bytes.

MemoryEvent

Un evento relacionado con la memoria y las mediciones del almacenamiento.

Para distinguir entre eventos nuevos y antiguos, recomendamos usar el campo createTime.

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

enum (MemoryEventType)

Tipo de evento.

createTime

string (Timestamp format)

Hora de creación del evento.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

byteCount

string (int64 format)

La cantidad de bytes libres en el medio o, en el caso de EXTERNAL_STORAGE_DETECTED, la capacidad total en bytes del medio de almacenamiento.

MemoryEventType

El tipo de evento

Enumeraciones
MEMORY_EVENT_TYPE_UNSPECIFIED Sin especificar. Ningún evento tiene este tipo.
RAM_MEASURED Se midió el espacio libre en RAM.
INTERNAL_STORAGE_MEASURED Se midió el espacio libre en el almacenamiento interno.
EXTERNAL_STORAGE_DETECTED Se detectó un nuevo medio de almacenamiento externo. El recuento de bytes informado es la capacidad total del medio de almacenamiento.
EXTERNAL_STORAGE_REMOVED Se eliminó un medio de almacenamiento externo. El recuento de bytes informado es cero.
EXTERNAL_STORAGE_MEASURED Se midió el espacio libre en un medio de almacenamiento externo.

PowerManagementEvent

Un evento de administración de energía.

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

enum (PowerManagementEventType)

Tipo de evento.

createTime

string (Timestamp format)

Hora de creación del evento.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

batteryLevel

number

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

PowerManagementEventType

El tipo de evento

Enumeraciones
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED Sin especificar. Ningún evento tiene este tipo.
BATTERY_LEVEL_COLLECTED Se midió el nivel de batería.
POWER_CONNECTED El dispositivo comenzó a cargarse.
POWER_DISCONNECTED El dispositivo dejó de cargarse.
BATTERY_LOW El dispositivo ingresó al modo de bajo consumo.
BATTERY_OKAY El dispositivo salió del modo de bajo consumo.
BOOT_COMPLETED Se inició el dispositivo.
SHUTDOWN Se apagó el dispositivo.

HardwareStatus

Estado del hardware. Es posible que se comparen las temperaturas con los umbrales de temperatura disponibles en hardwareInfo para determinar el estado del hardware.

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

string (Timestamp format)

Es la hora en que se tomaron las mediciones.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".

batteryTemperatures[]

number

Temperaturas actuales de la batería en Celsius para cada batería del dispositivo.

cpuTemperatures[]

number

Temperaturas actuales de la CPU en Celsius para cada CPU del dispositivo.

gpuTemperatures[]

number

Temperaturas actuales de la GPU en Celsius para cada GPU del dispositivo.

skinTemperatures[]

number

Temperaturas cutáneas actuales del dispositivo en grados Celsius.

fanSpeeds[]

number

Velocidades de los ventiladores en RPM para cada ventilador del dispositivo Un array vacío significa que no hay ventiladores o que la velocidad del ventilador no es compatible con el sistema.

cpuUsages[]

number

Porcentajes de usos de CPU de cada núcleo disponible en el dispositivo. El uso es 0 para cada núcleo desconectado. Un array vacío implica que el sistema no admite el uso de CPU.

DeviceSettings

Información sobre la configuración del dispositivo relacionada con la seguridad.

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 de fuentes desconocidas.

developmentSettingsEnabled

boolean

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)

Estado de la encriptación de DevicePolicyManager.

verifyAppsEnabled

boolean

Si la verificación de Google Play Protect se aplica de manera forzosa en el dispositivo

EncryptionStatus

Estado de encriptación de un dispositivo.

Enumeraciones
ENCRYPTION_STATUS_UNSPECIFIED Sin especificar. Ningún dispositivo debe tener este tipo.
UNSUPPORTED El dispositivo no admite la encriptación.
INACTIVE El dispositivo admite la encriptación, pero no está activa actualmente.
ACTIVATING La encriptación no está activa en este momento, pero se está activando.
ACTIVE La encriptación está activa.
ACTIVE_DEFAULT_KEY La encriptación está activa, pero el usuario no estableció una clave de encriptación.
ACTIVE_PER_USER La encriptación está activa y la clave está vinculada al perfil del usuario.

SecurityPosture

La postura de seguridad del dispositivo, según lo determinado por el estado actual del dispositivo y las políticas aplicadas.

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

enum (DevicePosture)

Valor de posición de seguridad del dispositivo.

postureDetails[]

object (PostureDetail)

Son los detalles adicionales sobre la postura de seguridad del dispositivo.

DevicePosture

Posibles valores de postura de seguridad de un dispositivo administrado.

Enumeraciones
POSTURE_UNSPECIFIED Sin especificar. No hay detalles de postura para este valor de postura.
SECURE Este dispositivo es seguro.
AT_RISK Este dispositivo puede ser más vulnerable a agentes maliciosos de lo que se recomienda para su uso con datos corporativos.
POTENTIALLY_COMPROMISED Es posible que este dispositivo esté comprometido y que agentes no autorizados puedan acceder a los datos corporativos.

PostureDetail

Son los detalles adicionales sobre la postura de seguridad del dispositivo.

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)

Los consejos del administrador que correspondan para mitigar este riesgo de seguridad y mejorar la postura de seguridad del dispositivo.

SecurityRisk

El riesgo que hace que el dispositivo no se encuentre en el estado más seguro.

Enumeraciones
SECURITY_RISK_UNSPECIFIED Sin especificar.
UNKNOWN_OS La API de Play Integrity detecta que el dispositivo ejecuta un SO desconocido (la verificación debasicIntegrity se realiza correctamente, pero ctsProfileMatch falla).
COMPROMISED_OS La API de Play Integrity detecta que el dispositivo ejecuta un SO comprometido (falla la verificación debasicIntegrity).
HARDWARE_BACKED_EVALUATION_FAILED La API de Play Integrity detecta que el dispositivo no tiene una garantía sólida de integridad del sistema si no se muestra la etiqueta MEETS_STRONG_INTEGRITY en el campo de integridad del dispositivo.

CommonCriteriaModeInfo

Información sobre el modo Common Criteria: estándares de seguridad definidos en los Common Criteria para la evaluación de la seguridad de la tecnología de la información (CC).

Esta información solo estará disponible si statusReportingSettings.commonCriteriaModeEnabled está true en la política del dispositivo.

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

enum (CommonCriteriaModeStatus)

Si el modo Common Criteria está habilitado.

CommonCriteriaModeStatus

Si el modo Common Criteria está habilitado.

Enumeraciones
COMMON_CRITERIA_MODE_STATUS_UNKNOWN Estado desconocido.
COMMON_CRITERIA_MODE_DISABLED El modo Common Criteria está inhabilitado en este momento.
COMMON_CRITERIA_MODE_ENABLED El modo Common Criteria está habilitado.

DpcMigrationInfo

Información relacionada con si este dispositivo se migró para dejar de ser administrado por otro controlador de política de dispositivo (DPC).

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

string

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

additionalData

string

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

Métodos

delete

Borra un dispositivo.

get

Obtiene un dispositivo.

issueCommand

Emite un comando a un dispositivo.

list

Muestra una lista de los dispositivos de una empresa determinada.

patch

Actualiza un dispositivo.