- Recurso: Dispositivo
- DeviceState
- NonComplianceDetail
- InstallationFailureReason
- SpecificNonComplianceReason
- SpecificNonComplianceContext
- OncWifiContext
- PasswordPoliciesContext
- SoftwareInfo
- SystemUpdateInfo
- UpdateStatus
- HardwareInfo
- Pantalla
- DisplayState
- ApplicationReport
- ApplicationEvent
- ApplicationEventType
- ApplicationSource
- ApplicationState
- KeyedAppState
- Gravedad
- UserFacingType
- NetworkInfo
- TelephonyInfo
- MemoryInfo
- MemoryEvent
- MemoryEventType
- PowerManagementEvent
- PowerManagementEventType
- HardwareStatus
- DeviceSettings
- EncryptionStatus
- SecurityPosture
- DevicePosture
- PostureDetail
- SecurityRisk
- CommonCriteriaModeInfo
- CommonCriteriaModeStatus
- DpcMigrationInfo
- Métodos
Recurso: Device
Es un dispositivo que pertenece a una empresa. A menos que se indique lo contrario, todos los campos son de solo lectura y enterprises.devices.patch
no los puede modificar.
Representación JSON |
---|
{ "name": string, "userName": string, "managementMode": enum ( |
Campos | |
---|---|
name |
Es el nombre del dispositivo con el formato |
userName |
El nombre del recurso del usuario propietario de este dispositivo con el formato |
managementMode |
El tipo de modo de administración que Android Device Policy adopta en el dispositivo. Esto influye en la configuración de la política admitida. |
state |
El estado que se aplicará al dispositivo. Este campo se puede modificar mediante una solicitud de parche. Ten en cuenta que, cuando llamas a |
appliedState |
El estado que se aplica actualmente al dispositivo. |
policyCompliant |
Si el dispositivo cumple con su política |
nonComplianceDetails[] |
Detalles sobre la configuración de la política con la que el dispositivo no cumple. |
enrollmentTime |
La hora de inscripción del dispositivo. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
lastStatusReportTime |
La última vez que el dispositivo envió un informe de estado. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
lastPolicyComplianceReportTime |
Obsoleta. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
lastPolicySyncTime |
La última vez que el dispositivo recuperó su política. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
policyName |
El nombre de la política aplicada al dispositivo, con el formato |
appliedPolicyName |
El nombre de la política que se aplica actualmente al dispositivo. |
appliedPolicyVersion |
La versión de la política que se aplica actualmente al dispositivo. |
apiLevel |
El nivel de API de la versión de la plataforma de 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 estará disponible si el valor de |
hardwareInfo |
Información detallada sobre el hardware del dispositivo. |
displays[] |
Información detallada sobre las pantallas en el dispositivo. Esta información solo estará disponible si el valor de |
applicationReports[] |
Informes de apps instaladas en el dispositivo Esta información solo está disponible cuando el valor de |
previousDeviceNames[] |
Si el mismo dispositivo físico se inscribió varias veces, este campo contiene los nombres anteriores. El número de serie se usa como identificador único para determinar si el mismo dispositivo físico se inscribió anteriormente. Los nombres están en orden cronológico. |
networkInfo |
Información de red del dispositivo Esta información solo estará disponible si el valor de |
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 estará disponible si el valor de Los eventos se conservan durante un período determinado y se borran los anteriores. |
powerManagementEvents[] |
Eventos de administración de energía en el dispositivo en orden cronológico. Esta información solo estará disponible si el valor de |
hardwareStatusSamples[] |
Ejemplos de estado del hardware en orden cronológico. Esta información solo estará disponible si el valor de |
deviceSettings |
Información de la configuración del dispositivo. Esta información solo estará disponible si el valor de |
user |
El usuario propietario del dispositivo. |
systemProperties |
Mapa de las propiedades del sistema seleccionadas y su valor relacionados con el dispositivo. Esta información solo estará disponible si el valor de Es un objeto que contiene una lista de pares |
securityPosture |
Es el valor de postura de seguridad del dispositivo que refleja la seguridad del dispositivo. |
ownership |
Es la propiedad del dispositivo administrado. |
commonCriteriaModeInfo |
Información sobre el modo Common Criteria: estándares de seguridad definidos en los Common Criteria para la evaluación de la seguridad de la tecnología de la información (CC). Esta información solo está disponible si |
appliedPasswordPolicies[] |
Son los requisitos de contraseña que se aplican actualmente al dispositivo.
|
dpcMigrationInfo |
Solo salida. Información relacionada con si este dispositivo se migró para dejar de ser administrado por otro controlador de política de dispositivo (DPC). |
DeviceState
Estados que se pueden aplicar a un dispositivo.
Enumeraciones | |
---|---|
DEVICE_STATE_UNSPECIFIED |
No se permite este valor. |
ACTIVE |
El dispositivo está activo. |
DISABLED |
El dispositivo está inhabilitado. |
DELETED |
Se borró el dispositivo. Una llamada a la API nunca devuelve este estado, pero se usa en el informe de estado final cuando el dispositivo confirma la eliminación. Si se borra el dispositivo mediante la llamada a la API, este estado se publica en Pub/Sub. Si el usuario borra el perfil de trabajo o restablece el dispositivo, el servidor no reconoce el estado del dispositivo. |
PROVISIONING |
Se está aprovisionando el dispositivo. Los dispositivos inscritos recientemente permanecerán en este estado hasta que se les aplique una política. |
LOST |
Se perdió el dispositivo. Este estado solo es posible en los dispositivos que pertenecen a la organización. |
PREPARING_FOR_MIGRATION |
El dispositivo se está preparando para migrar a la API de Android Management. No es necesario que realices ninguna otra acción para que la migración continúe. |
DEACTIVATED_BY_DEVICE_FINANCE |
Este es un dispositivo financiado que se “bloqueó” por el agente financiero. Esto significa que se aplicaron ciertas opciones de configuración de la política que limitan la funcionalidad del dispositivo hasta que se "desbloquee". por el agente financiero. El dispositivo seguirá aplicando la configuración de la política, excepto aquellas anuladas por el agente de financiación. Cuando el dispositivo está "bloqueado", el estado se informa en appliedState como DEACTIVATED_BY_DEVICE_FINANCE . |
NonComplianceDetail
Proporciona detalles sobre el incumplimiento de una configuración de política.
Representación JSON |
---|
{ "settingName": string, "nonComplianceReason": enum ( |
Campos | |
---|---|
settingName |
El nombre de la configuración de la política. Este es el nombre de campo JSON de un campo |
nonComplianceReason |
El motivo por el que el dispositivo no cumple con la configuración. |
packageName |
Es el nombre del paquete que indica qué aplicación no cumple con las políticas, si corresponde. |
fieldPath |
Para la configuración con campos anidados, si un campo anidado en particular no cumple con las políticas, esto especifica la ruta completa al campo infractor. La ruta de acceso se formatea de la misma manera que se haría referencia al campo JSON de la política en JavaScript, es decir: 1) En el caso de los campos de tipo de objeto, el nombre del campo va seguido de un punto y, luego, del nombre de un subcampo. 2) En el caso de los campos de tipo array, al nombre del campo le sigue el índice del array encerrado entre corchetes. Por ejemplo, para indicar un problema con el campo |
currentValue |
Si no se pudo aplicar la configuración de política, el valor actual de la configuración en el dispositivo. |
installationFailureReason |
Si se configura |
specificNonComplianceReason |
El motivo específico de la política por el que el dispositivo no cumple con la configuración. |
specificNonComplianceContext |
Contexto adicional para |
InstallationFailureReason
Motivos por los que falla la instalación de una app
Enumeraciones | |
---|---|
INSTALLATION_FAILURE_REASON_UNSPECIFIED |
No se permite este valor. |
INSTALLATION_FAILURE_REASON_UNKNOWN |
Una condición desconocida impide que se instale la app. Algunas razones posibles son que el dispositivo no tiene suficiente almacenamiento, la conexión de red del dispositivo no es confiable o la instalación está tardando más de lo esperado. La instalación se volverá a intentar automáticamente. |
IN_PROGRESS |
La instalación aún está en curso. |
NOT_FOUND |
No se encontró la app en Play. |
NOT_COMPATIBLE_WITH_DEVICE |
La app no es compatible con el dispositivo. |
NOT_APPROVED |
El administrador no aprobó la app. |
PERMISSIONS_NOT_ACCEPTED |
La app tiene permisos nuevos que el administrador no aceptó. |
NOT_AVAILABLE_IN_COUNTRY |
La app no está disponible en el país del usuario. |
NO_LICENSES_REMAINING |
No hay licencias disponibles para asignar al usuario. |
NOT_ENROLLED |
La empresa ya no está inscrita en Google Play administrado o el administrador no aceptó las Condiciones del Servicio más recientes de Google Play administrado. |
USER_INVALID |
El usuario ya no es válido. Es posible que el usuario se haya borrado o inhabilitado. |
NETWORK_ERROR_UNRELIABLE_CONNECTION |
Un error de red en el dispositivo del usuario impidió que la instalación se realizara correctamente. Por lo general, esto sucede cuando se degrada la conectividad a Internet del dispositivo, no está disponible o hay un problema de configuración de red. Asegúrate de que el dispositivo tenga acceso a una conexión a Internet completa en una red que cumpla con |
INSUFFICIENT_STORAGE |
El dispositivo del usuario no tiene suficiente espacio de almacenamiento para instalar la app. Para resolver este problema, libera espacio de almacenamiento en el dispositivo. La instalación o actualización de apps se reanudará automáticamente una vez que el dispositivo tenga suficiente espacio de almacenamiento. |
SpecificNonComplianceReason
Más detalles sobre el motivo por el que un dispositivo podría no cumplir con una configuración de política. Se podrán agregar valores nuevos a la enum en el futuro.
Enumeraciones | |
---|---|
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED |
No se especifica el motivo específico del incumplimiento. No se configuraron los campos en . |
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED |
El usuario debe confirmar las credenciales ingresando el bloqueo de pantalla. No se configuraron los campos en . se configura como . |
PASSWORD_POLICIES_PASSWORD_EXPIRED |
La contraseña del dispositivo o del perfil venció. Se estableció . se configura como . |
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT |
La contraseña del dispositivo no cumple con los requisitos de contraseña. Se estableció . se configura como . |
ONC_WIFI_INVALID_VALUE |
Hay un valor incorrecto en la configuración de Wi-Fi de la ONC. especifica qué valor de campo es incorrecto. Se estableció . se configura como . |
ONC_WIFI_API_LEVEL |
El parámetro de configuración Wi-Fi de ONC no es compatible con el nivel de API de la versión de Android que se ejecuta en el dispositivo. especifica qué valor de campo no es compatible. Se estableció . se configura como . |
ONC_WIFI_INVALID_ENTERPRISE_CONFIG |
Falta la AC raíz o el nombre de dominio en 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 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 . |
SpecificNonComplianceContext
Contexto adicional para
.SpecificNonComplianceReason
Representación JSON |
---|
{ "oncWifiContext": { object ( |
Campos | |
---|---|
oncWifiContext |
Contexto adicional para los incumplimientos relacionados con la configuración de Wi-Fi. Ver |
passwordPoliciesContext |
Contexto adicional para los incumplimientos relacionados con las políticas de contraseñas. Consulta |
OncWifiContext
Contexto adicional para los incumplimientos relacionados con la configuración de Wi-Fi.
Representación JSON |
---|
{ "wifiGuid": string } |
Campos | |
---|---|
wifiGuid |
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 ( |
Campos | |
---|---|
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 ( |
Campos | |
---|---|
androidVersion |
Es la cadena de versión de Android visible para el usuario. Por ejemplo, |
androidDevicePolicyVersionCode |
El código de versión de la app Android Device Policy. |
androidDevicePolicyVersionName |
La versión de la app Android Device Policy como se le muestra al usuario. |
androidBuildNumber |
Cadena de ID de compilación de Android diseñada para mostrarse al usuario Por ejemplo, |
deviceKernelVersion |
Versión de kernel, por ejemplo, |
bootloaderVersion |
El número de versión del bootloader del sistema, p.ej., |
androidBuildTime |
Tiempo de compilación Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
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 |
Hash SHA-256 de |
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 ( |
Campos | |
---|---|
updateStatus |
El estado de una actualización, es decir, si existe y de qué tipo es. |
updateReceivedTime |
Indica la hora en que la actualización estuvo disponible por primera vez. Un valor cero indica que este campo no está configurado. Este campo solo se establece si hay una actualización disponible (es decir, Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
UpdateStatus
El estado de una actualización, es decir, si existe y de qué tipo es.
Enumeraciones | |
---|---|
UPDATE_STATUS_UNKNOWN |
Se desconoce si hay una actualización del sistema pendiente. Esto sucede, por ejemplo, cuando el nivel de API del dispositivo es inferior al 26, o si la versión de Android Device Policy está desactualizada. |
UP_TO_DATE |
No hay ninguna actualización del sistema pendiente disponible en el dispositivo. |
UNKNOWN_UPDATE_AVAILABLE |
Hay una actualización del sistema pendiente disponible, pero se desconoce su tipo. |
SECURITY_UPDATE_AVAILABLE |
Hay una actualización de seguridad pendiente disponible. |
OS_UPDATE_AVAILABLE |
Hay una actualización pendiente del SO disponible. |
HardwareInfo
Información sobre el hardware del dispositivo. Los campos relacionados con los umbrales de temperatura solo están disponibles si el valor de hardwareStatusEnabled
es verdadero en la política del dispositivo.
Representación JSON |
---|
{ "brand": string, "hardware": string, "deviceBasebandVersion": string, "manufacturer": string, "serialNumber": string, "model": string, "batteryShutdownTemperatures": [ number ], "batteryThrottlingTemperatures": [ number ], "cpuShutdownTemperatures": [ number ], "cpuThrottlingTemperatures": [ number ], "gpuShutdownTemperatures": [ number ], "gpuThrottlingTemperatures": [ number ], "skinShutdownTemperatures": [ number ], "skinThrottlingTemperatures": [ number ], "enterpriseSpecificId": string } |
Campos | |
---|---|
brand |
Es la marca del dispositivo. Por ejemplo, |
hardware |
Nombre del hardware. Por ejemplo, |
deviceBasebandVersion |
Versión de banda base. Por ejemplo, |
manufacturer |
Fabricante Por ejemplo, |
serialNumber |
Es el número de serie del dispositivo. |
model |
Indica el modelo del dispositivo. Por ejemplo, |
batteryShutdownTemperatures[] |
Los umbrales de temperatura de apagado de la batería en Celsius para cada batería del dispositivo. |
batteryThrottlingTemperatures[] |
Umbrales de temperatura de limitación de la batería en Celsius para cada batería del dispositivo |
cpuShutdownTemperatures[] |
Los umbrales de temperatura de apagado de la CPU en Celsius para cada CPU en el dispositivo. |
cpuThrottlingTemperatures[] |
Umbrales de temperatura de limitación de la CPU en Celsius para cada CPU del dispositivo. |
gpuShutdownTemperatures[] |
Los umbrales de temperatura de apagado de la GPU en Celsius para cada GPU del dispositivo. |
gpuThrottlingTemperatures[] |
Los umbrales de temperatura de limitación de la GPU en Celsius para cada GPU del dispositivo. |
skinShutdownTemperatures[] |
Los umbrales de temperatura de apagado de la máscara del dispositivo en grados Celsius. |
skinThrottlingTemperatures[] |
Umbrales de temperatura de limitación de la piel del dispositivo en Celsius. |
enterpriseSpecificId |
Solo salida. ID que identifica de manera inequívoca un dispositivo de propiedad personal en una organización determinada. En el mismo dispositivo físico, cuando está inscrito en la misma organización, este ID persiste en todas las configuraciones y hasta cuando se restablece la configuración de fábrica. Este ID está disponible en dispositivos personales con perfil de trabajo en dispositivos que ejecutan Android 12 y versiones posteriores. |
Display
Información sobre la pantalla del dispositivo.
Representación JSON |
---|
{
"name": string,
"displayId": integer,
"refreshRate": integer,
"state": enum ( |
Campos | |
---|---|
name |
Es el nombre de la pantalla. |
displayId |
ID visible único |
refreshRate |
Es la frecuencia de actualización de la pantalla en fotogramas por segundo. |
state |
Estado de la pantalla. |
width |
Es el ancho de la pantalla en píxeles. |
height |
Indica la altura de la pantalla en píxeles. |
density |
Es la densidad de la pantalla expresada como puntos por pulgada. |
DisplayState
Es el estado de una pantalla.
Enumeraciones | |
---|---|
DISPLAY_STATE_UNSPECIFIED |
No se permite este valor. |
OFF |
La pantalla está apagada. |
ON |
La pantalla está encendida. |
DOZE |
La pantalla adormece cuando el dispositivo tiene poca batería |
SUSPENDED |
La pantalla está adornada en estado de suspensión de bajo consumo. |
ApplicationReport
Información que se informa sobre una app instalada.
Representación JSON |
---|
{ "packageName": string, "versionName": string, "versionCode": integer, "events": [ { object ( |
Campos | |
---|---|
packageName |
Es el nombre de paquete de la app. |
versionName |
La versión de la app tal como se le muestra al usuario. |
versionCode |
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 app que ocurrieron en las últimas 30 horas. |
displayName |
El nombre visible de la app. |
packageSha256Hash |
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[] |
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 |
Estado de la aplicación. |
keyedAppStates[] |
Lista de estados de app con clave que informó la app. |
userFacingType |
Si la app está orientada al usuario |
ApplicationEvent
Un evento relacionado con la app
Representación JSON |
---|
{
"eventType": enum ( |
Campos | |
---|---|
eventType |
Tipo de evento de la aplicación. |
createTime |
Hora de creación del evento. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
ApplicationEventType
Es un tipo de evento relacionado con la app.
Enumeraciones | |
---|---|
APPLICATION_EVENT_TYPE_UNSPECIFIED |
No se permite este valor. |
INSTALLED |
Se instaló la app. |
CHANGED |
Se cambió la app; por ejemplo, se habilitó o inhabilitó un componente. |
DATA_CLEARED |
Se borraron los datos de la app. |
REMOVED |
Se quitó la app. |
REPLACED |
Se instaló una nueva versión de la app que reemplaza a la anterior. |
RESTARTED |
Se reinició la app. |
PINNED |
La app se fijó en primer plano. |
UNPINNED |
Se dejó de fijar la app. |
ApplicationSource
Es la fuente que proporcionó una app.
Enumeraciones | |
---|---|
APPLICATION_SOURCE_UNSPECIFIED |
La app se transfirió desde una fuente no especificada. |
SYSTEM_APP_FACTORY_VERSION |
Esta es una app del sistema que se obtiene de la imagen de fábrica del dispositivo. |
SYSTEM_APP_UPDATED_VERSION |
Esta es una app del sistema actualizada. |
INSTALLED_FROM_PLAY_STORE |
La app se instaló desde Google Play Store. |
ApplicationState
El estado de la instalación actual.
Enumeraciones | |
---|---|
APPLICATION_STATE_UNSPECIFIED |
No se especificó el estado de la app |
REMOVED |
Se quitó la app del dispositivo |
INSTALLED |
La app está instalada en el dispositivo |
KeyedAppState
Estado de la app con clave que informa la app.
Representación JSON |
---|
{
"key": string,
"severity": enum ( |
Campos | |
---|---|
key |
La clave del estado de la app. Actúa como punto de referencia para lo que la app proporciona el estado. Por ejemplo, cuando se proporcionan comentarios sobre la configuración administrada, esta podría ser la clave de configuración administrada. |
severity |
La gravedad del estado de la app. |
message |
De forma opcional, una cadena de mensaje de formato libre para explicar el estado de la app Si el estado se activó por un valor particular (p.ej., un valor de configuración administrada), se debe incluir en el mensaje. |
data |
De forma opcional, un valor legible por máquina para que lo lea la EMM. Por ejemplo, establecer valores sobre los que el administrador puede elegir realizar consultas en la consola de EMM (p.ej., “notificarme si los datos de Battery_warning < 10”). |
createTime |
La hora de creación del estado de la app en el dispositivo. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
lastUpdateTime |
La hora a la que se actualizó el estado de la app más recientemente. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
Gravedad
La gravedad del estado de la app.
Enumeraciones | |
---|---|
SEVERITY_UNSPECIFIED |
Nivel de gravedad no especificado. |
INFO |
Nivel de gravedad de la información. |
ERROR |
Nivel de gravedad del error. Esto solo se debe establecer para condiciones de error genuinas que una organización de administración debe tomar medidas para solucionar. |
UserFacingType
Si la app está orientada al usuario
Enumeraciones | |
---|---|
USER_FACING_TYPE_UNSPECIFIED |
No se especifica el tipo de usuario de la app. |
NOT_USER_FACING |
La app no está orientada al usuario. |
USER_FACING |
La app está orientada al usuario. |
NetworkInfo
Información de la red del dispositivo
Representación JSON |
---|
{
"imei": string,
"meid": string,
"wifiMacAddress": string,
"networkOperatorName": string,
"telephonyInfos": [
{
object ( |
Campos | |
---|---|
imei |
Número de IMEI del dispositivo GSM. Por ejemplo, |
meid |
Número MEID del dispositivo CDMA. Por ejemplo, |
wifiMacAddress |
Es la 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 es compatible con dispositivos completamente administrados a partir del nivel de API 23 de Android. |
TelephonyInfo
Información de telefonía asociada a una tarjeta SIM determinada del dispositivo. Solo es compatible con dispositivos completamente administrados a partir del nivel de API 23 de Android.
Representación JSON |
---|
{ "phoneNumber": string, "carrierName": string } |
Campos | |
---|---|
phoneNumber |
Es el número de teléfono asociado con esta tarjeta SIM. |
carrierName |
Indica el nombre del operador asociado con esta tarjeta SIM. |
MemoryInfo
Información sobre la memoria y el almacenamiento del dispositivo.
Representación JSON |
---|
{ "totalRam": string, "totalInternalStorage": string } |
Campos | |
---|---|
totalRam |
Total de RAM del dispositivo en bytes. |
totalInternalStorage |
Almacenamiento interno total en el dispositivo, expresado en bytes. |
MemoryEvent
Un evento relacionado con la memoria y las mediciones del almacenamiento.
Para distinguir entre eventos nuevos y antiguos, recomendamos usar el campo
.createTime
Representación JSON |
---|
{
"eventType": enum ( |
Campos | |
---|---|
eventType |
Tipo de evento. |
createTime |
Hora de creación del evento. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
byteCount |
La cantidad de bytes libres en el medio o, en el caso de |
MemoryEventType
El tipo de evento
Enumeraciones | |
---|---|
MEMORY_EVENT_TYPE_UNSPECIFIED |
Sin especificar. Ningún evento tiene este tipo. |
RAM_MEASURED |
Se midió el espacio libre en RAM. |
INTERNAL_STORAGE_MEASURED |
Se midió el espacio libre en el almacenamiento interno. |
EXTERNAL_STORAGE_DETECTED |
Se detectó un nuevo medio de almacenamiento externo. El recuento de bytes informado es la capacidad total del medio de almacenamiento. |
EXTERNAL_STORAGE_REMOVED |
Se eliminó un medio de almacenamiento externo. El recuento de bytes informado es cero. |
EXTERNAL_STORAGE_MEASURED |
Se midió el espacio libre en un medio de almacenamiento externo. |
PowerManagementEvent
Un evento de administración de energía.
Representación JSON |
---|
{
"eventType": enum ( |
Campos | |
---|---|
eventType |
Tipo de evento. |
createTime |
Hora de creación del evento. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
batteryLevel |
En el caso de los eventos |
PowerManagementEventType
El tipo de evento
Enumeraciones | |
---|---|
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED |
Sin especificar. Ningún evento tiene este tipo. |
BATTERY_LEVEL_COLLECTED |
Se midió el nivel de batería. |
POWER_CONNECTED |
El dispositivo comenzó a cargarse. |
POWER_DISCONNECTED |
El dispositivo dejó de cargarse. |
BATTERY_LOW |
El dispositivo ingresó al modo de bajo consumo. |
BATTERY_OKAY |
El dispositivo salió del modo de bajo consumo. |
BOOT_COMPLETED |
Se inició el dispositivo. |
SHUTDOWN |
Se apagó el dispositivo. |
HardwareStatus
Estado del hardware. Es posible que se comparen las temperaturas con los umbrales de temperatura disponibles en hardwareInfo
para determinar el estado del hardware.
Representación JSON |
---|
{ "createTime": string, "batteryTemperatures": [ number ], "cpuTemperatures": [ number ], "gpuTemperatures": [ number ], "skinTemperatures": [ number ], "fanSpeeds": [ number ], "cpuUsages": [ number ] } |
Campos | |
---|---|
createTime |
Es la hora en que se tomaron las mediciones. Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: |
batteryTemperatures[] |
Temperaturas actuales de la batería en Celsius para cada batería del dispositivo. |
cpuTemperatures[] |
Temperaturas actuales de la CPU en Celsius para cada CPU del dispositivo. |
gpuTemperatures[] |
Temperaturas actuales de la GPU en Celsius para cada GPU del dispositivo. |
skinTemperatures[] |
Temperaturas cutáneas actuales del dispositivo en grados Celsius. |
fanSpeeds[] |
Velocidades de los ventiladores en RPM para cada ventilador del dispositivo Un array vacío significa que no hay ventiladores o que la velocidad del ventilador no es compatible con el sistema. |
cpuUsages[] |
Porcentajes de usos de CPU de cada núcleo disponible en el dispositivo. El uso es 0 para cada núcleo desconectado. Un array vacío implica que el sistema no admite el uso de CPU. |
DeviceSettings
Información sobre la configuración del dispositivo relacionada con la seguridad.
Representación JSON |
---|
{
"isDeviceSecure": boolean,
"unknownSourcesEnabled": boolean,
"developmentSettingsEnabled": boolean,
"adbEnabled": boolean,
"isEncrypted": boolean,
"encryptionStatus": enum ( |
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 de fuentes desconocidas. |
developmentSettingsEnabled |
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 |
Estado de la encriptación de DevicePolicyManager. |
verifyAppsEnabled |
Si la verificación de Google Play Protect se aplica de manera forzosa en el dispositivo |
EncryptionStatus
Estado de encriptación de un dispositivo.
Enumeraciones | |
---|---|
ENCRYPTION_STATUS_UNSPECIFIED |
Sin especificar. Ningún dispositivo debe tener este tipo. |
UNSUPPORTED |
El dispositivo no admite la encriptación. |
INACTIVE |
El dispositivo admite la encriptación, pero no está activa actualmente. |
ACTIVATING |
La encriptación no está activa en este momento, pero se está activando. |
ACTIVE |
La encriptación está activa. |
ACTIVE_DEFAULT_KEY |
La encriptación está activa, pero el usuario no estableció una clave de encriptación. |
ACTIVE_PER_USER |
La encriptación está activa y la clave está vinculada al perfil del usuario. |
SecurityPosture
La postura de seguridad del dispositivo, según lo determinado por el estado actual del dispositivo y las políticas aplicadas.
Representación JSON |
---|
{ "devicePosture": enum ( |
Campos | |
---|---|
devicePosture |
Valor de posición de seguridad del dispositivo. |
postureDetails[] |
Son los detalles adicionales sobre la postura de seguridad del dispositivo. |
DevicePosture
Posibles valores de postura de seguridad de un dispositivo administrado.
Enumeraciones | |
---|---|
POSTURE_UNSPECIFIED |
Sin especificar. No hay detalles de postura para este valor de postura. |
SECURE |
Este dispositivo es seguro. |
AT_RISK |
Este dispositivo puede ser más vulnerable a agentes maliciosos de lo que se recomienda para su uso con datos corporativos. |
POTENTIALLY_COMPROMISED |
Es posible que este dispositivo esté comprometido y que agentes no autorizados puedan acceder a los datos corporativos. |
PostureDetail
Son los detalles adicionales sobre la postura de seguridad del dispositivo.
Representación JSON |
---|
{ "securityRisk": enum ( |
Campos | |
---|---|
securityRisk |
Es un riesgo de seguridad específico que afecta negativamente la postura de seguridad del dispositivo. |
advice[] |
Los consejos del administrador que correspondan para mitigar este riesgo de seguridad y mejorar la postura de seguridad del dispositivo. |
SecurityRisk
El riesgo que hace que el dispositivo no se encuentre en el estado más seguro.
Enumeraciones | |
---|---|
SECURITY_RISK_UNSPECIFIED |
Sin especificar. |
UNKNOWN_OS |
La API de Play Integrity detecta que el dispositivo ejecuta un SO desconocido (la verificación debasicIntegrity se realiza correctamente, pero ctsProfileMatch falla). |
COMPROMISED_OS |
La API de Play Integrity detecta que el dispositivo ejecuta un SO comprometido (falla la verificación debasicIntegrity). |
HARDWARE_BACKED_EVALUATION_FAILED |
La API de Play Integrity detecta que el dispositivo no tiene una garantía sólida de integridad del sistema si no se muestra la etiqueta MEETS_STRONG_INTEGRITY en el campo de integridad del dispositivo. |
CommonCriteriaModeInfo
Información sobre el modo Common Criteria: estándares de seguridad definidos en los Common Criteria para la evaluación de la seguridad de la tecnología de la información (CC).
Esta información solo estará disponible si statusReportingSettings.commonCriteriaModeEnabled
está true
en la política del dispositivo.
Representación JSON |
---|
{
"commonCriteriaModeStatus": enum ( |
Campos | |
---|---|
commonCriteriaModeStatus |
Si el modo Common Criteria está habilitado. |
CommonCriteriaModeStatus
Si el modo Common Criteria está habilitado.
Enumeraciones | |
---|---|
COMMON_CRITERIA_MODE_STATUS_UNKNOWN |
Estado desconocido. |
COMMON_CRITERIA_MODE_DISABLED |
El modo Common Criteria está inhabilitado en este momento. |
COMMON_CRITERIA_MODE_ENABLED |
El modo Common Criteria está habilitado. |
DpcMigrationInfo
Información relacionada con si este dispositivo se migró para dejar de ser administrado por otro controlador de política de dispositivo (DPC).
Representación JSON |
---|
{ "previousDpc": string, "additionalData": string } |
Campos | |
---|---|
previousDpc |
Solo salida. Si este dispositivo se migró desde otro DPC, este es el nombre del paquete. De lo contrario, no se propaga. |
additionalData |
Solo salida. Si este dispositivo se migró desde otro DPC, el campo |
Métodos |
|
---|---|
|
Borra un dispositivo. |
|
Obtiene un dispositivo. |
|
Emite un comando a un dispositivo. |
|
Muestra una lista de los dispositivos de una empresa determinada. |
|
Actualiza un dispositivo. |