REST Resource: enterprises.devices

Recurso: Dispositivo

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

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

string

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

string

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

enum (ManagementMode)

Es 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 que se admite.
state

enum (DeviceState)

Es 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 ingresar al dispositivo en un estado DELETED, llama a enterprises.devices.delete.
appliedState

enum (DeviceState)

Es 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 política con la que el dispositivo no cumple.
enrollmentTime

string (Timestamp format)

Es la hora de la inscripción del dispositivo.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con 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 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)

Ya no está disponible.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con 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)

Corresponde a la última vez que el dispositivo recuperó su política.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con 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. El resto del nombre de la política se infiere.
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

Es 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 al que se proporcionaron datos adicionales, este campo los contendrá.
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 se inhabilitó el dispositivo. 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 está disponible si 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 los elementos que se muestran en el dispositivo Esta información solo está disponible si displayInfoEnabled es verdadero en la política del dispositivo.
applicationReports[]

object (ApplicationReport)

Informes de aplicaciones instaladas en el dispositivo Esta información solo está disponible cuando 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 del dispositivo. 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 sobre 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 sobre 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.
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)

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)

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)

Mapa del nombre y el valor de las propiedades del sistema seleccionadas relacionados con el dispositivo. Esta información solo está disponible si 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)

El valor de la postura de seguridad del dispositivo que refleja su nivel de seguridad.
ownership

enum (Ownership)

Propiedad del dispositivo administrado
commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

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

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

object (PasswordRequirements)

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

  • En algunos casos, los requisitos aplicados pueden diferir un poco de los especificados en passwordPolicies.
  • fieldPath se establece en función de passwordPolicies.

DeviceState

Estados que se pueden aplicar a un dispositivo.

Enumeradores
DEVICE_STATE_UNSPECIFIED Este valor no está permitido.
ACTIVE El dispositivo está activo.
DISABLED El dispositivo está inhabilitado.
DELETED Se borró el dispositivo. Una llamada a la API nunca muestra 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 conocerá el estado del dispositivo.
PROVISIONING Se está aprovisionando el dispositivo. Los dispositivos inscritos recientemente permanecerán en este estado hasta que se aplique una política.
LOST Se perdió el dispositivo. Este estado solo es posible en dispositivos que pertenecen a la organización.

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 política. Este 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 la configuración.
packageName

string

Es el nombre del paquete que indica qué app no cumple con las políticas (si corresponde).
fieldPath

string

En el caso de la configuración con campos anidados, si un campo anidado específico no cumple con las políticas, esta opción especifica la ruta completa al campo ofensivo. La ruta de acceso tiene el mismo formato que se haría referencia al campo de la política JSON en JavaScript, es decir: 1) Para los campos de tipo 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 de array, el nombre del campo va seguido del índice de 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, el motivo detallado por el que la app no se puede instalar ni actualizar.
specificNonComplianceReason

enum (SpecificNonComplianceReason)

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

object (SpecificNonComplianceContext)

Contexto adicional para specificNonComplianceReason.

InstallationFailureReason

Motivos por los que puede fallar la instalación de una app

Enumeradores
INSTALLATION_FAILURE_REASON_UNSPECIFIED Este valor no está permitido.
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 se haya borrado o inhabilitado al usuario.
NETWORK_ERROR_UNRELIABLE_CONNECTION

Un error de red en el dispositivo del usuario impidió que la instalación se realizara correctamente. Esto suele suceder cuando la conectividad a Internet del dispositivo se degrada, no está disponible o hay un problema con la configuración de red. Asegúrate de que el dispositivo tenga acceso a una conectividad total a Internet en una red que cumpla con Android Enterprise Network Requirements. Cuando esto ocurra, la instalación o actualización de la app se reanudará automáticamente.
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 cuando 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 pueden agregar valores nuevos a la enumeración en el futuro.

Enumeradores
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. El valor de nonComplianceReason se estableció en USER_ACTION.
PASSWORD_POLICIES_PASSWORD_EXPIRED La contraseña del dispositivo o perfil venció. Se estableció passwordPoliciesContext. El valor de nonComplianceReason se estableció en USER_ACTION.
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT La contraseña del dispositivo no cumple con los requisitos de contraseña. Se estableció passwordPoliciesContext. El valor de nonComplianceReason se estableció en 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. El valor de nonComplianceReason se estableció en INVALID_VALUE.
ONC_WIFI_API_LEVEL La configuración de 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 se admite. Se estableció oncWifiContext. El valor de nonComplianceReason se estableció en API_LEVEL.
ONC_WIFI_INVALID_ENTERPRISE_CONFIG Falta la CA raíz o el nombre de dominio en la red Wi-Fi de la empresa. nonComplianceReason se configura en 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. Consulta 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

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

string

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

string

Es la 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

Es 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 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 la compilación del sistema no se haya modificado.
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 no se estableció este campo. Este campo se configura solo 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 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.

Enumeradores
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 a 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 de SO pendiente disponible.

HardwareInfo

Información sobre el hardware del dispositivo. Los campos relacionados con los umbrales de temperatura solo están disponibles si 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

Marca del dispositivo. Por ejemplo, Google.
hardware

string

Es el 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

Es el modelo del dispositivo. Por ejemplo, Asus Nexus 7.
batteryShutdownTemperatures[]

number

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

number

Umbrales de temperatura de limitación de batería en grados Celsius para cada batería del dispositivo.
cpuShutdownTemperatures[]

number

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 CPU en grados Celsius para cada CPU del dispositivo.
gpuShutdownTemperatures[]

number

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

number

Umbrales de temperatura de limitación de GPU en grados Celsius para cada GPU del dispositivo.
skinShutdownTemperatures[]

number

Umbrales de temperatura de apagado del dispositivo en grados Celsius.
skinThrottlingTemperatures[]

number

Umbrales de temperatura de limitación cutánea del dispositivo en grados Celsius
enterpriseSpecificId

string

Solo salida. ID que identifica de forma exclusiva 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 en los restablecimientos de la configuración de fábrica. Este ID está disponible en dispositivos de propiedad personal con un perfil de trabajo en dispositivos con Android 12 y versiones posteriores.

Display

Información sobre la visualización 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 de pantalla único.
refreshRate

integer

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

enum (DisplayState)

Estado de la pantalla.
width

integer

Muestra el ancho en píxeles.
height

integer

Muestra la altura en píxeles.
density

integer

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

DisplayState

Es el estado de una pantalla.

Enumeradores
DISPLAY_STATE_UNSPECIFIED Este valor no está permitido.
OFF La pantalla está apagada.
ON La pantalla está encendida.
DOZE La pantalla está dormida en estado de bajo consumo
SUSPENDED La pantalla está apagada en un estado de bajo consumo suspendido.

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

string

Es la versión de la app tal como se 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)

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 la app no se haya modificado. 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)

Es la lista de estados de la app con clave informados por la app.
userFacingType

enum (UserFacingType)

Si la app está para el 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 app.
createTime

string (Timestamp format)

La hora de creación del evento.

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

ApplicationEventType

Un tipo de evento relacionado con la app.

Enumeradores
APPLICATION_EVENT_TYPE_UNSPECIFIED Este valor no está permitido.
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 la anterior.
RESTARTED Se reinició la app.
PINNED La app se fijó en primer plano.
UNPINNED Se dejó de fijar la app.

ApplicationSource

La fuente que proporcionó una app.

Enumeradores
APPLICATION_SOURCE_UNSPECIFIED La app se transfirió desde una fuente no especificada.
SYSTEM_APP_FACTORY_VERSION Esta es una app del sistema 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 actual de la instalación.

Enumeradores
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 informado por la app

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

string

La clave para el estado de la app. Funciona como punto de referencia para lo que la app proporciona el estado. Por ejemplo, cuando se proporcionen comentarios de configuración administrada, esta clave podría ser la de configuración administrada.
severity

enum (Severity)

La gravedad del estado de la app.
message

string

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

string

De manera opcional, un valor procesable que leerá el EMM. Por ejemplo, configurar valores que el administrador puede elegir consultar 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 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 en la que se actualizó el estado de la app más recientemente.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con 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.

Enumeradores
SEVERITY_UNSPECIFIED Nivel de gravedad sin especificar.
INFO Nivel de gravedad de la información.
ERROR Nivel de gravedad del error. Esto solo debe establecerse para condiciones de error reales que una organización de administración debe tomar medidas para solucionar.

UserFacingType

Si la app está para el usuario

Enumeradores
USER_FACING_TYPE_UNSPECIFIED No se especificó el tipo orientado al 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 sobre 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 en alfabeto del operador registrado actual Por ejemplo, Vodafone.
telephonyInfos[]

object (TelephonyInfo)

Proporciona información telefónica asociada con 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 con una tarjeta SIM determinada en el 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

El número de teléfono asociado con esta tarjeta SIM.
carrierName

string

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)

RAM total en el dispositivo expresada en bytes.
totalInternalStorage

string (int64 format)

Almacenamiento total interno del dispositivo expresado en bytes.

MemoryEvent

Un evento relacionado con las mediciones de memoria y almacenamiento.

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

enum (MemoryEventType)

Tipo de evento.
createTime

string (Timestamp format)

La hora de creación del evento.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con 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

Enumeradores
MEMORY_EVENT_TYPE_UNSPECIFIED No se especifica. 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 quitó 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)

La hora de creación del evento.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con 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

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

PowerManagementEventType

El tipo de evento

Enumeradores
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED No se especifica. 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 entró en el 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 realizaron las mediciones.

Una marca de tiempo en formato RFC3339 UTC "Zulú", con 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 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

Temperatura actual de la piel del dispositivo en grados Celsius.
fanSpeeds[]

number

Velocidades de los ventiladores en RPM para cada ventilador del dispositivo Si el array está vacío, significa que no hay ventiladores ni que no se admite su velocidad en el sistema.
cpuUsages[]

number

Porcentajes de uso de CPU para cada núcleo disponible en el dispositivo. El uso es 0 para cada núcleo desconectado. Si un array está vacío, significa que el sistema no admite el uso de CPU.

DeviceSettings

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

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 PIN/contraseña.
unknownSourcesEnabled

boolean

Indica si está habilitada la instalación de apps de 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)

Estado de encriptación de DevicePolicyManager
verifyAppsEnabled

boolean

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

EncryptionStatus

Estado de encriptación de un dispositivo.

Enumeradores
ENCRYPTION_STATUS_UNSPECIFIED No se especifica. Ningún dispositivo debería tener este tipo.
UNSUPPORTED El dispositivo no admite la encriptación.
INACTIVE El dispositivo admite la encriptación, pero no está activa por el momento.
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 de encriptación 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 la postura de seguridad del dispositivo.
postureDetails[]

object (PostureDetail)

Detalles adicionales sobre la postura de seguridad del dispositivo.

DevicePosture

Posibles valores de postura de seguridad de un dispositivo administrado.

Enumeradores
POSTURE_UNSPECIFIED No se especifica. No hay detalles de la postura para este valor de postura.
SECURE Este dispositivo es seguro.
AT_RISK Es posible que este dispositivo sea más vulnerable a actores maliciosos de lo que se recomienda para su uso con datos corporativos.
POTENTIALLY_COMPROMISED Es posible que este dispositivo esté comprometido y que personas no autorizadas tengan acceso a los datos corporativos.

PostureDetail

Detalles adicionales sobre la postura de seguridad del dispositivo.

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

enum (SecurityRisk)

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

object (UserFacingMessage)

Consejos de los administradores correspondientes 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.

Enumeradores
SECURITY_RISK_UNSPECIFIED No se especifica.
UNKNOWN_OS SafetyNet detecta que el dispositivo está ejecutando un SO desconocido (la verificación de BasicIntegrity se realiza correctamente, pero ctsProfileMatch falla).
COMPROMISED_OS SafetyNet detecta que el dispositivo está ejecutando un SO comprometido (falla la verificación básica de integridad).
HARDWARE_BACKED_EVALUATION_FAILED SafetyNet detecta que el dispositivo no tiene una garantía sólida de integridad del sistema (por ejemplo, un almacén de claves con copia de seguridad en hardware).

CommonCriteriaModeInfo

Información sobre el modo Common Criteria: estándares de seguridad definidos en los Criterios comunes para la evaluación de 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.

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

enum (CommonCriteriaModeStatus)

Indica si está habilitado el modo Common Criteria.

CommonCriteriaModeStatus

Indica si está habilitado el modo Common Criteria.

Enumeradores
COMMON_CRITERIA_MODE_STATUS_UNKNOWN Estado desconocido.
COMMON_CRITERIA_MODE_DISABLED En este momento, el modo Common Criteria está inhabilitado.
COMMON_CRITERIA_MODE_ENABLED En este momento, el modo Common Criteria está habilitado.

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.