- Recurso: Device
- DeviceState
- NonComplianceDetail
- InstallationFailureReason
- SpecificNonComplianceReason
- SpecificNonComplianceContext
- OncWifiContext
- PasswordPoliciesContext
- SoftwareInfo
- SystemUpdateInfo
- UpdateStatus
- HardwareInfo
- EuiccChipInfo
- Display
- DisplayState
- ApplicationReport
- ApplicationEvent
- ApplicationEventType
- ApplicationSource
- ApplicationState
- KeyedAppState
- Gravedad
- UserFacingType
- NetworkInfo
- TelephonyInfo
- ActivationState
- ConfigMode
- MemoryInfo
- MemoryEvent
- MemoryEventType
- PowerManagementEvent
- PowerManagementEventType
- HardwareStatus
- DeviceSettings
- EncryptionStatus
- SecurityPosture
- DevicePosture
- PostureDetail
- SecurityRisk
- CommonCriteriaModeInfo
- CommonCriteriaModeStatus
- PolicySignatureVerificationStatus
- DpcMigrationInfo
- Métodos
Recurso: Device
Dispositivo propiedad de 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 ( |
Campos | |
---|---|
name |
Nombre del dispositivo con el formato |
userName |
Es el nombre del recurso del usuario propietario de este dispositivo con el formato |
managementMode |
Es el tipo de modo de administración que adopta la política de dispositivos Android en el dispositivo. Esto influye en la configuración de políticas que se admite. |
state |
Es el estado que se aplicará al dispositivo. Este campo se puede modificar con una solicitud de parche. Ten en cuenta que, cuando llamas a |
appliedState |
Es el estado que se aplica actualmente al dispositivo. |
policyCompliant |
Indica si el dispositivo cumple con su política. |
nonComplianceDetails[] |
Son los detalles sobre la configuración de políticas con la que el dispositivo no cumple. |
enrollmentTime |
Es la fecha y hora de inscripción del dispositivo. Usa el RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean "Z". Ejemplos: |
lastStatusReportTime |
Es la última vez que el dispositivo envió un informe de estado. Usa el RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean "Z". Ejemplos: |
lastPolicyComplianceReportTime |
Obsoleta. Usa el RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean "Z". Ejemplos: |
lastPolicySyncTime |
Fecha y hora en que el dispositivo recuperó su política por última vez. Usa el RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean "Z". Ejemplos: |
policyName |
Nombre de la política aplicada al dispositivo, con el formato |
appliedPolicyName |
Es el nombre de la política que se aplica actualmente al dispositivo. |
appliedPolicyVersion |
Es la versión de la política que se aplica actualmente al dispositivo. |
apiLevel |
Es el nivel de API de la versión de la plataforma Android que se ejecuta en el dispositivo. |
enrollmentTokenData |
Si el dispositivo se inscribió con un token de inscripción con datos adicionales proporcionados, este campo contiene esos datos. |
enrollmentTokenName |
Si el dispositivo se inscribió con un token de inscripción, este campo contiene el nombre del token. |
disabledReason |
Si el estado del dispositivo es |
softwareInfo |
Información detallada sobre el software del dispositivo. Esta información solo está disponible si |
hardwareInfo |
Es información detallada sobre el hardware del dispositivo. |
displays[] |
Es información detallada sobre las pantallas del dispositivo. Esta información solo está disponible si |
applicationReports[] |
Son informes sobre las apps instaladas en el dispositivo. Esta información solo está disponible cuando |
previousDeviceNames[] |
Si el mismo dispositivo físico se inscribió varias veces, este campo contiene sus nombres anteriores. El número de serie se usa como identificador único para determinar si el mismo dispositivo físico se inscribió anteriormente. Los nombres están en orden cronológico. |
networkInfo |
Información de la red del dispositivo Esta información solo está disponible si |
memoryInfo |
Información de la memoria: Contiene información sobre la memoria y el almacenamiento del dispositivo. |
memoryEvents[] |
Eventos relacionados con las mediciones de memoria y almacenamiento en orden cronológico. Esta información solo está disponible si Los eventos se conservan durante un período determinado y los eventos antiguos se borran. |
powerManagementEvents[] |
Eventos de administración de energía en el dispositivo, en orden cronológico. Esta información solo está disponible si |
hardwareStatusSamples[] |
Son muestras del estado del hardware en orden cronológico. Esta información solo está disponible si |
deviceSettings |
Es información de la configuración del dispositivo. Esta información solo está disponible si |
user |
Es el usuario propietario del dispositivo. |
systemProperties |
Es un mapa del nombre y el valor de las propiedades del sistema seleccionadas relacionadas con el dispositivo. Esta información solo está disponible si Es un objeto que contiene una lista de pares |
securityPosture |
Es el valor de la posición de seguridad del dispositivo que refleja qué tan seguro es el dispositivo. |
ownership |
Propiedad del dispositivo administrado. |
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 |
appliedPasswordPolicies[] |
Son los requisitos de contraseña que se aplican actualmente al dispositivo.
|
dpcMigrationInfo |
Solo salida. Es información relacionada con si este dispositivo se migró desde otro controlador de políticas de dispositivos (DPC). |
DeviceState
Son los estados que se pueden aplicar a un dispositivo.
Enumeraciones | |
---|---|
DEVICE_STATE_UNSPECIFIED |
Este valor no está permitido. |
ACTIVE |
El dispositivo está activo. |
DISABLED |
El dispositivo está inhabilitado. |
DELETED |
Se borró el dispositivo. Este estado nunca se devuelve en una llamada a la API, pero se usa en el informe de estado final cuando el dispositivo confirma la eliminación. Si el dispositivo se borra a través de 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 seguirá sin conocer el estado del dispositivo. |
PROVISIONING |
Se está aprovisionando el dispositivo. Los dispositivos recién inscritos se encuentran en este estado hasta que se les aplica una política. |
LOST |
Se perdió el dispositivo. Este estado solo es posible en dispositivos propiedad de 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 continúe la migración. |
DEACTIVATED_BY_DEVICE_FINANCE |
Este es un dispositivo financiado que el agente de financiación "bloqueó". Esto significa que se aplicaron ciertos parámetros de configuración de políticas que limitan la funcionalidad del dispositivo hasta que el agente de financiación lo "desbloquee". El dispositivo seguirá aplicando la configuración de políticas, excepto las que anule 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 un parámetro de configuración de la política.
Representación JSON |
---|
{ "settingName": string, "nonComplianceReason": enum ( |
Campos | |
---|---|
settingName |
Es el nombre del parámetro de configuración de la política. Es el nombre del campo JSON de un campo |
nonComplianceReason |
Es el motivo por el que el dispositivo no cumple con el parámetro de configuración. |
packageName |
Nombre del paquete que indica qué app no cumple con las políticas, si corresponde. |
fieldPath |
En el caso de los parámetros de configuración con campos anidados, si un campo anidado en particular no cumple con los requisitos, se especifica la ruta de acceso completa al campo infractor. La ruta de acceso tiene el mismo formato que el campo JSON de la política tendría en JavaScript, es decir, 1) para los campos con tipo de objeto, el nombre del campo está seguido de un punto y, luego, de un nombre de subcampo. 2) En el caso de los campos de tipo array, el nombre del campo está seguido del índice del array entre corchetes. Por ejemplo, para indicar un problema con el campo |
currentValue |
Es el valor actual del parámetro de configuración en el dispositivo si no se pudo aplicar el parámetro de configuración de la política. |
installationFailureReason |
Si se establece |
specificNonComplianceReason |
Es el motivo específico de la política por el que el dispositivo no cumple con el parámetro de configuración. |
specificNonComplianceContext |
Es el contexto adicional para |
InstallationFailureReason
Motivos por los que podría fallar la instalación de una app
Enumeraciones | |
---|---|
INSTALLATION_FAILURE_REASON_UNSPECIFIED |
Este valor no está permitido. |
INSTALLATION_FAILURE_REASON_UNKNOWN |
Una condición desconocida impide la instalación de la app. Algunos motivos posibles son que el dispositivo no tiene suficiente almacenamiento, que la conexión de red del dispositivo no es confiable o que 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 |
Se produjo un error de red en el dispositivo del usuario que impidió que se completara la instalación. Por lo general, esto sucede cuando la conectividad a Internet del dispositivo se degrada, 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 los requisitos de |
INSUFFICIENT_STORAGE |
El dispositivo del usuario no tiene suficiente espacio de almacenamiento para instalar la app. Esto se puede solucionar liberando espacio de almacenamiento en el dispositivo. La instalación o actualización de la app se reanudará automáticamente cuando el dispositivo tenga suficiente almacenamiento. |
SpecificNonComplianceReason
Son más detalles sobre el motivo por el que un dispositivo podría no cumplir con un parámetro de configuración de política. Se pueden agregar valores nuevos al enum en el futuro.
Enumeraciones | |
---|---|
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED |
No se especificó el motivo específico de incumplimiento. No se establecen los campos en . |
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED |
El usuario debe confirmar las credenciales ingresando el bloqueo de pantalla. No se establecen los campos en . se configura como . |
PASSWORD_POLICIES_PASSWORD_EXPIRED |
La contraseña del dispositivo o del perfil expiró. Se configuró . se configura como . |
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT |
La contraseña del dispositivo no cumple con los requisitos. Se configuró . se configura como . |
ONC_WIFI_INVALID_VALUE |
Hay un valor incorrecto en la configuración de Wi-Fi de ONC. especifica qué valor de campo es incorrecto. Se configuró . se configura como . |
ONC_WIFI_API_LEVEL |
El parámetro de configuración de Wi-Fi de ONC no se admite en el nivel de API de la versión de Android que se ejecuta en el dispositivo. especifica qué valor del campo no se admite. Se configuró . se configura como . |
ONC_WIFI_INVALID_ENTERPRISE_CONFIG |
Falta la CA raíz o el nombre de dominio de la red Wi-Fi empresarial. se configura en . |
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK |
El usuario debe quitar manualmente la red Wi-Fi configurada. Esto solo se aplica a los perfiles de trabajo en dispositivos de propiedad personal. se configura en . |
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY |
El alias del par de claves especificado a través del campo ClientCertKeyPairAlias en no corresponde a una clave existente instalada en el dispositivo. se configura como . |
PERMISSIBLE_USAGE_RESTRICTION |
Este parámetro de configuración de la política está restringido y no se puede establecer para este proyecto de Google Cloud Platform. En la política de Uso Permitido, se proporcionan más detalles (incluido cómo habilitar el uso de este parámetro de configuración de la política). se configura como . |
REQUIRED_ACCOUNT_NOT_IN_ENTERPRISE |
La cuenta laboral que requiere el parámetro de configuración de la política de ya no forma parte de la empresa. se configura como . |
NEW_ACCOUNT_NOT_IN_ENTERPRISE |
La cuenta laboral que agregó el usuario no forma parte de la empresa. se configura en . |
SpecificNonComplianceContext
Es el contexto adicional para
.SpecificNonComplianceReason
Representación JSON |
---|
{ "oncWifiContext": { object ( |
Campos | |
---|---|
oncWifiContext |
Contexto adicional sobre el incumplimiento relacionado con la configuración de Wi-Fi. Consulta |
passwordPoliciesContext |
Es contexto adicional sobre el incumplimiento relacionado con las políticas de contraseñas. Consulta |
OncWifiContext
Contexto adicional sobre el incumplimiento relacionado con la configuración de Wi-Fi.
Representación JSON |
---|
{ "wifiGuid": string } |
Campos | |
---|---|
wifiGuid |
Es el GUID de la configuración de Wi-Fi que no cumple con los requisitos. |
PasswordPoliciesContext
Es contexto adicional sobre el incumplimiento relacionado con las políticas de contraseñas.
Representación JSON |
---|
{
"passwordPolicyScope": enum ( |
Campos | |
---|---|
passwordPolicyScope |
Es el alcance de la contraseña que no cumple con los requisitos. |
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 ( |
Campos | |
---|---|
androidVersion |
Es la cadena de versión de Android visible para el usuario. Por ejemplo, |
androidDevicePolicyVersionCode |
Es el código de versión de la app de Android Device Policy. |
androidDevicePolicyVersionName |
Es la versión de la app de Device Policy para Android que se muestra al usuario. |
androidBuildNumber |
Es la cadena de ID de compilación de Android que se muestra al usuario. Por ejemplo, |
deviceKernelVersion |
Versión del kernel, por ejemplo, |
bootloaderVersion |
Número de versión del bootloader del sistema, p.ej., |
androidBuildTime |
Tiempo de compilación Usa el RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean "Z". Ejemplos: |
securityPatchLevel |
Nivel de parche de seguridad, p.ej., |
primaryLanguageCode |
Es un código de idioma IETF BCP 47 para la configuración regional principal del dispositivo. |
deviceBuildSignature |
Es el hash SHA-256 de |
systemUpdateInfo |
Es información sobre una posible actualización del sistema pendiente. |
SystemUpdateInfo
Es información sobre una posible actualización del sistema pendiente.
Representación JSON |
---|
{
"updateStatus": enum ( |
Campos | |
---|---|
updateStatus |
Es el estado de una actualización: indica si existe una actualización y de qué tipo es. |
updateReceivedTime |
Fecha y hora en que la actualización estuvo disponible por primera vez. Un valor cero indica que este campo no está establecido. Este campo solo se configura si hay una actualización disponible (es decir, Usa el RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean "Z". Ejemplos: |
UpdateStatus
Es el estado de una actualización: indica si existe una actualización 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 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 no se conoce su tipo. |
SECURITY_UPDATE_AVAILABLE |
Hay una actualización de seguridad pendiente disponible. |
OS_UPDATE_AVAILABLE |
Hay una actualización del SO pendiente disponible. |
HardwareInfo
Es 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,
"euiccChipInfo": [
{
object ( |
Campos | |
---|---|
brand |
Marca del dispositivo. Por ejemplo, |
hardware |
Nombre del hardware. Por ejemplo, |
deviceBasebandVersion |
Es la versión de banda base. Por ejemplo, |
manufacturer |
Fabricante Por ejemplo, |
serialNumber |
Número de serie del dispositivo |
model |
Modelo del dispositivo Por ejemplo, |
batteryShutdownTemperatures[] |
Son los umbrales de temperatura de apagado de la batería en grados Celsius para cada batería del dispositivo. |
batteryThrottlingTemperatures[] |
Son los umbrales de temperatura de regulación de la batería en grados Celsius para cada batería del dispositivo. |
cpuShutdownTemperatures[] |
Son los umbrales de temperatura de apagado de la CPU en grados Celsius para cada CPU del dispositivo. |
cpuThrottlingTemperatures[] |
Son los umbrales de temperatura de limitación de la CPU en grados Celsius para cada CPU del dispositivo. |
gpuShutdownTemperatures[] |
Son los umbrales de temperatura de apagado de la GPU en grados Celsius para cada GPU del dispositivo. |
gpuThrottlingTemperatures[] |
Son los umbrales de temperatura de regulación de la GPU en grados Celsius para cada GPU del dispositivo. |
skinShutdownTemperatures[] |
Son los umbrales de temperatura de apagado de la carcasa del dispositivo en grados Celsius. |
skinThrottlingTemperatures[] |
Son los umbrales de temperatura de estrangulamiento de la piel del dispositivo en grados Celsius. |
enterpriseSpecificId |
Solo salida. Es el ID que identifica de forma única un dispositivo personal en una organización específica. En el mismo dispositivo físico cuando se inscribe con la misma organización, este ID persiste en todas las configuraciones y hasta en los restablecimientos de la configuración de fábrica. Este ID está disponible en dispositivos personales con un perfil de trabajo que ejecutan Android 12 y versiones posteriores. |
euiccChipInfo[] |
Solo salida. Es información relacionada con el chip de la eUICC. |
EuiccChipInfo
Es información relacionada con el chip de la eUICC.
Representación JSON |
---|
{ "eid": string } |
Campos | |
---|---|
eid |
Solo salida. Documento de identidad integrado (EID) que identifica el chip de la eUICC para cada chip de la eUICC del dispositivo. Esta función está disponible en dispositivos propiedad de la empresa que ejecutan Android 13 y versiones posteriores. |
Display
Información de la pantalla del dispositivo.
Representación JSON |
---|
{
"name": string,
"displayId": integer,
"refreshRate": integer,
"state": enum ( |
Campos | |
---|---|
name |
Nombre de la pantalla. |
displayId |
Es el ID de pantalla único. |
refreshRate |
Frecuencia de actualización de la pantalla en fotogramas por segundo. |
state |
Es el estado de la pantalla. |
width |
Ancho de la pantalla en píxeles. |
height |
Altura de la pantalla en píxeles. |
density |
Es la densidad de pantalla expresada en puntos por pulgada. |
DisplayState
Es el estado de una pantalla.
Enumeraciones | |
---|---|
DISPLAY_STATE_UNSPECIFIED |
Este valor no está permitido. |
OFF |
La pantalla está apagada. |
ON |
La pantalla está encendida. |
DOZE |
La pantalla está en modo de espera con bajo consumo de energía |
SUSPENDED |
La pantalla está en modo de espera en un estado de bajo consumo suspendido. |
ApplicationReport
Es la información que se informa sobre una app instalada.
Representación JSON |
---|
{ "packageName": string, "versionName": string, "versionCode": integer, "events": [ { object ( |
Campos | |
---|---|
packageName |
Es el nombre del paquete de la app. |
versionName |
Es la versión de la app que se muestra al usuario. |
versionCode |
Es el código de versión de la app, que se puede usar para determinar si una versión es más reciente que otra. |
events[] |
Es la lista de eventos de la aplicación que se produjeron en las últimas 30 horas. |
displayName |
Es el nombre visible de la app. |
packageSha256Hash |
Es el hash SHA-256 del archivo APK de la app, que se puede usar para verificar que la app no se haya modificado. Cada byte del valor hash se representa como un número hexadecimal de dos dígitos. |
signingKeyCertFingerprints[] |
Es el hash SHA-1 de cada |
installerPackageName |
Es el nombre del paquete de la app que instaló esta app. |
applicationSource |
Es la fuente del paquete. |
state |
Es el estado de la aplicación. |
keyedAppStates[] |
Es la lista de estados de la app con clave que informa la app. |
userFacingType |
Indica si la app está orientada al usuario. |
ApplicationEvent
Es un evento relacionado con la app.
Representación JSON |
---|
{
"eventType": enum ( |
Campos | |
---|---|
eventType |
Es el tipo de evento de la aplicación. |
createTime |
Es la hora de creación del evento. Usa el RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean "Z". Ejemplos: |
ApplicationEventType
Es un tipo de evento relacionado con la app.
Enumeraciones | |
---|---|
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 reemplazó 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ó de forma local 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
Es el estado de instalación actual.
Enumeraciones | |
---|---|
APPLICATION_STATE_UNSPECIFIED |
El estado de la app no está especificado |
REMOVED |
Se quitó la app del dispositivo |
INSTALLED |
La app está instalada en el dispositivo |
KeyedAppState
Es el estado de la app con clave que informa la app.
Representación JSON |
---|
{
"key": string,
"severity": enum ( |
Campos | |
---|---|
key |
Es la clave del estado de la app. Actúa como punto de referencia para el estado que proporciona la app. Por ejemplo, cuando se proporciona comentarios sobre la configuración administrada, esta clave podría ser la clave de configuración administrada. |
severity |
Es la gravedad del estado de la app. |
message |
Es una cadena de mensaje de formato libre opcional para explicar el estado de la app. Si el estado se activó por un valor en particular (p.ej., un valor de configuración administrada), se debe incluir en el mensaje. |
data |
Es un valor legible por máquina que el EMM puede leer de forma opcional. Por ejemplo, establecer valores con los que el administrador puede realizar consultas en la consola del EMM (p.ej., "Notifícame si los datos de battery_warning son inferiores a 10"). |
createTime |
Es la fecha y hora de creación del estado de la app en el dispositivo. Usa el RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean "Z". Ejemplos: |
lastUpdateTime |
Fecha y hora en la que se actualizó el estado de la app por última vez. Usa el RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean "Z". Ejemplos: |
Gravedad
Es la gravedad del estado de la app.
Enumeraciones | |
---|---|
SEVERITY_UNSPECIFIED |
Es un nivel de gravedad sin especificar. |
INFO |
Es el nivel de gravedad de la información. |
ERROR |
Es el nivel de gravedad del error. Solo se debe establecer para condiciones de error genuinas que una organización de administración debe corregir. |
UserFacingType
Indica si la app está orientada al usuario.
Enumeraciones | |
---|---|
USER_FACING_TYPE_UNSPECIFIED |
No se especificó 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 ( |
Campos | |
---|---|
imei |
Número de IMEI del dispositivo GSM. Por ejemplo, |
meid |
Número de MEID del dispositivo CDMA. Por ejemplo, |
wifiMacAddress |
Dirección MAC de Wi-Fi del dispositivo. Por ejemplo, |
networkOperatorName |
Nombre alfabético del operador registrado actual. Por ejemplo, Vodafone. |
telephonyInfos[] |
Proporciona información de telefonía asociada a cada tarjeta SIM del dispositivo. Solo se admite en dispositivos completamente administrados a partir del nivel de API 23 de Android. |
TelephonyInfo
Es la información de telefonía asociada a una tarjeta SIM determinada en el dispositivo. Solo se admite en dispositivos completamente administrados a partir del nivel de API 23 de Android.
Representación JSON |
---|
{ "phoneNumber": string, "carrierName": string, "iccId": string, "activationState": enum ( |
Campos | |
---|---|
phoneNumber |
Es el número de teléfono asociado a esta tarjeta SIM. |
carrierName |
Es el nombre del operador asociado a esta tarjeta SIM. |
iccId |
Solo salida. Es el ICCID asociado con esta tarjeta SIM. |
activationState |
Solo salida. Es el estado de activación de la tarjeta SIM en el dispositivo. Esto solo se aplica a las eSIM. Esta función es compatible con todos los dispositivos para el nivel de API 35 y versiones posteriores. Siempre es |
configMode |
Solo salida. Es el modo de configuración de la tarjeta SIM en el dispositivo. Esto solo se aplica a las eSIM. Esta función es compatible con todos los dispositivos para el nivel de API 35 y versiones posteriores. Siempre es |
ActivationState
Es el estado de activación de la tarjeta SIM en el dispositivo.
Enumeraciones | |
---|---|
ACTIVATION_STATE_UNSPECIFIED |
No se especificó el estado de activación. |
ACTIVATED |
La tarjeta SIM está activada. |
NOT_ACTIVATED |
La tarjeta SIM no está activada. |
ConfigMode
Es el modo de configuración de la tarjeta SIM en el dispositivo.
Enumeraciones | |
---|---|
CONFIG_MODE_UNSPECIFIED |
No se especificó el modo de configuración. |
ADMIN_CONFIGURED |
El administrador configuró esta SIM. |
USER_CONFIGURED |
El usuario configuró esta SIM. |
MemoryInfo
Es información sobre la memoria y el almacenamiento del dispositivo.
Representación JSON |
---|
{ "totalRam": string, "totalInternalStorage": string } |
Campos | |
---|---|
totalRam |
Es la RAM total del dispositivo en bytes. |
totalInternalStorage |
Es el almacenamiento interno total del dispositivo en bytes. |
MemoryEvent
Es un evento relacionado con las mediciones de memoria y almacenamiento.
Para distinguir entre eventos nuevos y antiguos, te recomendamos que uses el campo
.createTime
Representación JSON |
---|
{
"eventType": enum ( |
Campos | |
---|---|
eventType |
Es el tipo de evento. |
createTime |
Es la hora de creación del evento. Usa el RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean "Z". Ejemplos: |
byteCount |
Cantidad de bytes libres en el medio o, para |
MemoryEventType
El tipo de evento
Enumeraciones | |
---|---|
MEMORY_EVENT_TYPE_UNSPECIFIED |
Sin especificar. No hay eventos de 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 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
Es un evento de administración de energía.
Representación JSON |
---|
{
"eventType": enum ( |
Campos | |
---|---|
eventType |
Es el tipo de evento. |
createTime |
Es la hora de creación del evento. Usa el RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean "Z". Ejemplos: |
batteryLevel |
Para los eventos de |
PowerManagementEventType
El tipo de evento
Enumeraciones | |
---|---|
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED |
Sin especificar. No hay eventos de 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 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
Es el 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 |
Es la fecha y hora en que se tomaron las mediciones. Usa el RFC 3339, en el que el resultado generado siempre se normaliza según la zona horaria Z y usa 0, 3, 6 o 9 dígitos fraccionarios. También se aceptan otras compensaciones que no sean "Z". Ejemplos: |
batteryTemperatures[] |
Temperaturas actuales de la batería en grados Celsius para cada batería del dispositivo. |
cpuTemperatures[] |
Temperaturas actuales de la CPU en grados Celsius para cada CPU del dispositivo. |
gpuTemperatures[] |
Temperaturas actuales de la GPU en grados Celsius para cada GPU del dispositivo. |
skinTemperatures[] |
Temperaturas cutáneas actuales del dispositivo en grados Celsius. |
fanSpeeds[] |
Velocidades del ventilador en RPM para cada ventilador del dispositivo. Un array vacío significa que no hay ventiladores o que el sistema no admite la velocidad del ventilador. |
cpuUsages[] |
Uso de CPU en porcentaje para cada núcleo disponible en el dispositivo. El uso es 0 para cada núcleo desconectado. Un array vacío implica que el uso de CPU no es compatible con el sistema. |
DeviceSettings
Es 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 ( |
Campos | |
---|---|
isDeviceSecure |
Indica si el dispositivo está protegido con un PIN o una contraseña. |
unknownSourcesEnabled |
Indica si está habilitada la instalación de apps desde fuentes desconocidas. |
developmentSettingsEnabled |
Indica si el modo de desarrollador está habilitado en el dispositivo. |
adbEnabled |
Indica si ADB está habilitado en el dispositivo. |
isEncrypted |
Indica si la encriptación de almacenamiento está habilitada. |
encryptionStatus |
Es el estado de encriptación de DevicePolicyManager. |
verifyAppsEnabled |
Indica si se aplica la verificación de Google Play Protect en el dispositivo. |
EncryptionStatus
Es el 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 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
Es la postura de seguridad del dispositivo, según lo determinan el estado actual del dispositivo y las políticas aplicadas.
Representación JSON |
---|
{ "devicePosture": enum ( |
Campos | |
---|---|
devicePosture |
Valor de la postura de seguridad del dispositivo. |
postureDetails[] |
Son detalles adicionales sobre la postura de seguridad del dispositivo. |
DevicePosture
Son los valores posibles de la postura de seguridad de un dispositivo administrado.
Enumeraciones | |
---|---|
POSTURE_UNSPECIFIED |
Sin especificar. No hay detalles de la postura para este valor. |
SECURE |
Este dispositivo es seguro. |
AT_RISK |
Es posible que este dispositivo sea más vulnerable a los agentes maliciosos de lo que se recomienda para usarlo con datos corporativos. |
POTENTIALLY_COMPROMISED |
Es posible que este dispositivo esté comprometido y que los actores no autorizados puedan acceder a los datos corporativos. |
PostureDetail
Son detalles adicionales sobre la postura de seguridad del dispositivo.
Representación JSON |
---|
{ "securityRisk": enum ( |
Campos | |
---|---|
securityRisk |
Es un riesgo de seguridad específico que afecta de forma negativa la postura de seguridad del dispositivo. |
advice[] |
Asesoramiento correspondiente para el administrador para mitigar este riesgo de seguridad y mejorar la postura de seguridad del dispositivo. |
SecurityRisk
Es el riesgo que hace que el dispositivo no esté 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 de basicIntegrity 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 basicIntegrity). |
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 la etiqueta MEETS_STRONG_INTEGRITY no se muestra 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 ( |
Campos | |
---|---|
commonCriteriaModeStatus |
Indica si el modo Common Criteria está habilitado. |
policySignatureVerificationStatus |
Solo salida. Es el estado de la verificación de la firma de la política. |
CommonCriteriaModeStatus
Indica si el modo Common Criteria está habilitado.
Enumeraciones | |
---|---|
COMMON_CRITERIA_MODE_STATUS_UNKNOWN |
Estado desconocido. |
COMMON_CRITERIA_MODE_DISABLED |
Actualmente, el modo Common Criteria está inhabilitado. |
COMMON_CRITERIA_MODE_ENABLED |
El modo Common Criteria está habilitado en este momento. |
PolicySignatureVerificationStatus
Es el estado de la verificación de la firma de la política.
Enumeraciones | |
---|---|
POLICY_SIGNATURE_VERIFICATION_STATUS_UNSPECIFIED |
Sin especificar. No se informó el estado de verificación. Este parámetro solo se configura si es falso. |
POLICY_SIGNATURE_VERIFICATION_DISABLED |
La verificación de la firma de la política está inhabilitada en el dispositivo, ya que se estableció como falso. |
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED |
Se verificó correctamente la firma de la política. |
POLICY_SIGNATURE_VERIFICATION_NOT_SUPPORTED |
No se admite la verificación de la firma de la política, p.ej., porque el dispositivo se inscribió con una versión de CloudDPC que no admite la verificación de la firma de la política. |
POLICY_SIGNATURE_VERIFICATION_FAILED |
No se pudo verificar la firma de la política. No se aplicó la política. |
DpcMigrationInfo
Es información relacionada con si este dispositivo se migró desde otro controlador de políticas de dispositivos (DPC).
Representación JSON |
---|
{ "previousDpc": string, "additionalData": string } |
Campos | |
---|---|
previousDpc |
Solo salida. Si este dispositivo se migró desde otro DPC, este es su nombre de paquete. De lo contrario, no se propaga. |
additionalData |
Solo salida. Si este dispositivo se migró desde otro DPC, aquí se completará el campo |
Métodos |
|
---|---|
|
Borra un dispositivo. |
|
Obtiene un dispositivo. |
|
Emite un comando a un dispositivo. |
|
Enumera los dispositivos de una empresa determinada. |
|
Actualiza un dispositivo. |