- Recurso: Device
- DeviceState
- NonComplianceDetail
- InstallationFailureReason
- SpecificNonComplianceReason
- SpecificNonComplianceContext
- OncWifiContext
- PasswordPoliciesContext
- SoftwareInfo
- SystemUpdateInfo
- UpdateStatus
- HardwareInfo
- Anuncio gráfico
- 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: 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 ( |
Campos | |
---|---|
name |
Es el nombre del dispositivo con el formato |
userName |
El nombre del recurso del usuario que posee este dispositivo con el formato |
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 |
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 |
appliedState |
Es 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 con los requisitos. |
enrollmentTime |
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: |
lastStatusReportTime |
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: |
lastPolicyComplianceReportTime |
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: |
lastPolicySyncTime |
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: |
policyName |
El nombre de la política que se aplicó al dispositivo, en 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 |
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 |
Información detallada sobre el hardware del dispositivo. |
displays[] |
Información detallada sobre las pantallas en el dispositivo. Esta información solo está disponible si |
applicationReports[] |
Informes de 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 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 |
Información sobre la red del dispositivo. Esta información solo está disponible si |
memoryInfo |
Información sobre 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 retienen por un período determinado y se borran los eventos antiguos. |
powerManagementEvents[] |
Eventos de administración de energía en el dispositivo en orden cronológico. Esta información solo está disponible si |
hardwareStatusSamples[] |
Muestras de estado del hardware en orden cronológico. Esta información solo está disponible si |
deviceSettings |
Información de configuración del dispositivo. Esta información solo está disponible si |
user |
Es el usuario propietario del dispositivo. |
systemProperties |
Mapa del nombre y el valor de las propiedades del sistema seleccionadas relacionados con el dispositivo Esta información solo está disponible si Es un objeto que contiene una lista de pares |
securityPosture |
El valor de postura de seguridad del dispositivo que refleja qué tan seguro es. |
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[] |
Los requisitos de contraseña que se aplican actualmente al dispositivo.
|
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 ( |
Campos | |
---|---|
settingName |
El nombre de la configuración de política. Este es el nombre del campo JSON de un campo |
nonComplianceReason |
Indica el motivo por el que el dispositivo no cumple con la configuración. |
packageName |
Es el nombre del paquete que indica qué app no cumple con las políticas (si corresponde). |
fieldPath |
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 |
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 el parámetro de configuración. |
specificNonComplianceContext |
Contexto adicional para |
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 |
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 . |
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED |
El usuario debe confirmar las credenciales ingresando el bloqueo de pantalla. No se configuraron los campos en . se estableció en . |
PASSWORD_POLICIES_PASSWORD_EXPIRED |
Venció la contraseña del dispositivo o del perfil. Se estableció . se estableció en . |
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT |
La contraseña del dispositivo no cumple con los requisitos de contraseña. Se estableció . se estableció en . |
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 estableció . se estableció en . |
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. especifica qué valor de campo no se admite. Se estableció . se estableció en . |
ONC_WIFI_INVALID_ENTERPRISE_CONFIG |
Falta la CA 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 la red Wi-Fi configurada de forma manual. 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 estableció en . |
SpecificNonComplianceContext
Contexto adicional para
.SpecificNonComplianceReason
Representación JSON |
---|
{ "oncWifiContext": { object ( |
Campos | |
---|---|
oncWifiContext |
Contexto adicional para incumplimientos relacionados con la configuración de Wi-Fi. Consulta |
passwordPoliciesContext |
Contexto adicional para incumplimientos relacionados con las políticas de contraseñas. Consulta |
OncWifiContext
Contexto adicional para incumplimientos relacionados 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 las políticas. |
PasswordPoliciesContext
Contexto adicional para 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 que ve el usuario. Por ejemplo, |
androidDevicePolicyVersionCode |
El código de versión de la app de Android Device Policy |
androidDevicePolicyVersionName |
La versión de la app de Android Device Policy tal como se le muestra al usuario |
androidBuildNumber |
Es la 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 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 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, Una marca de tiempo en formato RFC3339 UTC “Zulú”, con 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.
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 |
Es la marca del dispositivo. Por ejemplo, |
hardware |
Es el 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 |
Es el modelo del dispositivo. Por ejemplo, |
batteryShutdownTemperatures[] |
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 batería en Celsius para cada batería del dispositivo. |
cpuShutdownTemperatures[] |
Umbrales de temperatura de apagado de la CPU en grados Celsius para cada CPU del dispositivo. |
cpuThrottlingTemperatures[] |
Umbrales de temperatura de limitación de CPU en Celsius para cada CPU del dispositivo. |
gpuShutdownTemperatures[] |
Umbrales de temperatura de apagado de la GPU en Celsius para cada GPU del dispositivo. |
gpuThrottlingTemperatures[] |
Umbrales de temperatura de limitación de GPU en Celsius para cada GPU del dispositivo. |
skinShutdownTemperatures[] |
Umbrales de temperatura de apagado de la piel del dispositivo en Celsius. |
skinThrottlingTemperatures[] |
Umbrales de temperatura de limitación cutánea del dispositivo en Celsius. |
enterpriseSpecificId |
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 ( |
Campos | |
---|---|
name |
Es el nombre de la pantalla. |
displayId |
ID de visualización único. |
refreshRate |
Frecuencia de actualización de la pantalla en fotogramas por segundo. |
state |
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 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 ( |
Campos | |
---|---|
packageName |
Es el nombre del paquete de la app. |
versionName |
Es 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[] |
La lista de eventos de aplicaciones que ocurrieron en las últimas 30 horas. |
displayName |
Es 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 |
El nombre del paquete de la app que instaló esta app. |
applicationSource |
Es la fuente del paquete. |
state |
Estado de la aplicación |
keyedAppStates[] |
Es la lista de estados de apps con clave informados por la app. |
userFacingType |
Si la app es para el usuario |
ApplicationEvent
Un evento relacionado con la app
Representación JSON |
---|
{
"eventType": enum ( |
Campos | |
---|---|
eventType |
Tipo de evento de aplicación. |
createTime |
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: |
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 ( |
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 proporcionen comentarios sobre la configuración administrada, esta clave podría ser la 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ó a partir de un valor particular (p.ej., un valor de configuración administrada), se debe incluir en el mensaje. |
data |
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 |
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: |
lastUpdateTime |
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: |
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 ( |
Campos | |
---|---|
imei |
Es el número 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 en orden alfabético del operador registrado actual. Por ejemplo, Vodafone. |
telephonyInfos[] |
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 |
El número de teléfono asociado con esta tarjeta SIM. |
carrierName |
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 |
Total de RAM en el dispositivo expresado en bytes. |
totalInternalStorage |
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 ( |
Campos | |
---|---|
eventType |
Tipo de evento. |
createTime |
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: |
byteCount |
La cantidad de bytes libres en el medio o, en |
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 ( |
Campos | |
---|---|
eventType |
Tipo de evento. |
createTime |
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: |
batteryLevel |
En el caso de los eventos |
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 |
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: |
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 actuales de la piel del dispositivo en Celsius. |
fanSpeeds[] |
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[] |
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 ( |
Campos | |
---|---|
isDeviceSecure |
Indica si el dispositivo está protegido con PIN o contraseña. |
unknownSourcesEnabled |
Si se habilita la instalación de apps de 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 |
Estado de encriptación de DevicePolicyManager |
verifyAppsEnabled |
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 ( |
Campos | |
---|---|
devicePosture |
Valor de postura de seguridad del dispositivo. |
postureDetails[] |
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 ( |
Campos | |
---|---|
securityRisk |
Un riesgo de seguridad específico que afecta negativamente la postura de seguridad del dispositivo. |
advice[] |
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 ( |
Campos | |
---|---|
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 |
Solo salida. Si este dispositivo se migró desde otro DPC, este es el nombre del paquete. De lo contrario, no se propagará. |
additionalData |
Solo salida. Si este dispositivo se migró desde otro DPC, aquí se propaga 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. |