REST Resource: enterprises.devices

Recurso: Dispositivo

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 pueden 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)
    }
  ],
  "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 que posee este dispositivo con el formato enterprises/{enterpriseId}/users/{userId}.

managementMode

enum (ManagementMode)

El tipo de modo de administración que Android Device Policy toma en el dispositivo. Esto influye en qué parámetros de configuración de las políticas se admiten.

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 estado DELETED en el dispositivo, 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 la política con la que el dispositivo no cumple con los requisitos.

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)

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 que se aplicó al dispositivo, en 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 diagonales. 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 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 se inhabilitó. 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 las pantallas en el dispositivo. Esta información solo está disponible si displayInfoEnabled es verdadero en la política del dispositivo.

applicationReports[]

object (ApplicationReport)

Informes de las apps 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 de dispositivos anteriores. El número de serie se utiliza 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.

Los eventos se retienen por un período determinado y se borran los eventos antiguos.

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 de 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 postura de seguridad del dispositivo que refleja qué tan seguro es.

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.

appliedPasswordPolicies[]

object (PasswordRequirements)

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 establece en función de passwordPolicies.
dpcMigrationInfo

object (DpcMigrationInfo)

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

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 el dispositivo se borra 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 les aplique una política.
LOST Se extravió el dispositivo. Este estado solo es posible en 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.

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)

Indica 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 en particular no cumple con las políticas, esto especifica la ruta de acceso completa al campo infractor. La ruta tiene el mismo formato del que se haría referencia al campo JSON de la política en JavaScript, es decir: 1) En los campos con 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 con tipo de array, el nombre del campo va seguido del índice de array entre corchetes. Por ejemplo, para indicar un problema en el campo url del 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 de incumplimiento es APP_NOT_INSTALLED o APP_NOT_UPDATED, significa que la app no se puede instalar ni actualizar.

specificNonComplianceReason

enum (SpecificNonComplianceReason)

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)

Contexto adicional para specificNonComplianceReason.

InstallationFailureReason

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

Enumeradores
INSTALLATION_FAILURE_REASON_UNSPECIFIED Este valor no está permitido.
INSTALLATION_FAILURE_REASON_UNKNOWN Una condición desconocida impide que se instale la app. Algunos motivos 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. Se volverá a intentar la instalación 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. Esto suele suceder cuando se degrada la conexión 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 toda la conectividad 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 una vez que el dispositivo tenga suficiente 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 nuevos valores a la enumeración en el futuro.

Enumeradores
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED No se especificó el motivo específico de 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 estableció en USER_ACTION.
PASSWORD_POLICIES_PASSWORD_EXPIRED Venció la contraseña del dispositivo o del perfil. Se estableció passwordPoliciesContext. 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. nonComplianceReason se estableció en USER_ACTION.
ONC_WIFI_INVALID_VALUE Hay un valor incorrecto en la configuración de Wi-Fi de ONC. fieldPath especifica qué valor de campo es incorrecto. Se estableció oncWifiContext. 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. 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 empresarial. nonComplianceReason se configura en INVALID_VALUE.
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK El usuario debe quitar la red Wi-Fi configurada de forma manual. 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 estableció en INVALID_VALUE.

SpecificNonComplianceContext

Contexto adicional para SpecificNonComplianceReason.

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

object (OncWifiContext)

Contexto adicional para 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 incumplimientos relacionados con las políticas de contraseñas. Consulta PASSWORD_POLICIES_PASSWORD_EXPIRED y PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT.

OncWifiContext

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

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

string

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

PasswordPoliciesContext

Contexto adicional para 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 que ve el usuario. Por ejemplo, 6.0.1.

androidDevicePolicyVersionCode

integer

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

androidDevicePolicyVersionName

string

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

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 el momento en que la actualización estuvo disponible por primera vez. Un valor cero indica que no se estableció este campo. Este campo se establece 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 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 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

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 temperatura de apagado de la batería en Celsius para cada batería del dispositivo.

batteryThrottlingTemperatures[]

number

Umbrales de temperatura de limitación de batería en 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 Celsius para cada CPU del dispositivo.

gpuShutdownTemperatures[]

number

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

gpuThrottlingTemperatures[]

number

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

skinShutdownTemperatures[]

number

Umbrales de temperatura de apagado de la piel del dispositivo en Celsius.

skinThrottlingTemperatures[]

number

Umbrales de temperatura de limitación cutánea del dispositivo en 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 todos los parámetros de configuración 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 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 de visualización único.

refreshRate

integer

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

state

enum (DisplayState)

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 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á apagada en modo de bajo consumo
SUSPENDED La pantalla está apagada en un estado de bajo consumo suspendido.

ApplicationReport

Información que se denunció 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 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)

La lista de eventos de aplicaciones que ocurrieron en las últimas 30 horas.

displayName

string

Es 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

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 apps con clave informados por la app.

userFacingType

enum (UserFacingType)

Si la app es 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 aplicación.

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

Es 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 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ó la 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 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 proporcionen comentarios sobre la 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 forma 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 forma opcional, un valor procesable que leerá la EMM. Por ejemplo, establecer valores que el administrador puede elegir consultar en la consola de EMM (p.ej., “notificarme si los datos de advertencia sobre la batería son menores a 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 por última vez.

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 genuinas que una organización de gestión deba tomar medidas para solucionar.

UserFacingType

Si la app es para el usuario

Enumeradores
USER_FACING_TYPE_UNSPECIFIED No se especificó el tipo de contenido para el usuario de la app.
NOT_USER_FACING La app no está dirigida al usuario.
USER_FACING La app está para el 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

Es el número 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 orden alfabético 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

La información de telefonía asociada con 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

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

carrierName

string

Es 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 en el dispositivo expresado en bytes.

totalInternalStorage

string (int64 format)

Almacenamiento interno total del dispositivo expresado en bytes.

MemoryEvent

Un evento relacionado con las mediciones de memoria y almacenamiento.

Para distinguir entre eventos nuevos y antiguos, te 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)

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

En el caso de los eventos BATTERY_LEVEL_COLLECTED, muestra el nivel de batería 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 Las temperaturas se pueden comparar 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 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 actuales de la piel del dispositivo en 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 no se admite la velocidad de los ventiladores en el sistema.

cpuUsages[]

number

Usos 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 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 PIN o contraseña.

unknownSourcesEnabled

boolean

Si se habilita 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

Indica 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 debe tener este tipo.
UNSUPPORTED El dispositivo no admite la encriptación.
INACTIVE El dispositivo admite la encriptación, pero no está activa en este 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 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 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 Este dispositivo podría estar comprometido y es posible 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 dirigidos al administrador para mitigar este riesgo de seguridad y mejorar la postura de seguridad del dispositivo.

SecurityRisk

El riesgo que hace que el dispositivo no esté en el estado más seguro

Enumeradores
SECURITY_RISK_UNSPECIFIED No se especifica.
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 vulnerado (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 aparece 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 for Information Technology Security Evaluation (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)

Establece si está habilitado el modo Common Criteria.

CommonCriteriaModeStatus

Establece si está habilitado el modo Common Criteria.

Enumeradores
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 en este momento.

DpcMigrationInfo

Información relacionada con si este dispositivo se migró 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 propagará.

additionalData

string

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

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.