- Recurso: Policy
- ApplicationPolicy
- InstallType
- PermissionPolicy
- PermissionGrant
- DelegatedScope
- ManagedConfigurationTemplate
- ConnectedWorkAndPersonalApp
- AutoUpdateMode
- ExtensionConfig
- AlwaysOnVpnLockdownExemption
- WorkProfileWidgets
- CredentialProviderPolicy
- CustomAppConfig
- UserUninstallSettings
- InstallConstraint
- NetworkTypeConstraint
- ChargingConstraint
- DeviceIdleConstraint
- UserControlSettings
- PreferentialNetworkId
- ApplicationSigningKeyCert
- KeyguardDisabledFeature
- PersistentPreferredActivity
- SystemUpdate
- SystemUpdateType
- FreezePeriod
- Fecha
- StatusReportingSettings
- ApplicationReportingSettings
- PackageNameList
- BatteryPluggedMode
- ProxyInfo
- ChoosePrivateKeyRule
- AlwaysOnVpnPackage
- LocationMode
- ComplianceRule
- NonComplianceDetailCondition
- ApiLevelCondition
- AppAutoUpdatePolicy
- AppTrack
- EncryptionPolicy
- PlayStoreMode
- SetupAction
- LaunchAppAction
- PolicyEnforcementRule
- BlockAction
- BlockScope
- WipeAction
- KioskCustomization
- PowerButtonActions
- SystemErrorWarnings
- SystemNavigation
- StatusBar
- DeviceSettings
- AdvancedSecurityOverrides
- UntrustedAppsPolicy
- GooglePlayProtectVerifyApps
- DeveloperSettings
- CommonCriteriaMode
- MtePolicy
- ContentProtectionPolicy
- PersonalUsagePolicies
- PlayStoreMode
- PersonalApplicationPolicy
- InstallType
- PrivateSpacePolicy
- BluetoothSharing
- AutoDateAndTimeZone
- OncCertificateProvider
- ContentProviderEndpoint
- CrossProfilePolicies
- ShowWorkContactsInPersonalProfile
- CrossProfileCopyPaste
- CrossProfileDataSharing
- WorkProfileWidgetsDefault
- CrossProfileAppFunctions
- PreferentialNetworkService
- UsageLog
- LogType
- CameraAccess
- MicrophoneAccess
- DeviceConnectivityManagement
- UsbDataAccess
- ConfigureWifi
- WifiDirectSettings
- TetheringSettings
- WifiSsidPolicy
- WifiSsidPolicyType
- WifiSsid
- WifiRoamingPolicy
- WifiRoamingSetting
- WifiRoamingMode
- BluetoothSharing
- PreferentialNetworkServiceSettings
- PreferentialNetworkServiceConfig
- FallbackToDefaultConnection
- NonMatchingNetworks
- ApnPolicy
- OverrideApns
- ApnSetting
- ApnType
- AlwaysOnSetting
- AuthType
- MvnoType
- NetworkType
- Protocol
- DeviceRadioState
- WifiState
- AirplaneModeState
- UltraWidebandState
- CellularTwoGState
- MinimumWifiSecurityLevel
- CredentialProviderPolicyDefault
- PrintingPolicy
- DisplaySettings
- ScreenBrightnessSettings
- ScreenBrightnessMode
- ScreenTimeoutSettings
- ScreenTimeoutMode
- AssistContentPolicy
- WorkAccountSetupConfig
- AuthenticationType
- WipeDataFlag
- EnterpriseDisplayNameVisibility
- AppFunctions
- Métodos
Recurso: Policy
Un recurso de política representa un grupo de parámetros de configuración que rigen el comportamiento de un dispositivo administrado y las apps instaladas en él.
Representación JSON |
---|
{ "name": string, "version": string, "applications": [ { object ( |
Campos | |
---|---|
name |
Nombre de la política con el formato |
version |
Es la versión de la política. Este campo es de solo lectura. La versión se incrementa cada vez que se actualiza la política. |
applications[] |
Política aplicada a las apps. Puede tener hasta 3,000 elementos. |
maximumTimeToLock |
Es el tiempo máximo en milisegundos de actividad del usuario hasta que se bloquea el dispositivo. Un valor de 0 significa que no hay restricciones. |
screenCaptureDisabled |
Indica si la captura de pantalla está inhabilitada. |
cameraDisabled |
Si |
keyguardDisabledFeatures[] |
Se inhabilitaron las personalizaciones de la protección con contraseña, como los widgets. |
defaultPermissionPolicy |
Es la política de permisos predeterminada para las solicitudes de permisos de tiempo de ejecución. |
persistentPreferredActivities[] |
Son las actividades del controlador de intents predeterminado. |
openNetworkConfiguration |
Es la configuración de red del dispositivo. Consulta cómo configurar redes para obtener más información. |
systemUpdate |
Es la política de actualización del sistema, que controla cómo se aplican las actualizaciones del SO. Si el tipo de actualización es Nota: Las actualizaciones del sistema de Google Play (también llamadas actualizaciones de Mainline) se descargan automáticamente y requieren que se reinicie el dispositivo para instalarse. Consulta la sección de mainline en Cómo administrar actualizaciones del sistema para obtener más detalles. |
accountTypesWithManagementDisabled[] |
Son los tipos de cuentas que el usuario no puede administrar. |
addUserDisabled |
Indica si está inhabilitada la opción para agregar usuarios y perfiles nuevos. En los dispositivos en los que |
adjustVolumeDisabled |
Indica si está inhabilitado el ajuste del volumen principal. También silencia el dispositivo. El parámetro de configuración solo tiene efecto en los dispositivos completamente administrados. |
factoryResetDisabled |
Indica si se inhabilitó el restablecimiento de la configuración de fábrica desde la configuración. |
installAppsDisabled |
Indica si está inhabilitada la instalación de apps por parte del usuario. |
mountPhysicalMediaDisabled |
Indica si el usuario que activa el medio externo físico está inhabilitado. |
modifyAccountsDisabled |
Indica si está inhabilitada la opción para agregar o quitar cuentas. |
safeBootDisabled |
Indica si está inhabilitado el reinicio del dispositivo en modo seguro. |
uninstallAppsDisabled |
Indica si está inhabilitada la desinstalación de aplicaciones por parte del usuario. Esto impide que se desinstalen las apps, incluso las que se quitaron con |
statusBarDisabled |
Indica si la barra de estado está inhabilitada. Esto inhabilita las notificaciones, la configuración rápida y otras superposiciones de pantalla que permiten salir del modo de pantalla completa. OBSOLETO. Para inhabilitar la barra de estado en un dispositivo de kiosco, usa InstallType |
keyguardDisabled |
Si es verdadero, inhabilita la pantalla de bloqueo para las pantallas principal o secundaria. Esta política solo se admite en el modo de administración de dispositivos dedicados. |
minimumApiLevel |
Es el nivel de API de Android mínimo permitido. |
statusReportingSettings |
Configuración de informes de estado |
bluetoothContactSharingDisabled |
Indica si se inhabilitó el uso compartido de contactos por Bluetooth. |
shortSupportMessage |
Es un mensaje que se muestra al usuario en la pantalla de configuración cuando el administrador inhabilitó la funcionalidad. Si el mensaje tiene más de 200 caracteres, es posible que se trunque. |
longSupportMessage |
Es un mensaje que se muestra al usuario en la pantalla de configuración de administradores de dispositivos. |
passwordRequirements |
Requisitos de la contraseña No se debe establecer el campo Nota: Aquí no se pueden usar valores basados en la complejidad de |
wifiConfigsLockdownEnabled |
Esta opción dejó de estar disponible. |
bluetoothConfigDisabled |
Indica si la configuración de Bluetooth está inhabilitada. |
cellBroadcastsConfigDisabled |
Indica si está inhabilitada la configuración de la emisión móvil. |
credentialsConfigDisabled |
Indica si está inhabilitada la configuración de las credenciales del usuario. |
mobileNetworksConfigDisabled |
Indica si está inhabilitada la configuración de redes móviles. |
tetheringConfigDisabled |
Indica si está inhabilitada la configuración de la conexión mediante dispositivo móvil y los hotspots portátiles. Si |
vpnConfigDisabled |
Indica si está inhabilitada la configuración de la VPN. |
wifiConfigDisabled |
Indica si está inhabilitada la configuración de redes Wi-Fi. Se admite en dispositivos completamente administrados y perfiles de trabajo en dispositivos empresariales. En el caso de los dispositivos completamente administrados, si se establece este parámetro en verdadero, se quitan todas las redes configuradas y solo se conservan las redes configuradas con |
createWindowsDisabled |
Indica si se inhabilitó la creación de ventanas que no sean de la app. |
networkResetDisabled |
Indica si está inhabilitado el restablecimiento de la configuración de red. |
outgoingBeamDisabled |
Indica si está inhabilitado el uso de NFC para transmitir datos desde apps. |
outgoingCallsDisabled |
Indica si las llamadas salientes están inhabilitadas. |
removeUserDisabled |
Indica si está inhabilitada la opción para quitar a otros usuarios. |
shareLocationDisabled |
Indica si la función Compartir ubicación está inhabilitada. |
smsDisabled |
Indica si se inhabilitó el envío y la recepción de mensajes SMS. |
unmuteMicrophoneDisabled |
Si |
usbFileTransferDisabled |
Indica si se inhabilitó la transferencia de archivos por USB. Esta función solo es compatible con dispositivos empresariales. |
ensureVerifyAppsEnabled |
Indica si la verificación de apps está habilitada de forma obligatoria. |
permittedInputMethods |
Si está presente, solo se permiten los métodos de entrada proporcionados por los paquetes de esta lista. Si este campo está presente, pero la lista está vacía, solo se permiten los métodos de entrada del sistema. |
stayOnPluggedModes[] |
Son los modos con batería enchufada para los que el dispositivo permanece encendido. Cuando uses este parámetro de configuración, se recomienda borrar |
recommendedGlobalProxy |
Es el proxy HTTP global independiente de la red. Por lo general, los proxies se deben configurar por red en |
setUserIconDisabled |
Indica si se inhabilitó el cambio del ícono de usuario. El parámetro de configuración solo tiene efecto en los dispositivos completamente administrados. |
setWallpaperDisabled |
Indica si está inhabilitado el cambio de fondo de pantalla. |
choosePrivateKeyRules[] |
Son reglas para determinar el acceso de las apps a las claves privadas. Consulta |
alwaysOnVpnPackage |
Es la configuración de una conexión VPN siempre activada. Se usa con |
frpAdminEmails[] |
Direcciones de correo electrónico de los administradores del dispositivo para la protección contra restablecimiento de la configuración de fábrica. Cuando se restablezca la configuración de fábrica del dispositivo, se requerirá que uno de estos administradores acceda con el correo electrónico y la contraseña de la Cuenta de Google para desbloquear el dispositivo. Si no se especifican administradores, el dispositivo no proporcionará protección contra restablecimiento de la configuración de fábrica. |
deviceOwnerLockScreenInfo |
Es la información del propietario del dispositivo que se mostrará en la pantalla de bloqueo. |
dataRoamingDisabled |
Indica si los servicios de datos en roaming están inhabilitados. |
locationMode |
Es el grado de detección de ubicación habilitado. |
networkEscapeHatchEnabled |
Indica si el escape de red está habilitado. Si no se puede establecer una conexión de red durante el inicio, la función de escape le solicita al usuario que se conecte temporalmente a una red para actualizar la política del dispositivo. Después de aplicar la política, se olvidará la red temporal y el dispositivo seguirá iniciando. Esto evita que no se pueda conectar a una red si no hay una red adecuada en la última política y el dispositivo se inicia en una app en modo de tarea bloqueada, o bien si el usuario no puede acceder a la configuración del dispositivo. Nota: Establecer |
bluetoothDisabled |
Indica si el Bluetooth está inhabilitado. Se recomienda usar este parámetro de configuración en lugar de |
complianceRules[] |
Son reglas que declaran qué acciones de mitigación se deben tomar cuando un dispositivo no cumple con su política. Cuando se cumplen las condiciones de varias reglas, se toman todas las acciones de mitigación correspondientes. Hay un límite máximo de 100 reglas. En su lugar, usa reglas de aplicación de políticas. |
blockApplicationsEnabled |
Indica si se bloquea la instalación de aplicaciones que no sean las configuradas en |
installUnknownSourcesAllowed |
Este campo no tiene efecto. |
debuggingFeaturesAllowed |
Indica si el usuario puede habilitar funciones de depuración. |
funDisabled |
Indica si el usuario puede divertirse. Controla si se inhabilita el juego de huevo de Pascua en la Configuración. |
autoTimeRequired |
Indica si se requiere la hora automática, lo que impide que el usuario configure la fecha y la hora de forma manual. Si se establece |
permittedAccessibilityServices |
Especifica los servicios de accesibilidad permitidos. Si no se configura el campo, se puede usar cualquier servicio de accesibilidad. Si se configura el campo, solo se pueden usar los servicios de accesibilidad de esta lista y el servicio de accesibilidad integrado del sistema. En particular, si el campo está vacío, solo se pueden usar los servicios de accesibilidad integrados del sistema. Se puede configurar en dispositivos completamente administrados y en perfiles de trabajo. Cuando se aplica a un perfil de trabajo, afecta tanto al perfil personal como al perfil de trabajo. |
appAutoUpdatePolicy |
Alternativa recomendada: Cuando Es la política de actualización automática de la app, que controla cuándo se pueden aplicar las actualizaciones automáticas de la app. |
kioskCustomLauncherEnabled |
Indica si el selector personalizado del quiosco está habilitado. Esto reemplaza la pantalla principal por un selector que bloquea el dispositivo para las apps instaladas a través del parámetro de configuración |
androidDevicePolicyTracks[] |
No se admite este parámetro de configuración. Se ignora cualquier valor. |
skipFirstUseHintsEnabled |
Es una marca para omitir las sugerencias en el primer uso. El administrador de la empresa puede habilitar la recomendación del sistema para que las apps omitan el tutorial del usuario y otras sugerencias introductorias en el primer inicio. |
privateKeySelectionEnabled |
Permite mostrar la IU en un dispositivo para que el usuario elija un alias de clave privada si no hay reglas coincidentes en ChoosePrivateKeyRules. En dispositivos con versiones anteriores a Android P, configurar este parámetro puede dejar las claves empresariales vulnerables. Este valor no tendrá efecto si alguna aplicación tiene el alcance de delegación |
encryptionPolicy |
Si la encriptación está habilitada |
usbMassStorageEnabled |
Indica si el almacenamiento USB está habilitado. Obsoleta. |
permissionGrants[] |
Permisos o denegaciones explícitos de permisos para todas las apps Estos valores anulan el |
playStoreMode |
Este modo controla qué apps están disponibles para el usuario en Play Store y el comportamiento del dispositivo cuando se quitan apps de la política. |
setupActions[] |
Es la acción que se debe realizar durante el proceso de configuración. Se puede especificar como máximo una acción. |
passwordPolicies[] |
Políticas de requisitos de contraseñas Se pueden establecer diferentes políticas para los perfiles de trabajo o los dispositivos completamente administrados configurando el campo |
policyEnforcementRules[] |
Son reglas que definen el comportamiento cuando no se puede aplicar una política específica en el dispositivo. |
kioskCustomization |
Es la configuración que controla el comportamiento de un dispositivo en modo kiosco. Para habilitar el modo kiosco, establece |
advancedSecurityOverrides |
Parámetros de configuración de seguridad avanzados En la mayoría de los casos, no es necesario configurar estos parámetros. |
personalUsagePolicies |
Políticas que administran el uso personal en un dispositivo empresarial |
autoDateAndTimeZone |
Indica si la fecha, la hora y la zona horaria automáticas están habilitadas en un dispositivo propiedad de la empresa. Si se establece este parámetro, se ignora |
oncCertificateProviders[] |
Esta función no está disponible de forma general. |
crossProfilePolicies |
Son las políticas entre perfiles que se aplican en el dispositivo. |
preferentialNetworkService |
Controla si el servicio de red preferencial está habilitado en el perfil de trabajo o en dispositivos completamente administrados. Por ejemplo, una organización puede tener un acuerdo con un operador para que todos los datos de trabajo de los dispositivos de sus empleados se envíen a través de un servicio de red dedicado para uso empresarial. Un ejemplo de un servicio de red preferencial compatible es la sección empresarial en redes 5G. Esta política no tiene efecto si se configuran |
usageLog |
Es la configuración del registro de actividad del dispositivo. |
cameraAccess |
Controla el uso de la cámara y si el usuario tiene acceso al botón de activación de acceso a la cámara. |
microphoneAccess |
Controla el uso del micrófono y si el usuario tiene acceso al botón de activación del micrófono. Esto solo se aplica a los dispositivos completamente administrados. |
deviceConnectivityManagement |
Abarca los controles de conectividad del dispositivo, como Wi-Fi, acceso a datos USB, conexiones de teclado y mouse, y mucho más. |
deviceRadioState |
Abarca los controles del estado de la radio, como Wi-Fi, Bluetooth y mucho más. |
credentialProviderPolicyDefault |
Controla qué apps pueden actuar como proveedores de credenciales en Android 14 y versiones posteriores. Estas apps almacenan credenciales. Consulta este y este vínculo para obtener más información. Consulta también |
printingPolicy |
Opcional. Controla si se permite la impresión. Esta función es compatible con dispositivos que ejecutan Android 9 y versiones posteriores. . |
displaySettings |
Opcional. Controles para la configuración de la pantalla. |
assistContentPolicy |
Opcional. Controla si se permite enviar AssistContent a una app privilegiada, como una app de asistente. AssistContent incluye capturas de pantalla e información sobre una app, como el nombre del paquete. Esta función es compatible con Android 15 y versiones posteriores. |
workAccountSetupConfig |
Opcional. Controla la configuración de la cuenta de trabajo, como los detalles sobre si se requiere una cuenta autenticada de Google. |
wipeDataFlags[] |
Opcional. Son marcas de borrado que indican qué datos se borran cuando se activa el borrado de un dispositivo o perfil por cualquier motivo (por ejemplo, incumplimiento). Esto no se aplica al método |
enterpriseDisplayNameVisibility |
Opcional. Controla si el |
appFunctions |
Opcional. Controla si las apps del dispositivo (en el caso de los dispositivos completamente administrados) o del perfil de trabajo (en el caso de los dispositivos con perfiles de trabajo) pueden exponer funciones de la app. |
ApplicationPolicy
Política para una app individual. Nota: La disponibilidad de la aplicación en un dispositivo determinado no se puede cambiar con esta política si
está habilitado. La cantidad máxima de aplicaciones que puedes especificar por política es de 3,000.installAppsDisabled
Representación JSON |
---|
{ "packageName": string, "installType": enum ( |
Campos | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
packageName |
Es el nombre del paquete de la app, por ejemplo, |
||||||||||||||||
installType |
Es el tipo de instalación que se realizará. |
||||||||||||||||
lockTaskAllowed |
Indica si la app puede bloquearse en modo de pantalla completa. OBSOLETO. Usa InstallType |
||||||||||||||||
defaultPermissionPolicy |
Es la política predeterminada para todos los permisos que solicita la app. Si se especifica, anula el valor de |
||||||||||||||||
permissionGrants[] |
Permisos explícitos otorgados o denegados para la app. Estos valores anulan los valores |
||||||||||||||||
managedConfiguration |
Es la configuración administrada que se aplica a la app. El formato de la configuración está determinado por los valores de
|
||||||||||||||||
disabled |
Indica si la app está inhabilitada. Cuando se inhabilita, los datos de la app se conservan. |
||||||||||||||||
minimumVersionCode |
Es la versión mínima de la app que se ejecuta en el dispositivo. Si se configura, el dispositivo intentará actualizar la app al menos a este código de versión. Si la app no está actualizada, el dispositivo contendrá un objeto |
||||||||||||||||
delegatedScopes[] |
Son los permisos delegados a la app desde Android Device Policy. Estos proporcionan privilegios adicionales para las aplicaciones a las que se aplican. |
||||||||||||||||
managedConfigurationTemplate |
Es la plantilla de configuración administrada de la app, guardada desde el iframe de configuración administrada. Este campo se ignora si se establece managedConfiguration. |
||||||||||||||||
accessibleTrackIds[] |
Es la lista de los IDs de los segmentos de la app a los que puede acceder un dispositivo que pertenece a la empresa. Si la lista contiene varios IDs de segmentos, los dispositivos recibirán la versión más reciente entre todos los segmentos accesibles. Si la lista no contiene IDs de seguimiento, los dispositivos solo tendrán acceso al segmento de producción de la app. Puedes encontrar más detalles sobre cada segmento en AppTrackInfo. |
||||||||||||||||
connectedWorkAndPersonalApp |
Controla si la app puede comunicarse consigo misma entre los perfiles personales y de trabajo de un dispositivo, sujeto al consentimiento del usuario. |
||||||||||||||||
autoUpdateMode |
Controla el modo de actualización automática de la app. |
||||||||||||||||
extensionConfig |
Es la configuración para habilitar esta app como una app de extensión, con la capacidad de interactuar con la Política de dispositivos Android sin conexión. Este campo se puede establecer para un máximo de una app. La huella digital del certificado de la clave de firma de la app en el dispositivo debe coincidir con una de las entradas en |
||||||||||||||||
alwaysOnVpnLockdownExemption |
Especifica si la app puede usar la red cuando la VPN no está conectada y |
||||||||||||||||
workProfileWidgets |
Especifica si la app instalada en el perfil de trabajo puede agregar widgets a la pantalla principal. |
||||||||||||||||
credentialProviderPolicy |
Opcional. Indica si la app puede actuar como proveedor de credenciales en Android 14 y versiones posteriores. |
||||||||||||||||
customAppConfig |
Opcional. Es la configuración de esta app personalizada.
|
||||||||||||||||
installConstraint[] |
Opcional. Son las restricciones para instalar la app. Puedes especificar un máximo de un |
||||||||||||||||
installPriority |
Opcional. Entre las apps con Controla la prioridad relativa de la instalación. El valor 0 (predeterminado) significa que esta app no tiene prioridad sobre otras. Para los valores entre 1 y 10,000, un valor más bajo significa una prioridad más alta. Se rechazan los valores fuera del rango de 0 a 10,000 inclusive. |
||||||||||||||||
userControlSettings |
Opcional. Especifica si se permite el control del usuario para la app. El control del usuario incluye acciones como detener la app de forma forzada y borrar sus datos. Algunos tipos de apps reciben un tratamiento especial. Consulta |
||||||||||||||||
preferentialNetworkId |
Opcional. Es el ID de la red preferencial que usa la aplicación. Debe haber una configuración para el ID de red especificado en |
||||||||||||||||
signingKeyCerts[] |
Opcional. Son los certificados de la clave de firma de la app. Este campo es obligatorio en los siguientes casos:
Si no se establece este campo para una app personalizada, se rechazará la política. Si no se configura cuando se requiere para una app no personalizada, se informa un En otros casos, este campo es opcional y se usan los certificados de la clave de firma obtenidos de Play Store. Consulta la siguiente configuración de la política para ver cómo se usa este campo: |
InstallType
Es el tipo de instalación que se realizará para una app. Si
hace referencia a una app, debe tener setupAction
establecido como installType
REQUIRED_FOR_SETUP
o la configuración fallará.
Enumeraciones | |
---|---|
INSTALL_TYPE_UNSPECIFIED |
Sin especificar. El valor predeterminado es AVAILABLE. |
PREINSTALLED |
La app se instala automáticamente y el usuario puede quitarla. |
FORCE_INSTALLED |
La app se instala automáticamente, independientemente del período de mantenimiento establecido, y el usuario no puede quitarla. |
BLOCKED |
La app está bloqueada y no se puede instalar. Si la app se instaló conforme a una política previa, se desinstalará. Esto también bloquea la funcionalidad de la app instantánea. |
AVAILABLE |
La app está disponible para instalarse. |
REQUIRED_FOR_SETUP |
La app se instala automáticamente y el usuario no puede quitarla. Además, impedirá que se complete la configuración hasta que finalice la instalación. |
KIOSK |
La app se instala automáticamente en el modo de kiosco: se establece como la intención de la página principal preferida y se incluye en la lista blanca para el modo de tarea bloqueada. La configuración del dispositivo no se completará hasta que se instale la app. Después de la instalación, los usuarios no podrán quitar la app. Solo puedes establecer este installType para una app por política. Cuando este parámetro está presente en la política, la barra de estado se inhabilita automáticamente. |
CUSTOM |
La app solo se puede instalar y actualizar a través del comando del SDK de AMAPI. Nota:
|
PermissionPolicy
Política para otorgar solicitudes de permisos a las apps.
Enumeraciones | |
---|---|
PERMISSION_POLICY_UNSPECIFIED |
No se especificó la política. Si no se especifica ninguna política para un permiso en ningún nivel, se usará el comportamiento PROMPT de forma predeterminada. |
PROMPT |
Le solicita al usuario que otorgue un permiso. |
GRANT |
Otorga un permiso automáticamente. En Android 12 y versiones posteriores, |
DENY |
Rechaza un permiso de forma automática. |
PermissionGrant
Es la configuración de un permiso de Android y su estado de concesión.
Representación JSON |
---|
{
"permission": string,
"policy": enum ( |
Campos | |
---|---|
permission |
Permiso o grupo de Android, p.ej., |
policy |
Política para otorgar el permiso. |
DelegatedScope
Son los alcances de delegación que otro paquete puede adquirir desde Android Device Policy. Estos proporcionan privilegios adicionales para las aplicaciones a las que se aplican.
Enumeraciones | |
---|---|
DELEGATED_SCOPE_UNSPECIFIED |
No se especificó ningún alcance de delegación. |
CERT_INSTALL |
Otorga acceso a la instalación y administración de certificados. Este alcance se puede delegar a varias aplicaciones. |
MANAGED_CONFIGURATIONS |
Otorga acceso a la administración de la configuración administrada. Este alcance se puede delegar a varias aplicaciones. |
BLOCK_UNINSTALL |
Otorga acceso para bloquear la desinstalación. Este alcance se puede delegar a varias aplicaciones. |
PERMISSION_GRANT |
Otorga acceso a la política de permisos y al estado de concesión de permisos. Este alcance se puede delegar a varias aplicaciones. |
PACKAGE_ACCESS |
Otorga acceso al estado de acceso al paquete. Este alcance se puede delegar a varias aplicaciones. |
ENABLE_SYSTEM_APP |
Otorga acceso para habilitar apps del sistema. Este alcance se puede delegar a varias aplicaciones. |
NETWORK_ACTIVITY_LOGS |
Otorga acceso a los registros de actividad de red. Permite que la aplicación delegada llame a los métodos setNetworkLoggingEnabled , isNetworkLoggingEnabled y retrieveNetworkLogs . Este alcance se puede delegar a una sola aplicación como máximo. Es compatible con dispositivos completamente administrados que ejecutan Android 10 y versiones posteriores. Se admite en un perfil de trabajo en Android 12 y versiones posteriores. Cuando se admite y se establece la delegación, se ignora . |
SECURITY_LOGS |
Otorga acceso a los registros de seguridad. Permite que la aplicación delegada llame a los métodos setSecurityLoggingEnabled , isSecurityLoggingEnabled , retrieveSecurityLogs y retrievePreRebootSecurityLogs . Este alcance se puede delegar a una sola aplicación como máximo. Es compatible con dispositivos completamente administrados y dispositivos empresariales con un perfil de trabajo en Android 12 y versiones posteriores. Cuando se admite y se establece la delegación, se ignora . |
CERT_SELECTION |
Otorga acceso a la selección de certificados de KeyChain en nombre de las apps solicitantes. Una vez que se otorga, la aplicación delegada comenzará a recibir DelegatedAdminReceiver#onChoosePrivateKeyAlias . Permite que la aplicación delegada llame a los métodos grantKeyPairToApp y revokeKeyPairFromApp . Este alcance se puede delegar a una sola aplicación como máximo. debe estar vacío y no tiene efecto si la selección de certificados se delega a una aplicación. |
ManagedConfigurationTemplate
Es la plantilla de configuración administrada de la app, guardada desde el iframe de configuración administrada.
Representación JSON |
---|
{ "templateId": string, "configurationVariables": { string: string, ... } } |
Campos | |
---|---|
templateId |
Es el ID de la plantilla de configuración administrada. |
configurationVariables |
Es opcional. Es un mapa que contiene variables de configuración <clave, valor> definidas para la configuración. Es un objeto que contiene una lista de pares |
ConnectedWorkAndPersonalApp
Controla si la app puede comunicarse consigo misma entre perfiles, sujeto al consentimiento del usuario.
Enumeraciones | |
---|---|
CONNECTED_WORK_AND_PERSONAL_APP_UNSPECIFIED |
Sin especificar. La configuración predeterminada es CONNECTED_WORK_AND_PERSONAL_APPS_DISALLOWED. |
CONNECTED_WORK_AND_PERSONAL_APP_DISALLOWED |
Predeterminado. Evita que la app se comunique entre perfiles. |
CONNECTED_WORK_AND_PERSONAL_APP_ALLOWED |
Permite que la app se comunique entre perfiles después de recibir el consentimiento del usuario. |
AutoUpdateMode
Controla el modo de actualización automática de la app. Si un usuario del dispositivo cambia la configuración del dispositivo de forma manual, AutoUpdateMode
ignora estas opciones, ya que tienen prioridad.
Enumeraciones | |
---|---|
AUTO_UPDATE_MODE_UNSPECIFIED |
Sin especificar. La configuración predeterminada es . |
AUTO_UPDATE_DEFAULT |
Es el modo de actualización predeterminado. La app se actualiza automáticamente con baja prioridad para minimizar el impacto en el usuario. La app se actualiza cuando se cumplen todas las siguientes restricciones:
El dispositivo recibe una notificación sobre una nueva actualización en un plazo de 24 horas después de que el desarrollador la publica. Luego, la app se actualiza la próxima vez que se cumplan las restricciones anteriores. |
AUTO_UPDATE_POSTPONED |
La app no se actualiza automáticamente durante un máximo de 90 días después de que queda desactualizada. 90 días después de que la app quede desactualizada, se instalará automáticamente la versión más reciente disponible con baja prioridad (consulta El usuario puede actualizar la app manualmente desde Play Store en cualquier momento. |
AUTO_UPDATE_HIGH_PRIORITY |
La app se actualiza lo antes posible. No se aplica ninguna restricción. El dispositivo recibe una notificación lo antes posible sobre una nueva actualización después de que esta esté disponible. NOTA: Las actualizaciones de apps con implementaciones más grandes en el ecosistema de Android pueden tardar hasta 24 horas. |
ExtensionConfig
Es la configuración para habilitar una app como app de extensión, con la capacidad de interactuar con Android Device Policy sin conexión. En Android 11 y versiones posteriores, las apps de extensión están exentas de las restricciones de batería, por lo que no se colocarán en el intervalo restringido de App Standby. Las apps de extensión también están protegidas contra el borrado de datos o el cierre forzado de la aplicación por parte de los usuarios, aunque los administradores pueden seguir usando clear app data command
en las apps de extensión si es necesario para Android 11 y versiones posteriores.
Representación JSON |
---|
{ "signingKeyFingerprintsSha256": [ string ], "notificationReceiver": string } |
Campos | |
---|---|
signingKeyFingerprintsSha256[] |
Son los hashes SHA-256 con codificación hexadecimal de los certificados de la clave de firma de la app de extensión. Solo son válidas las representaciones de cadenas hexadecimales de 64 caracteres. Las huellas digitales del certificado de la clave de firma siempre se obtienen de Play Store, y este campo se usa para proporcionar huellas digitales adicionales del certificado de la clave de firma. Sin embargo, si la aplicación no está disponible en Play Store, se debe configurar este campo. Se informa un La huella digital del certificado de la clave de firma de la app de extensión en el dispositivo debe coincidir con una de las huellas digitales del certificado de la clave de firma obtenidas de Play Store o con las que se proporcionan en este campo para que la app pueda comunicarse con Android Device Policy. En los casos de uso de producción, se recomienda dejar este campo vacío. |
notificationReceiver |
Nombre de clase completamente calificado de la clase de servicio del receptor para que Android Device Policy notifique a la app de extensión sobre las actualizaciones de estado de los comandos locales. El servicio se debe exportar en el |
AlwaysOnVpnLockdownExemption
Controla si una app está exenta del parámetro de configuración
.alwaysOnVpnPackage.lockdownEnabled
Enumeraciones | |
---|---|
ALWAYS_ON_VPN_LOCKDOWN_EXEMPTION_UNSPECIFIED |
Sin especificar. La configuración predeterminada es VPN_LOCKDOWN_ENFORCED . |
VPN_LOCKDOWN_ENFORCED |
La app respeta el parámetro de configuración de bloqueo de la VPN siempre activada. |
VPN_LOCKDOWN_EXEMPTION |
La app está exenta del parámetro de configuración de bloqueo de la VPN siempre activada. |
WorkProfileWidgets
Controla si una aplicación del perfil de trabajo puede agregar widgets a la pantalla principal.
Enumeraciones | |
---|---|
WORK_PROFILE_WIDGETS_UNSPECIFIED |
Sin especificar. La configuración predeterminada es . |
WORK_PROFILE_WIDGETS_ALLOWED |
Se permiten los widgets del perfil de trabajo. Esto significa que la aplicación podrá agregar widgets a la pantalla principal. |
WORK_PROFILE_WIDGETS_DISALLOWED |
No se permiten los widgets del perfil de trabajo. Esto significa que la aplicación no podrá agregar widgets a la pantalla principal. |
CredentialProviderPolicy
Indica si la app puede actuar como proveedor de credenciales en Android 14 y versiones posteriores.
Enumeraciones | |
---|---|
CREDENTIAL_PROVIDER_POLICY_UNSPECIFIED |
Sin especificar. El comportamiento se rige por . |
CREDENTIAL_PROVIDER_ALLOWED |
Se permite que la app actúe como proveedor de credenciales. |
CustomAppConfig
Es la configuración de una app personalizada.
Representación JSON |
---|
{
"userUninstallSettings": enum ( |
Campos | |
---|---|
userUninstallSettings |
Opcional. Es la configuración de desinstalación del usuario de la app personalizada. |
UserUninstallSettings
Especifica si un usuario puede desinstalar la app personalizada.
Enumeraciones | |
---|---|
USER_UNINSTALL_SETTINGS_UNSPECIFIED |
Sin especificar. La configuración predeterminada es . |
DISALLOW_UNINSTALL_BY_USER |
El usuario no tiene permiso para desinstalar la app personalizada. |
ALLOW_UNINSTALL_BY_USER |
El usuario puede desinstalar la app personalizada. |
InstallConstraint
Entre las apps con
establecido en lo siguiente:InstallType
Esto define un conjunto de restricciones para la instalación de la app. Se debe establecer al menos uno de los campos. Cuando se configuran varios campos, se deben satisfacer todas las restricciones para que se instale la app.
Representación JSON |
---|
{ "networkTypeConstraint": enum ( |
Campos | |
---|---|
networkTypeConstraint |
Opcional. Es una restricción de tipo de red. |
chargingConstraint |
Opcional. Es una restricción de carga. |
deviceIdleConstraint |
Opcional. Es una restricción de inactividad del dispositivo. |
NetworkTypeConstraint
Es una restricción de tipo de red.
Enumeraciones | |
---|---|
NETWORK_TYPE_CONSTRAINT_UNSPECIFIED |
Sin especificar. Margen aproximado predeterminado: INSTALL_ON_ANY_NETWORK |
INSTALL_ON_ANY_NETWORK |
Cualquier red activa (Wi-Fi, celular, etc.) |
INSTALL_ONLY_ON_UNMETERED_NETWORK |
Cualquier red no medida (p. ej., Wi-Fi) |
ChargingConstraint
Es una restricción de carga.
Enumeraciones | |
---|---|
CHARGING_CONSTRAINT_UNSPECIFIED |
Sin especificar. Margen aproximado predeterminado: CHARGING_NOT_REQUIRED |
CHARGING_NOT_REQUIRED |
El dispositivo no tiene que estar cargándose. |
INSTALL_ONLY_WHEN_CHARGING |
El dispositivo debe estar cargándose. |
DeviceIdleConstraint
Es una restricción de estado de inactividad del dispositivo.
Enumeraciones | |
---|---|
DEVICE_IDLE_CONSTRAINT_UNSPECIFIED |
Sin especificar. Margen aproximado predeterminado: DEVICE_IDLE_NOT_REQUIRED |
DEVICE_IDLE_NOT_REQUIRED |
No es necesario que el dispositivo esté inactivo. La app se puede instalar mientras el usuario interactúa con el dispositivo. |
INSTALL_ONLY_WHEN_DEVICE_IDLE |
El dispositivo debe estar inactivo. |
UserControlSettings
Especifica si se permite el control del usuario para una app determinada. El control del usuario incluye acciones como detener la app de forma forzada y borrar sus datos.
Enumeraciones | |
---|---|
USER_CONTROL_SETTINGS_UNSPECIFIED |
Usa el comportamiento predeterminado de la app para determinar si se permite o no el control del usuario. El control del usuario se permite de forma predeterminada para la mayoría de las apps, pero no para los siguientes tipos:
|
USER_CONTROL_ALLOWED |
Se permite el control del usuario para la app. Las apps de kiosco pueden usar este parámetro para permitir el control del usuario. En el caso de las apps de extensión (consulta para obtener más detalles), no se permite el control del usuario, incluso si se establece este valor. En el caso de las apps de kiosco (consulta el tipo de instalación para obtener más detalles), este valor se puede usar para permitir el control del usuario. |
USER_CONTROL_DISALLOWED |
No se permite el control del usuario para la app. Esta opción es compatible con Android 11 y versiones posteriores. Se informa un con si la versión de Android es anterior a la 11. |
PreferentialNetworkId
Es el identificador de red preferencial.
Enumeraciones | |
---|---|
PREFERENTIAL_NETWORK_ID_UNSPECIFIED |
La validez de este valor y su significado dependen de dónde se use, y esto se documenta en los campos pertinentes. |
NO_PREFERENTIAL_NETWORK |
La aplicación no usa ninguna red preferencial. |
PREFERENTIAL_NETWORK_ID_ONE |
Es el identificador de red preferencial 1. |
PREFERENTIAL_NETWORK_ID_TWO |
Es el identificador de red preferencial 2. |
PREFERENTIAL_NETWORK_ID_THREE |
Es el identificador de red preferencial 3. |
PREFERENTIAL_NETWORK_ID_FOUR |
Es el identificador de red preferencial 4. |
PREFERENTIAL_NETWORK_ID_FIVE |
Identificador de red preferencial 5. |
ApplicationSigningKeyCert
Es el certificado de la clave de firma de la aplicación.
Representación JSON |
---|
{ "signingKeyCertFingerprintSha256": string } |
Campos | |
---|---|
signingKeyCertFingerprintSha256 |
Es obligatorio. Es el valor de hash SHA-256 del certificado de la clave de firma de la app. Debe ser un valor de hash SHA-256 válido, es decir, de 32 bytes. De lo contrario, se rechaza la política. String codificada en base64. |
KeyguardDisabledFeature
Son las funciones de Keyguard (pantalla de bloqueo) que se pueden inhabilitar.
Enumeraciones | |
---|---|
KEYGUARD_DISABLED_FEATURE_UNSPECIFIED |
Este valor se ignora. |
CAMERA |
Inhabilita la cámara en las pantallas de bloqueo seguras (p.ej., PIN). |
NOTIFICATIONS |
Inhabilita la opción para mostrar todas las notificaciones en las pantallas de bloqueo seguro. |
UNREDACTED_NOTIFICATIONS |
Inhabilita las notificaciones sin editar en las pantallas de Keyguard seguras. |
TRUST_AGENTS |
Ignora el estado del agente de confianza en las pantallas de protección de teclado seguras. |
DISABLE_FINGERPRINT |
Inhabilita el sensor de huellas dactilares en las pantallas de Keyguard seguras. |
DISABLE_REMOTE_INPUT |
En los dispositivos que ejecutan Android 6 y versiones anteriores, inhabilita la entrada de texto en las notificaciones en las pantallas de protección de teclado seguras. No tiene efecto en Android 7 ni en versiones posteriores. |
FACE |
Inhabilita la autenticación facial en las pantallas de Keyguard seguras. |
IRIS |
Inhabilita la autenticación con iris en las pantallas de Keyguard seguras. |
BIOMETRICS |
Inhabilita toda la autenticación biométrica en las pantallas de bloqueo seguro. |
SHORTCUTS |
Inhabilita todos los accesos directos en la pantalla de bloqueo seguro en Android 14 y versiones posteriores. |
ALL_FEATURES |
Inhabilita todas las personalizaciones actuales y futuras del protector de teclado. |
PersistentPreferredActivity
Es una actividad predeterminada para controlar intents que coinciden con un filtro de intents en particular. Nota: Para configurar una terminal, usa InstallType en KIOSK
en lugar de usar actividades preferidas persistentes.
Representación JSON |
---|
{ "receiverActivity": string, "actions": [ string ], "categories": [ string ] } |
Campos | |
---|---|
receiverActivity |
Es la actividad que debería ser el controlador de intents predeterminado. Debe ser un nombre de componente de Android, p.ej., |
actions[] |
Son las acciones de intent que se deben coincidir en el filtro. Si se incluye alguna acción en el filtro, la acción de un intent debe ser uno de esos valores para que coincida. Si no se incluye ninguna acción, se ignora la acción del intent. |
categories[] |
Son las categorías de intents que se deben coincidir en el filtro. Un intent incluye las categorías que requiere, todas las cuales deben incluirse en el filtro para que coincidan. En otras palabras, agregar una categoría al filtro no tiene impacto en la coincidencia, a menos que esa categoría se especifique en la intención. |
SystemUpdate
Configuración para administrar las actualizaciones del sistema
Nota: Las actualizaciones del sistema de Google Play (también llamadas actualizaciones de Mainline) se descargan automáticamente, pero requieren que se reinicie el dispositivo para instalarse. Consulta la sección de mainline en Cómo administrar actualizaciones del sistema para obtener más detalles.
Representación JSON |
---|
{ "type": enum ( |
Campos | |
---|---|
type |
Es el tipo de actualización del sistema que se configurará. |
startMinutes |
Si el tipo es |
endMinutes |
Si el tipo es |
freezePeriods[] |
Es un período que se repite anualmente en el que se posponen las actualizaciones del sistema inalámbricas (OTA) para congelar la versión del SO que se ejecuta en un dispositivo. Para evitar que el dispositivo se congele de forma indefinida, cada período de congelamiento debe estar separado por al menos 60 días. |
SystemUpdateType
Es el tipo de configuración de actualización del sistema.
Enumeraciones | |
---|---|
SYSTEM_UPDATE_TYPE_UNSPECIFIED |
Sigue el comportamiento de actualización predeterminado del dispositivo, que suele requerir que el usuario acepte las actualizaciones del sistema. |
AUTOMATIC |
Se instalará automáticamente en cuanto haya una actualización disponible. |
WINDOWED |
Se instalan automáticamente dentro de un período de mantenimiento diario. Esto también configura las apps de Play para que se actualicen dentro de la ventana. Esto se recomienda especialmente para los dispositivos de kiosco, ya que es la única forma en que Play puede actualizar las apps fijadas de forma persistente en primer plano. Si |
POSTPONE |
Posponer la instalación automática hasta un máximo de 30 días Esta política no afecta las actualizaciones de seguridad (p.ej., los parches de seguridad mensuales). |
FreezePeriod
Un período de congelación del sistema Cuando el reloj de un dispositivo se encuentra dentro del período de congelación, se bloquean todas las actualizaciones del sistema entrantes (incluidos los parches de seguridad) y no se instalan.
Cuando el dispositivo está fuera de cualquier período de congelamiento establecido, se aplica el comportamiento normal de la política (automático, en ventanas o pospuesto).
Los años bisiestos se ignoran en los cálculos del período de congelación, en particular:
- Si el 29 de febrero se establece como la fecha de inicio o finalización de un período de congelación, este comenzará o finalizará el 28 de febrero.
- Cuando el reloj del sistema de un dispositivo marca el 29 de febrero, se considera como el 28 de febrero.
- Cuando se calcula la cantidad de días en un período de congelamiento o el tiempo entre dos períodos de congelamiento, se ignora el 29 de febrero y no se cuenta como un día.
Nota: Para que los períodos de congelación surtan efecto, no se puede especificar
como SystemUpdateType
, ya que los períodos de congelación requieren que se especifique una política definida.SYSTEM_UPDATE_TYPE_UNSPECIFIED
Representación JSON |
---|
{ "startDate": { object ( |
Campos | |
---|---|
startDate |
Es la fecha de inicio (inclusive) del período de congelación. Nota: Se deben establecer |
endDate |
Es la fecha de finalización (inclusive) del período de congelación. No debe ser posterior a los 90 días a partir de la fecha de inicio. Si la fecha de finalización es anterior a la fecha de inicio, se considera que el período de congelación abarca el cierre del año. Nota: Se deben establecer |
Fecha
Representa una fecha de calendario completa o parcial, como un cumpleaños. La hora del día y la zona horaria se especifican en otro lugar o son insignificantes. La fecha está relacionada con el calendario gregoriano. Puede representar una de las siguientes opciones:
- Una fecha completa con valores para el año, mes y día que no sean cero.
- Un mes y un día, con cero año (por ejemplo, un aniversario).
- Un año por sí solo, con un mes cero y un día cero.
- Es un año y un mes, con un día cero (por ejemplo, la fecha de vencimiento de una tarjeta de crédito).
Tipos relacionados:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
Representación JSON |
---|
{ "year": integer, "month": integer, "day": integer } |
Campos | |
---|---|
year |
Año de la fecha. Debe ser entre 1 y 9,999, o bien 0 para especificar una fecha sin año. |
month |
Mes del año. Debe ser del 1 al 12 o 0 para especificar un año sin un mes ni un día. |
day |
Día del mes. Debe ser entre 1 y 31 y ser válido para el año y el mes o bien 0 para especificar un año solo o un año y un mes en los que el día no sea significativo. |
StatusReportingSettings
Es la configuración que controla el comportamiento de los informes de estado.
Representación JSON |
---|
{
"applicationReportsEnabled": boolean,
"deviceSettingsEnabled": boolean,
"softwareInfoEnabled": boolean,
"memoryInfoEnabled": boolean,
"networkInfoEnabled": boolean,
"displayInfoEnabled": boolean,
"powerManagementEventsEnabled": boolean,
"hardwareStatusEnabled": boolean,
"systemPropertiesEnabled": boolean,
"applicationReportingSettings": {
object ( |
Campos | |
---|---|
applicationReportsEnabled |
Indica si los informes de la app están habilitados. |
deviceSettingsEnabled |
Indica si los informes de configuración del dispositivo están habilitados. |
softwareInfoEnabled |
Indica si los informes de información del software están habilitados. |
memoryInfoEnabled |
Indica si los informes de eventos de memoria están habilitados. |
networkInfoEnabled |
Indica si están habilitados los informes de información de la red. |
displayInfoEnabled |
Indica si están habilitados los informes de visualizaciones. Los datos de informes no están disponibles para los dispositivos personales con perfiles de trabajo. |
powerManagementEventsEnabled |
Indica si está habilitada la generación de informes de eventos de administración de energía. Los datos de informes no están disponibles para los dispositivos personales con perfiles de trabajo. |
hardwareStatusEnabled |
Indica si están habilitados los informes de estado del hardware. Los datos de informes no están disponibles para los dispositivos personales con perfiles de trabajo. |
systemPropertiesEnabled |
Indica si los informes de propiedades del sistema están habilitados. |
applicationReportingSettings |
Es la configuración de informes de la aplicación. Solo se aplica si applicationReportsEnabled es verdadero. |
commonCriteriaModeEnabled |
Indica si los informes de |
ApplicationReportingSettings
Es la configuración que controla el comportamiento de los informes de la aplicación.
Representación JSON |
---|
{ "includeRemovedApps": boolean } |
Campos | |
---|---|
includeRemovedApps |
Indica si las apps quitadas se incluyen en los informes de la aplicación. |
PackageNameList
Es una lista de nombres de paquetes.
Representación JSON |
---|
{ "packageNames": [ string ] } |
Campos | |
---|---|
packageNames[] |
Es una lista de nombres de paquetes. |
BatteryPluggedMode
Modos para enchufar la batería.
Enumeraciones | |
---|---|
BATTERY_PLUGGED_MODE_UNSPECIFIED |
Este valor se ignora. |
AC |
La fuente de alimentación es un cargador de CA. |
USB |
La fuente de alimentación es un puerto USB. |
WIRELESS |
La fuente de alimentación es inalámbrica. |
ProxyInfo
Es la información de configuración de un proxy HTTP. Para un proxy directo, configura los campos host
, port
y excludedHosts
. Para un proxy de secuencia de comandos PAC, establece el campo pacUri
.
Representación JSON |
---|
{ "host": string, "port": integer, "excludedHosts": [ string ], "pacUri": string } |
Campos | |
---|---|
host |
Es el host del proxy directo. |
port |
Es el puerto del proxy directo. |
excludedHosts[] |
Para un proxy directo, son los hosts para los que se omite el proxy. Los nombres de host pueden contener comodines, como *.example.com. |
pacUri |
Es el URI de la secuencia de comandos de PAC que se usa para configurar el proxy. |
ChoosePrivateKeyRule
Controla el acceso de las apps a las claves privadas. La regla determina a qué clave privada, si la hay, otorga acceso Android Device Policy a la app especificada. El acceso se otorga cuando la app llama a KeyChain.choosePrivateKeyAlias
(o a cualquier sobrecarga) para solicitar un alias de clave privada para una URL determinada, o bien, para las reglas que no son específicas de la URL (es decir, si urlPattern
no está configurado o está configurado como la cadena vacía o .*
) en Android 11 y versiones posteriores, directamente para que la app pueda llamar a KeyChain.getPrivateKey
, sin tener que llamar primero a KeyChain.choosePrivateKeyAlias
.
Cuando una app llama a KeyChain.choosePrivateKeyAlias
si coincide más de un
, la última regla coincidente define qué alias de clave se debe devolver.choosePrivateKeyRules
Representación JSON |
---|
{ "urlPattern": string, "packageNames": [ string ], "privateKeyAlias": string } |
Campos | |
---|---|
urlPattern |
Es el patrón de URL con el que se comparará la URL de la solicitud. Si no se establece o está vacío, coincide con todas las URLs. Esto usa la sintaxis de expresión regular de |
packageNames[] |
Son los nombres de los paquetes a los que se aplica esta regla. La huella digital del certificado de la clave de firma de la app se verifica con las huellas digitales del certificado de la clave de firma que proporcionan Play Store y |
privateKeyAlias |
Es el alias de la clave privada que se usará. |
AlwaysOnVpnPackage
Es la configuración de una conexión VPN siempre activada.
Representación JSON |
---|
{ "packageName": string, "lockdownEnabled": boolean } |
Campos | |
---|---|
packageName |
Es el nombre del paquete de la app de VPN. |
lockdownEnabled |
No permite la conexión a redes cuando la VPN no está conectada. |
LocationMode
Es el grado de detección de ubicación habilitado en los perfiles de trabajo y los dispositivos completamente administrados.
Enumeraciones | |
---|---|
LOCATION_MODE_UNSPECIFIED |
La configuración predeterminada es LOCATION_USER_CHOICE . |
HIGH_ACCURACY |
En Android 8 y versiones anteriores, se habilitan todos los métodos de detección de ubicación, incluidos el GPS, las redes y otros sensores. En Android 9 y versiones posteriores, esto equivale a |
SENSORS_ONLY |
En Android 8 y versiones anteriores, solo se habilitan el GPS y otros sensores. En Android 9 y versiones posteriores, esto equivale a |
BATTERY_SAVING |
En Android 8 y versiones anteriores, solo se habilita el proveedor de ubicación de red. En Android 9 y versiones posteriores, esto equivale a |
OFF |
En Android 8 y versiones anteriores, la configuración y la precisión de la ubicación están inhabilitadas. En Android 9 y versiones posteriores, esto equivale a |
LOCATION_USER_CHOICE |
El parámetro de configuración de ubicación no está restringido en el dispositivo. No se establece ni se aplica ningún comportamiento específico. |
LOCATION_ENFORCED |
Habilita la configuración de ubicación en el dispositivo. |
LOCATION_DISABLED |
Inhabilita el parámetro de configuración de ubicación en el dispositivo. |
ComplianceRule
Es una regla que declara qué acciones de mitigación se deben tomar cuando un dispositivo no cumple con su política. Para cada regla, siempre hay una acción de mitigación implícita para establecer policyCompliant
como falso para el recurso Device
y mostrar un mensaje en el dispositivo que indique que no cumple con su política. También se pueden tomar otras medidas de mitigación de forma opcional, según los valores de los campos de la regla.
Representación JSON |
---|
{ "disableApps": boolean, "packageNamesToDisable": [ string ], // Union field |
Campos | |
---|---|
disableApps |
Si se establece como verdadero, la regla incluye una acción de mitigación para inhabilitar apps, de modo que el dispositivo se inhabilite de manera efectiva, pero se conserven los datos de las apps. Si el dispositivo ejecuta una app en el modo de tarea bloqueada, se cerrará la app y se mostrará una IU con el motivo del incumplimiento. |
packageNamesToDisable[] |
Si se configura, la regla incluye una acción de mitigación para inhabilitar las apps especificadas en la lista, pero se conservan los datos de las apps. |
Campo de unión condition . Es la condición que, cuando se cumple, activa las acciones de mitigación definidas en la regla. Se debe establecer exactamente una de las condiciones. Las direcciones (condition ) solo pueden ser una de las siguientes opciones: |
|
nonComplianceDetailCondition |
Es una condición que se cumple si existe algún |
apiLevelCondition |
Condición que se cumple si el nivel de API del framework de Android en el dispositivo no cumple con un requisito mínimo. |
NonComplianceDetailCondition
Es una condición de regla de cumplimiento que se satisface si existe algún NonComplianceDetail
coincidente para el dispositivo. Un NonComplianceDetail
coincide con un NonComplianceDetailCondition
si todos los campos establecidos dentro del NonComplianceDetailCondition
coinciden con los campos NonComplianceDetail
correspondientes.
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. Si no se configura, esta condición coincide con cualquier motivo. |
packageName |
Es el nombre del paquete de la app que no cumple con las políticas. Si no se configura, esta condición coincidirá con cualquier nombre de paquete. |
ApiLevelCondition
Es una condición de regla de cumplimiento que se satisface si el nivel de API de Android Framework en el dispositivo no cumple con un requisito mínimo. Solo puede haber una regla con este tipo de condición por política.
Representación JSON |
---|
{ "minApiLevel": integer } |
Campos | |
---|---|
minApiLevel |
Es el nivel de API de Android Framework mínimo deseado. Si el dispositivo no cumple con el requisito mínimo, se cumple esta condición. Debe ser mayor que cero. |
AppAutoUpdatePolicy
Alternativa recomendada:
, que se configura por app y proporciona mayor flexibilidad en cuanto a la frecuencia de actualización.autoUpdateMode
Cuando
se establece en autoUpdateMode
o AUTO_UPDATE_POSTPONED
, este campo no tiene efecto.AUTO_UPDATE_HIGH_PRIORITY
Es la política de actualización automática de la app, que controla cuándo se pueden aplicar las actualizaciones automáticas de la app.
Enumeraciones | |
---|---|
APP_AUTO_UPDATE_POLICY_UNSPECIFIED |
No se estableció la política de actualización automática. Equivale a CHOICE_TO_THE_USER . |
CHOICE_TO_THE_USER |
El usuario puede controlar las actualizaciones automáticas. |
NEVER |
Las apps nunca se actualizan automáticamente. |
WIFI_ONLY |
Las apps se actualizan automáticamente solo a través de Wi-Fi. |
ALWAYS |
Las apps se actualizan automáticamente en cualquier momento. Es posible que se apliquen cargos por el uso de datos. |
AppTrack
Es un segmento de versión de una app de Google Play.
Enumeraciones | |
---|---|
APP_TRACK_UNSPECIFIED |
Este valor se ignora. |
PRODUCTION |
El segmento de producción, que proporciona la versión estable más reciente |
BETA |
La pista beta, que proporciona la versión beta más reciente |
EncryptionPolicy
Tipo de encriptación
Enumeraciones | |
---|---|
ENCRYPTION_POLICY_UNSPECIFIED |
Se ignora este valor, es decir, no se requiere encriptación. |
ENABLED_WITHOUT_PASSWORD |
Se requiere encriptación, pero no se necesita contraseña para iniciar el dispositivo |
ENABLED_WITH_PASSWORD |
Se requiere encriptación y contraseña para iniciar el dispositivo |
PlayStoreMode
Son los valores posibles para la política de modo de Play Store.
Enumeraciones | |
---|---|
PLAY_STORE_MODE_UNSPECIFIED |
Sin especificar. El valor predeterminado es WHITELIST. |
WHITELIST |
Solo están disponibles las apps que se incluyen en la política, y las que no se incluyan se desinstalarán automáticamente del dispositivo. |
BLACKLIST |
Todas las apps están disponibles y cualquier app que no debería estar en el dispositivo debe marcarse explícitamente como "BLOQUEADA" en la política de applications . |
SetupAction
Es una acción que se ejecutó durante la configuración.
Representación JSON |
---|
{ "title": { object ( |
Campos | |
---|---|
title |
Es el título de esta acción. |
description |
Descripción de esta acción. |
Campo de unión action . Es la acción que se ejecutará durante la configuración. Las direcciones (action ) solo pueden ser una de las siguientes opciones: |
|
launchApp |
Es una acción para iniciar una app. La app se iniciará con un intent que contiene un elemento adicional con la clave |
LaunchAppAction
Es una acción para iniciar una app.
Representación JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de unión launch . La descripción de la acción de lanzamiento que se ejecutará. launch solo puede ser una de las siguientes opciones: |
|
packageName |
Nombre del paquete de la app que se iniciará |
PolicyEnforcementRule
Es una regla que define las acciones que se deben realizar si un dispositivo o un perfil de trabajo no cumplen con la política especificada en settingName
. En el caso de varios incumplimientos o varias reglas de aplicación de la ley activadas, se realizará una combinación y se tomará la acción más grave. Sin embargo, se sigue realizando un seguimiento de todas las reglas activadas, lo que incluye la hora de activación inicial y todos los detalles de incumplimiento asociados. En la situación en la que se cumple la regla de aplicación más grave, se aplica la siguiente acción más adecuada.
Representación JSON |
---|
{ "blockAction": { object ( |
Campos | |
---|---|
blockAction |
Es una acción para bloquear el acceso a apps y datos en un dispositivo propiedad de la empresa o en un perfil de trabajo. Esta acción también activa una notificación para el usuario con información (cuando es posible) sobre cómo corregir el problema de cumplimiento. Nota: También se debe especificar |
wipeAction |
Es una acción para restablecer un dispositivo de la empresa o borrar un perfil de trabajo. Nota: También se debe especificar |
Campo de unión trigger . Es la condición que activará esta regla. Las direcciones (trigger ) solo pueden ser una de las siguientes opciones: |
|
settingName |
Es la política de nivel superior que se aplicará. Por ejemplo, |
BlockAction
Es una acción para bloquear el acceso a las apps y los datos en un dispositivo completamente administrado o en un perfil de trabajo. Esta acción también activa un dispositivo o perfil de trabajo para que muestre una notificación al usuario con información (cuando sea posible) sobre cómo corregir el problema de cumplimiento. Nota: También se debe especificar wipeAction
.
Representación JSON |
---|
{
"blockAfterDays": integer,
"blockScope": enum ( |
Campos | |
---|---|
blockAfterDays |
Cantidad de días en los que la política no cumple con los requisitos antes de que se bloquee el dispositivo o el perfil de trabajo. Para bloquear el acceso de inmediato, establece el valor en 0. |
blockScope |
Especifica el alcance de este |
BlockScope
Especifica el alcance de BlockAction
. Solo se aplica a los dispositivos que son propiedad de la empresa.
Enumeraciones | |
---|---|
BLOCK_SCOPE_UNSPECIFIED |
Sin especificar. La configuración predeterminada es BLOCK_SCOPE_WORK_PROFILE . |
BLOCK_SCOPE_WORK_PROFILE |
La acción de bloqueo solo se aplica a las apps del perfil de trabajo. Las apps del perfil personal no se verán afectadas. |
BLOCK_SCOPE_DEVICE |
La acción de bloqueo se aplica a todo el dispositivo, incluidas las apps del perfil personal. |
WipeAction
Es una acción para restablecer un dispositivo de la empresa o borrar un perfil de trabajo. Nota: También se debe especificar blockAction
.
Representación JSON |
---|
{ "wipeAfterDays": integer, "preserveFrp": boolean } |
Campos | |
---|---|
wipeAfterDays |
Cantidad de días en los que la política no cumple con los requisitos antes de que se borre el dispositivo o el perfil de trabajo. |
preserveFrp |
Indica si se conservan los datos de protección contra el restablecimiento de la configuración de fábrica en el dispositivo. Este parámetro de configuración no se aplica a los perfiles de trabajo. |
KioskCustomization
Es la configuración que controla el comportamiento de un dispositivo en modo kiosco. Para habilitar el modo kiosco, establece kioskCustomLauncherEnabled
en true
o especifica una app en la política con installType
KIOSK
.
Representación JSON |
---|
{ "powerButtonActions": enum ( |
Campos | |
---|---|
powerButtonActions |
Establece el comportamiento de un dispositivo en modo de kiosco cuando un usuario mantiene presionado el botón de encendido. |
systemErrorWarnings |
Especifica si se bloquean los diálogos de error del sistema para las apps que fallaron o no responden en el modo de kiosco. Cuando se bloquea, el sistema detendrá la app de forma forzada como si el usuario eligiera la opción "Cerrar app" en la IU. |
systemNavigation |
Especifica qué funciones de navegación están habilitadas (p.ej., los botones de inicio y de vista general) en el modo de kiosco. |
statusBar |
Especifica si la información y las notificaciones del sistema están inhabilitadas en el modo kiosco. |
deviceSettings |
Especifica si se permite la app de Configuración en el modo de kiosco. |
PowerButtonActions
Establece el comportamiento de un dispositivo en modo de kiosco cuando un usuario mantiene presionado el botón de encendido.
Enumeraciones | |
---|---|
POWER_BUTTON_ACTIONS_UNSPECIFIED |
Si no se especifica, el valor predeterminado es POWER_BUTTON_AVAILABLE . |
POWER_BUTTON_AVAILABLE |
El menú de encendido (p.ej., Apagar, Reiniciar) se muestra cuando un usuario mantiene presionado el botón de encendido de un dispositivo en modo de kiosco. |
POWER_BUTTON_BLOCKED |
El menú de encendido (p.ej., Apagar, Reiniciar) no se muestra cuando un usuario mantiene presionado el botón de encendido de un dispositivo en modo kiosco. Nota: Esto puede impedir que los usuarios apaguen el dispositivo. |
SystemErrorWarnings
Especifica si se bloquean los diálogos de error del sistema para las apps que fallaron o no responden en el modo de kiosco.
Enumeraciones | |
---|---|
SYSTEM_ERROR_WARNINGS_UNSPECIFIED |
Si no se especifica, el valor predeterminado es ERROR_AND_WARNINGS_MUTED . |
ERROR_AND_WARNINGS_ENABLED |
Se muestran todos los diálogos de error del sistema, como los de fallas y los de aplicaciones que no responden (ANR). |
ERROR_AND_WARNINGS_MUTED |
Se bloquean todos los diálogos de error del sistema, como los de fallas y los de aplicaciones que no responden (ANR). Cuando se bloquea, el sistema fuerza la detención de la app como si el usuario la cerrara desde la IU. |
StatusBar
Especifica si la información y las notificaciones del sistema están inhabilitadas en el modo kiosco.
Enumeraciones | |
---|---|
STATUS_BAR_UNSPECIFIED |
Si no se especifica, el valor predeterminado es INFO_AND_NOTIFICATIONS_DISABLED . |
NOTIFICATIONS_AND_SYSTEM_INFO_ENABLED |
La información del sistema y las notificaciones se muestran en la barra de estado en el modo kiosco. Nota: Para que esta política entre en vigencia, se debe habilitar el botón de inicio del dispositivo con |
NOTIFICATIONS_AND_SYSTEM_INFO_DISABLED |
La información del sistema y las notificaciones están inhabilitadas en el modo de kiosco. |
SYSTEM_INFO_ONLY |
En la barra de estado, solo se muestra la información del sistema. |
DeviceSettings
Especifica si un usuario puede acceder a la app de Configuración del dispositivo mientras está en modo kiosco.
Enumeraciones | |
---|---|
DEVICE_SETTINGS_UNSPECIFIED |
Si no se especifica, el valor predeterminado es SETTINGS_ACCESS_ALLOWED . |
SETTINGS_ACCESS_ALLOWED |
Se permite el acceso a la app de Configuración en el modo kiosco. |
SETTINGS_ACCESS_BLOCKED |
No se permite el acceso a la app de Configuración en el modo kiosco. |
AdvancedSecurityOverrides
Parámetros de configuración de seguridad avanzados En la mayoría de los casos, no es necesario configurar estos parámetros.
Representación JSON |
---|
{ "untrustedAppsPolicy": enum ( |
Campos | |
---|---|
untrustedAppsPolicy |
Es la política para las apps no confiables (apps de fuentes desconocidas) que se aplica en el dispositivo. Reemplaza a |
googlePlayProtectVerifyApps |
Indica si se aplica la verificación de Google Play Protect. Reemplaza |
developerSettings |
Controla el acceso a la configuración para desarrolladores: opciones para desarrolladores y arranque seguro. Reemplaza |
commonCriteriaMode |
Controles del modo Common Criteria: Estándares de seguridad definidos en los Common Criteria for Information Technology Security Evaluation (CC). Habilitar el modo Common Criteria aumenta ciertos componentes de seguridad en un dispositivo. Consulta Advertencia: El modo de Common Criteria aplica un modelo de seguridad estricto que, por lo general, solo se requiere para los productos de TI que se usan en sistemas de seguridad nacional y otras organizaciones altamente sensibles. Es posible que se vea afectado el uso estándar del dispositivo. Solo se habilita si es necesario. Si se desactiva el modo de criterios comunes después de haberlo habilitado, es posible que se pierdan todas las redes Wi-Fi configuradas por el usuario y que deban volver a configurarse las redes Wi-Fi configuradas por la empresa que requieran la entrada del usuario. |
personalAppsThatCanReadWorkNotifications[] |
Apps personales que pueden leer notificaciones del perfil de trabajo con un NotificationListenerService De forma predeterminada, ninguna app personal (aparte de las apps del sistema) puede leer las notificaciones de trabajo. Cada valor de la lista debe ser un nombre de paquete. |
mtePolicy |
Opcional. Controla la extensión de etiquetado de memoria (MTE) en el dispositivo. Se debe reiniciar el dispositivo para aplicar los cambios a la política de MTE. |
contentProtectionPolicy |
Opcional. Controla si está habilitada la protección de contenido, que analiza las apps engañosas. Esta función es compatible con Android 15 y versiones posteriores. |
UntrustedAppsPolicy
Es la política para las apps no confiables (apps de fuentes desconocidas) que se aplica en el dispositivo. Reemplaza a installUnknownSourcesAllowed (deprecated).
Enumeraciones | |
---|---|
UNTRUSTED_APPS_POLICY_UNSPECIFIED |
Sin especificar. El valor predeterminado es DISALLOW_INSTALL. |
DISALLOW_INSTALL |
Predeterminado. No permite la instalación de apps no confiables en todo el dispositivo. |
ALLOW_INSTALL_IN_PERSONAL_PROFILE_ONLY |
En el caso de los dispositivos con perfiles de trabajo, permite la instalación de apps no confiables solo en el perfil personal del dispositivo. |
ALLOW_INSTALL_DEVICE_WIDE |
Permite la instalación de apps no confiables en todo el dispositivo. |
GooglePlayProtectVerifyApps
Indica si se aplica la verificación de Google Play Protect. Reemplaza
(obsoleto).ensureVerifyAppsEnabled
Enumeraciones | |
---|---|
GOOGLE_PLAY_PROTECT_VERIFY_APPS_UNSPECIFIED |
Sin especificar. La configuración predeterminada es VERIFY_APPS_ENFORCED. |
VERIFY_APPS_ENFORCED |
Predeterminado. Habilita la verificación de la app de forma forzada. |
VERIFY_APPS_USER_CHOICE |
Permite que el usuario elija si habilita la verificación de apps. |
DeveloperSettings
Controla el acceso a la configuración para desarrolladores: opciones para desarrolladores y arranque seguro. Reemplaza
(obsoleto) y safeBootDisabled
(obsoleto).debuggingFeaturesAllowed
Enumeraciones | |
---|---|
DEVELOPER_SETTINGS_UNSPECIFIED |
Sin especificar. El valor predeterminado es DEVELOPER_SETTINGS_DISABLED. |
DEVELOPER_SETTINGS_DISABLED |
Predeterminado. Inhabilita todos los parámetros de configuración para desarrolladores y evita que el usuario acceda a ellos. |
DEVELOPER_SETTINGS_ALLOWED |
Permite todos los parámetros de configuración para desarrolladores. El usuario puede acceder a la configuración y, de manera opcional, establecerla. |
CommonCriteriaMode
Controles del modo Common Criteria: Estándares de seguridad definidos en los Common Criteria for Information Technology Security Evaluation (CC). Habilitar el modo Common Criteria aumenta ciertos componentes de seguridad en un dispositivo, incluidos los siguientes:
- Encriptación AES-GCM de las claves a largo plazo de Bluetooth
- Almacenes de configuración de Wi-Fi
- Validación adicional de certificados de red que requiere el uso de TLSv1.2 para conectarse a los hosts de destino de la API de AM
- Verificación de la integridad de la política criptográfica. Se recomienda establecer
como verdadero para obtener el estado de la verificación de integridad de la política. Si falla la verificación de la firma de la política, esta no se aplicará en el dispositivo ystatusReportingSettings.commonCriteriaModeEnabled
se establecerá encommonCriteriaModeInfo.policy_signature_verification_status
.POLICY_SIGNATURE_VERIFICATION_FAILED
El modo Common Criteria solo se admite en dispositivos empresariales con Android 11 o versiones posteriores.
Advertencia: El modo de Common Criteria aplica un modelo de seguridad estricto que, por lo general, solo se requiere para los productos de TI que se usan en sistemas de seguridad nacional y otras organizaciones altamente sensibles. Es posible que se vea afectado el uso estándar del dispositivo. Solo se habilita si es necesario. Si se desactiva el modo de criterios comunes después de haberlo habilitado, es posible que se pierdan todas las redes Wi-Fi configuradas por el usuario y que deban volver a configurarse las redes Wi-Fi configuradas por la empresa que requieran la entrada del usuario.
Enumeraciones | |
---|---|
COMMON_CRITERIA_MODE_UNSPECIFIED |
Sin especificar. La configuración predeterminada es COMMON_CRITERIA_MODE_DISABLED. |
COMMON_CRITERIA_MODE_DISABLED |
Predeterminado. Inhabilita el modo Common Criteria. |
COMMON_CRITERIA_MODE_ENABLED |
Habilita el modo Common Criteria. |
MtePolicy
Controla la extensión de etiquetado de memoria (MTE) en el dispositivo.
Enumeraciones | |
---|---|
MTE_POLICY_UNSPECIFIED |
Sin especificar. La configuración predeterminada es . |
MTE_USER_CHOICE |
El usuario puede habilitar o inhabilitar el MTE en el dispositivo si este lo admite. |
MTE_ENFORCED |
El MTE está habilitado en el dispositivo, y el usuario no puede cambiar este parámetro de configuración. Este parámetro se puede configurar en dispositivos completamente administrados y perfiles de trabajo en dispositivos de la empresa. Se informa un Compatible con Android 14 y versiones posteriores. Se informa un |
MTE_DISABLED |
El MTE está inhabilitado en el dispositivo, y el usuario no puede cambiar este parámetro de configuración. Esto solo se aplica a los dispositivos completamente administrados. En otros casos, se informa un Compatible con Android 14 y versiones posteriores. Se informa un |
ContentProtectionPolicy
Controla si está habilitada la protección de contenido, que analiza las apps engañosas. Esta función es compatible con Android 15 y versiones posteriores.
Enumeraciones | |
---|---|
CONTENT_PROTECTION_POLICY_UNSPECIFIED |
Sin especificar. La configuración predeterminada es . |
CONTENT_PROTECTION_DISABLED |
La protección de contenido está inhabilitada y el usuario no puede cambiar esto. |
CONTENT_PROTECTION_ENFORCED |
La protección de contenido está habilitada y el usuario no puede cambiarla. Compatible con Android 15 y versiones posteriores. Se informa un |
CONTENT_PROTECTION_USER_CHOICE |
La política no controla la protección de contenido. El usuario puede elegir el comportamiento de la protección de contenido. Compatible con Android 15 y versiones posteriores. Se informa un |
PersonalUsagePolicies
Son políticas que controlan el uso personal en un dispositivo de la empresa con un perfil de trabajo.
Representación JSON |
---|
{ "cameraDisabled": boolean, "screenCaptureDisabled": boolean, "accountTypesWithManagementDisabled": [ string ], "maxDaysWithWorkOff": integer, "personalPlayStoreMode": enum ( |
Campos | |
---|---|
cameraDisabled |
Si es verdadero, la cámara está inhabilitada en el perfil personal. |
screenCaptureDisabled |
Si es verdadero, se inhabilita la captura de pantalla para todos los usuarios. |
accountTypesWithManagementDisabled[] |
Son los tipos de cuentas que el usuario no puede administrar. |
maxDaysWithWorkOff |
Controla cuánto tiempo puede permanecer desactivado el perfil de trabajo. La duración mínima debe ser de al menos 3 días. Estos son otros detalles:
|
personalPlayStoreMode |
Se usa junto con |
personalApplications[] |
Política aplicada a las aplicaciones en el perfil personal. |
privateSpacePolicy |
Opcional. Controla si se permite un espacio privado en el dispositivo. |
bluetoothSharing |
Opcional. Indica si se permite el uso compartido por Bluetooth. |
PlayStoreMode
Se usa junto con personalApplications
para controlar cómo se permiten o bloquean las apps en el perfil personal.
Enumeraciones | |
---|---|
PLAY_STORE_MODE_UNSPECIFIED |
Sin especificar. La configuración predeterminada es BLOCKLIST . |
BLACKLIST |
Todas las apps de Play Store están disponibles para instalarse en el perfil personal, excepto aquellas cuyo |
BLOCKLIST |
Todas las apps de Play Store están disponibles para instalarse en el perfil personal, excepto aquellas cuyo installType es BLOCKED en personalApplications . |
ALLOWLIST |
Solo se permite instalar en el perfil personal las apps especificadas de forma explícita en personalApplications con installType establecido en AVAILABLE . |
PersonalApplicationPolicy
Políticas para las apps en el perfil personal de un dispositivo empresarial con un perfil de trabajo.
Representación JSON |
---|
{
"packageName": string,
"installType": enum ( |
Campos | |
---|---|
packageName |
Es el nombre del paquete de la aplicación. |
installType |
Es el tipo de instalación que se realizará. |
InstallType
Son los tipos de comportamientos de instalación que puede tener una aplicación de perfil personal.
Enumeraciones | |
---|---|
INSTALL_TYPE_UNSPECIFIED |
Sin especificar. La configuración predeterminada es AVAILABLE . |
BLOCKED |
La app está bloqueada y no se puede instalar en el perfil personal. Si la app se había instalado previamente en el dispositivo, se desinstalará. |
AVAILABLE |
La app está disponible para instalarse en el perfil personal. |
PrivateSpacePolicy
Controla si se permite un espacio privado en el dispositivo.
Enumeraciones | |
---|---|
PRIVATE_SPACE_POLICY_UNSPECIFIED |
Sin especificar. La configuración predeterminada es . |
PRIVATE_SPACE_ALLOWED |
Los usuarios pueden crear un perfil de espacio privado. |
PRIVATE_SPACE_DISALLOWED |
Los usuarios no pueden crear un perfil de espacio privado. Solo se admite en dispositivos empresariales con un perfil de trabajo. Precaución: Se quitará cualquier espacio privado existente. |
BluetoothSharing
Indica si se permite el uso compartido por Bluetooth en el perfil personal de un dispositivo propiedad de la empresa que tiene un perfil de trabajo.
Enumeraciones | |
---|---|
BLUETOOTH_SHARING_UNSPECIFIED |
Sin especificar. La configuración predeterminada es BLUETOOTH_SHARING_ALLOWED . |
BLUETOOTH_SHARING_ALLOWED |
Se permite el uso compartido por Bluetooth en el perfil personal. Compatible con Android 8 y versiones posteriores. Se informa un |
BLUETOOTH_SHARING_DISALLOWED |
No se permite el uso compartido por Bluetooth en el perfil personal. Compatible con Android 8 y versiones posteriores. Se informa un |
AutoDateAndTimeZone
Indica si la fecha, la hora y la zona horaria automáticas están habilitadas en un dispositivo propiedad de la empresa.
Enumeraciones | |
---|---|
AUTO_DATE_AND_TIME_ZONE_UNSPECIFIED |
Sin especificar. La configuración predeterminada es AUTO_DATE_AND_TIME_ZONE_USER_CHOICE . |
AUTO_DATE_AND_TIME_ZONE_USER_CHOICE |
La fecha, la hora y la zona horaria automáticas se dejan a elección del usuario. |
AUTO_DATE_AND_TIME_ZONE_ENFORCED |
Aplicar la fecha, la hora y la zona horaria automáticas en el dispositivo |
OncCertificateProvider
Esta función no está disponible de forma general.
Representación JSON |
---|
{ "certificateReferences": [ string ], // Union field |
Campos | |
---|---|
certificateReferences[] |
Esta función no está disponible de forma general. |
Campo de unión Esta función no está disponible de forma general. |
|
contentProviderEndpoint |
Esta función no está disponible de forma general. |
ContentProviderEndpoint
Esta función no está disponible de forma general.
Representación JSON |
---|
{ "uri": string, "packageName": string, "signingCertsSha256": [ string ] } |
Campos | |
---|---|
uri |
Esta función no está disponible de forma general. |
packageName |
Esta función no está disponible de forma general. |
signingCertsSha256[] |
Es obligatorio. Esta función no está disponible de forma general. |
CrossProfilePolicies
Controla los datos del perfil de trabajo a los que se puede acceder desde el perfil personal y viceversa. Se informa un
con NonComplianceDetail
si el dispositivo no tiene un perfil de trabajo.MANAGEMENT_MODE
Representación JSON |
---|
{ "showWorkContactsInPersonalProfile": enum ( |
Campos | |
---|---|
showWorkContactsInPersonalProfile |
Indica si las apps personales pueden acceder a los contactos almacenados en el perfil de trabajo. Consulta también |
crossProfileCopyPaste |
Indica si el texto copiado de un perfil (personal o de trabajo) se puede pegar en el otro. |
crossProfileDataSharing |
Indica si los datos de un perfil (personal o de trabajo) se pueden compartir con las apps del otro perfil. Controla específicamente el uso compartido de datos simples a través de intents. La administración de otros canales de comunicación entre perfiles, como la búsqueda de contactos, la función de copiar y pegar, o las apps personales y de trabajo conectadas, se configura por separado. |
workProfileWidgetsDefault |
Especifica el comportamiento predeterminado de los widgets del perfil de trabajo. Si la política no especifica |
crossProfileAppFunctions |
Opcional. Controla si las apps del perfil personal pueden invocar funciones de apps expuestas por apps en el perfil de trabajo. |
exemptionsToShowWorkContactsInPersonalProfile |
Es la lista de apps que se excluyen del parámetro de configuración
Compatible con Android 14 y versiones posteriores. Se informa un |
ShowWorkContactsInPersonalProfile
Si las apps personales pueden acceder a los contactos del perfil de trabajo, incluidas las búsquedas de contactos y las llamadas entrantes
Nota: Una vez que una app personal accede a un contacto laboral, no se puede garantizar que permanezca en la misma app, ya que el contacto se puede compartir o transferir a cualquier otra app, según el comportamiento de la app permitida.
Enumeraciones | |
---|---|
SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_UNSPECIFIED |
Sin especificar. La configuración predeterminada es Cuando se establece este parámetro, no se debe establecer |
SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED |
Impide que las apps personales accedan a los contactos del perfil de trabajo y los busquen. Cuando se establece este parámetro, las apps personales especificadas en Compatible con Android 7.0 y versiones posteriores. Se informa un |
SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_ALLOWED |
Predeterminado. Permite que las apps del perfil personal accedan a los contactos del perfil de trabajo, incluidas las búsquedas de contactos y las llamadas entrantes. Cuando se establece este parámetro, las apps personales especificadas en Compatible con Android 7.0 y versiones posteriores. Se informa un |
SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED_EXCEPT_SYSTEM |
Impide que la mayoría de las apps personales accedan a los contactos del perfil de trabajo, incluidas las búsquedas de contactos y las llamadas entrantes, excepto las apps predeterminadas de Teléfono, Mensajes y Contactos del OEM. Ni las apps de Teléfono, Mensajes y Contactos configuradas por el usuario, ni ninguna otra app instalada del sistema o de Play podrán consultar los contactos del trabajo directamente. Cuando se establece este parámetro, las apps personales especificadas en Compatible con Android 14 y versiones posteriores. Si se configura en un dispositivo con una versión de Android anterior a la 14, el comportamiento recurre a |
CrossProfileCopyPaste
Indica si el texto copiado de un perfil (personal o de trabajo) se puede pegar en el otro.
Enumeraciones | |
---|---|
CROSS_PROFILE_COPY_PASTE_UNSPECIFIED |
Sin especificar. El valor predeterminado es COPY_FROM_WORK_TO_PERSONAL_DISALLOWED. |
COPY_FROM_WORK_TO_PERSONAL_DISALLOWED |
Predeterminado. Impide que los usuarios peguen en el perfil personal el texto copiado del perfil de trabajo. El texto copiado del perfil personal se puede pegar en el perfil de trabajo, y el texto copiado del perfil de trabajo se puede pegar en el perfil de trabajo. |
CROSS_PROFILE_COPY_PASTE_ALLOWED |
El texto copiado en un perfil se puede pegar en el otro. |
CrossProfileDataSharing
Indica si los datos de un perfil (personal o de trabajo) se pueden compartir con las apps del otro perfil. Controla específicamente el uso compartido de datos simples a través de intents. Esto incluye acciones como abrir un navegador web, abrir un mapa, compartir contenido, abrir un documento, etcétera. La administración de otros canales de comunicación entre perfiles, como la búsqueda de contactos, la función de copiar y pegar, o las apps personales y de trabajo conectadas, se configura por separado.
Enumeraciones | |
---|---|
CROSS_PROFILE_DATA_SHARING_UNSPECIFIED |
Sin especificar. El valor predeterminado es DATA_SHARING_FROM_WORK_TO_PERSONAL_DISALLOWED. |
CROSS_PROFILE_DATA_SHARING_DISALLOWED |
Evita que se compartan datos del perfil personal al perfil de trabajo y viceversa. |
DATA_SHARING_FROM_WORK_TO_PERSONAL_DISALLOWED |
Predeterminado. Impide que los usuarios compartan datos del perfil de trabajo con apps del perfil personal. Los datos personales se pueden compartir con las apps de trabajo. |
CROSS_PROFILE_DATA_SHARING_ALLOWED |
Los datos de cualquiera de los perfiles se pueden compartir con el otro. |
WorkProfileWidgetsDefault
Controla si las aplicaciones del perfil de trabajo pueden agregar widgets a la pantalla principal cuando no se define una política específica de la app. De lo contrario, la política específica de la app tendrá prioridad sobre esta.
Enumeraciones | |
---|---|
WORK_PROFILE_WIDGETS_DEFAULT_UNSPECIFIED |
Sin especificar. La configuración predeterminada es WORK_PROFILE_WIDGETS_DEFAULT_DISALLOWED. |
WORK_PROFILE_WIDGETS_DEFAULT_ALLOWED |
Los widgets del perfil de trabajo se permiten de forma predeterminada. Esto significa que, si la política no especifica como para la aplicación, esta podrá agregar widgets a la pantalla principal. |
WORK_PROFILE_WIDGETS_DEFAULT_DISALLOWED |
Los widgets del perfil de trabajo no están permitidos de forma predeterminada. Esto significa que, si la política no especifica como para la aplicación, no podrá agregar widgets a la pantalla principal. |
CrossProfileAppFunctions
Controla si las apps del perfil personal pueden invocar funciones de apps expuestas por apps en el perfil de trabajo.
Enumeraciones | |
---|---|
CROSS_PROFILE_APP_FUNCTIONS_UNSPECIFIED |
Sin especificar. Si se establece en , el valor predeterminado es . Si se establece en , el valor predeterminado es . |
CROSS_PROFILE_APP_FUNCTIONS_DISALLOWED |
Las apps del perfil personal no pueden invocar funciones de apps expuestas por apps en el perfil de trabajo. |
CROSS_PROFILE_APP_FUNCTIONS_ALLOWED |
Las apps del perfil personal pueden invocar funciones de apps expuestas por apps en el perfil de trabajo. Si se establece este parámetro, no debe establecerse en . De lo contrario, se rechazará la política. |
PreferentialNetworkService
Controla si el servicio de red preferencial está habilitado en el perfil de trabajo o en dispositivos completamente administrados. Consulta
para obtener información.preferentialNetworkService
Enumeraciones | |
---|---|
PREFERENTIAL_NETWORK_SERVICE_UNSPECIFIED |
Sin especificar. La configuración predeterminada es PREFERENTIAL_NETWORK_SERVICES_DISABLED . |
PREFERENTIAL_NETWORK_SERVICE_DISABLED |
El servicio de red preferencial está inhabilitado en el perfil de trabajo. |
PREFERENTIAL_NETWORK_SERVICE_ENABLED |
El servicio de red preferencial está habilitado en el perfil de trabajo. Este parámetro de configuración solo se admite en perfiles de trabajo en dispositivos que ejecutan Android 12 o versiones posteriores. A partir de Android 13, también se admiten los dispositivos completamente administrados. |
UsageLog
Controla los tipos de registros de actividad del dispositivo que se recopilan del dispositivo y se informan a través de la notificación de Pub/Sub.
Representación JSON |
---|
{ "enabledLogTypes": [ enum ( |
Campos | |
---|---|
enabledLogTypes[] |
Especifica qué tipos de registros están habilitados. Ten en cuenta que los usuarios recibirán mensajes en el dispositivo cuando se habilite el registro de uso. |
uploadOnCellularAllowed[] |
Especifica cuáles de los tipos de registros habilitados se pueden subir a través de datos móviles. De forma predeterminada, los registros se ponen en cola para subirse cuando el dispositivo se conecta a una red Wi-Fi. |
LogType
Son los tipos de registros de actividad del dispositivo que se informan desde el dispositivo.
Enumeraciones | |
---|---|
LOG_TYPE_UNSPECIFIED |
Este valor no se usa. |
SECURITY_LOGS |
Habilita el registro de eventos de seguridad en el dispositivo, como cuando se ingresa incorrectamente la contraseña del dispositivo o se conecta un almacenamiento extraíble. Consulta para obtener una descripción completa de los eventos de seguridad registrados. Se admite en dispositivos completamente administrados con Android 7 y versiones posteriores. Se admite en dispositivos de la empresa con un perfil de trabajo en Android 12 y versiones posteriores, en los que solo se registran los eventos de seguridad del perfil de trabajo. Se puede anular con el alcance delegado de la aplicación
|
NETWORK_ACTIVITY_LOGS |
Habilita el registro de eventos de red en el dispositivo, como las búsquedas de DNS y las conexiones TCP. Consulta para obtener una descripción completa de los eventos de red registrados. Es compatible con dispositivos totalmente administrados que ejecutan Android 8 y versiones posteriores. Se admite en dispositivos empresariales con un perfil de trabajo en Android 12 y versiones posteriores, en los que solo se registran los eventos de red del perfil de trabajo. Se puede anular con el alcance delegado de la aplicación
|
CameraAccess
Controla el uso de la cámara y si el usuario tiene acceso al botón de activación de acceso a la cámara. El botón de activación de acceso a la cámara está disponible en Android 12 y versiones posteriores. Como principio general, la posibilidad de inhabilitar la cámara se aplica en todo el dispositivo en el caso de los dispositivos completamente administrados y solo dentro del perfil de trabajo en el caso de los dispositivos con un perfil de trabajo. La posibilidad de inhabilitar el botón de activación de acceso a la cámara solo se aplica a los dispositivos completamente administrados, en cuyo caso se aplica a todo el dispositivo. Para obtener detalles, consulta los valores de enumeración.
Enumeraciones | |
---|---|
CAMERA_ACCESS_UNSPECIFIED |
Si es verdadero, esto equivale a . De lo contrario, equivale a . |
CAMERA_ACCESS_USER_CHOICE |
Se ignora el campo . Este es el comportamiento predeterminado del dispositivo: todas las cámaras del dispositivo están disponibles. En Android 12 y versiones posteriores, el usuario puede usar el botón de activación de acceso a la cámara. |
CAMERA_ACCESS_DISABLED |
Se ignora el campo No hay restricciones explícitas en el botón de activación de acceso a la cámara en Android 12 y versiones posteriores: en los dispositivos completamente administrados, el botón de activación de acceso a la cámara no tiene efecto, ya que todas las cámaras están inhabilitadas. En los dispositivos con un perfil de trabajo, este botón de activación no tiene efecto en las apps del perfil de trabajo, pero sí en las apps fuera del perfil de trabajo. |
CAMERA_ACCESS_ENFORCED |
Se ignora el campo . Todas las cámaras del dispositivo están disponibles. En los dispositivos completamente administrados que ejecutan Android 12 y versiones posteriores, el usuario no puede usar el botón de activación de acceso a la cámara. En los dispositivos que no están completamente administrados o que ejecutan Android 11 o versiones anteriores, esto equivale a . |
MicrophoneAccess
En los dispositivos completamente administrados, controla el uso del micrófono y si el usuario tiene acceso al botón de activación de acceso al micrófono. Este parámetro de configuración no tiene efecto en los dispositivos que no están completamente administrados. El botón de activación o desactivación del acceso al micrófono está disponible en Android 12 y versiones posteriores.
Enumeraciones | |
---|---|
MICROPHONE_ACCESS_UNSPECIFIED |
Si es verdadero, esto equivale a . De lo contrario, equivale a . |
MICROPHONE_ACCESS_USER_CHOICE |
Se ignora el campo . Este es el comportamiento predeterminado del dispositivo: el micrófono del dispositivo está disponible. En Android 12 y versiones posteriores, el usuario puede usar el botón de activación de acceso al micrófono. |
MICROPHONE_ACCESS_DISABLED |
Se ignora el campo El botón de activación del acceso al micrófono no tiene efecto, ya que el micrófono está inhabilitado. |
MICROPHONE_ACCESS_ENFORCED |
Se ignora el campo . El micrófono del dispositivo está disponible. En los dispositivos que ejecutan Android 12 y versiones posteriores, el usuario no puede usar el botón de activación de acceso al micrófono. En dispositivos que ejecutan Android 11 o versiones anteriores, esto equivale a . |
DeviceConnectivityManagement
Abarca los controles de conectividad del dispositivo, como Wi-Fi, acceso a datos USB, conexiones de teclado y mouse, y mucho más.
Representación JSON |
---|
{ "usbDataAccess": enum ( |
Campos | |
---|---|
usbDataAccess |
Controla qué archivos o datos se pueden transferir a través de USB. Solo se admite en dispositivos de la empresa. |
configureWifi |
Controla los privilegios de configuración de Wi-Fi. Según la opción establecida, el usuario tendrá control total, limitado o nulo para configurar redes Wi-Fi. |
wifiDirectSettings |
Controla la configuración y el uso de los parámetros de configuración de Wi-Fi Direct. Es compatible con dispositivos empresariales que ejecutan Android 13 y versiones posteriores. |
tetheringSettings |
Controla la configuración de la conexión. Según el conjunto de valores, se prohíbe parcial o totalmente al usuario usar diferentes formas de conexión. |
wifiSsidPolicy |
Restricciones sobre los SSID de Wi-Fi a los que se puede conectar el dispositivo. Ten en cuenta que esto no afecta las redes que se pueden configurar en el dispositivo. Es compatible con dispositivos empresariales que ejecutan Android 13 y versiones posteriores. |
wifiRoamingPolicy |
Opcional. Política de roaming de Wi-Fi. |
bluetoothSharing |
Opcional. Controla si se permite el uso compartido por Bluetooth. |
preferentialNetworkServiceSettings |
Opcional. Es la configuración del servicio de red preferencial. Si se configura este campo, se anulará |
apnPolicy |
Opcional. Política de nombre de punto de acceso (APN). Es la configuración de los nombres de puntos de acceso (APN) que pueden anular cualquier otro APN del dispositivo. Consulta |
UsbDataAccess
Controla qué archivos o datos se pueden transferir a través de USB. No afecta las funciones de carga. Solo se admite en dispositivos de la empresa.
Enumeraciones | |
---|---|
USB_DATA_ACCESS_UNSPECIFIED |
Sin especificar. La configuración predeterminada es . |
ALLOW_USB_DATA_TRANSFER |
Se permiten todos los tipos de transferencias de datos por USB. Se ignora . |
DISALLOW_USB_FILE_TRANSFER |
No se permite la transferencia de archivos a través de USB. Se permiten otros tipos de conexiones de datos por USB, como la conexión de mouse y teclado. Se ignora . |
DISALLOW_USB_DATA_TRANSFER |
Cuando se configura, se prohíben todos los tipos de transferencias de datos por USB. Es compatible con dispositivos que ejecutan Android 12 o versiones posteriores con HAL de USB 1.3 o versiones posteriores. Si no se admite el parámetro de configuración, se establecerá . Se informa un con si la versión de Android es inferior a 12. Se informa un con si el dispositivo no tiene HAL de USB 1.3 o una versión posterior. Se ignora . |
ConfigureWifi
Controla los privilegios de configuración de Wi-Fi. Según la opción establecida, el usuario tendrá control total, limitado o nulo para configurar redes Wi-Fi.
Enumeraciones | |
---|---|
CONFIGURE_WIFI_UNSPECIFIED |
Sin especificar. El valor predeterminado es , a menos que esté establecido como verdadero. Si se establece como verdadero, esto equivale a . |
ALLOW_CONFIGURING_WIFI |
El usuario puede configurar la conexión Wi-Fi. Se ignora . |
DISALLOW_ADD_WIFI_CONFIG |
No se permite agregar nuevas configuraciones de Wi-Fi. El usuario solo puede cambiar entre las redes ya configuradas. Se admite en Android 13 y versiones posteriores, en dispositivos completamente administrados y perfiles de trabajo en dispositivos empresariales. Si no se admite el parámetro de configuración, se establece . Se informa un con si la versión de Android es anterior a la 13. Se ignora . |
DISALLOW_CONFIGURING_WIFI |
No permite configurar redes Wi-Fi. El parámetro de configuración se ignora cuando se establece este valor. Se admite en dispositivos completamente administrados y perfiles de trabajo en dispositivos empresariales, en todos los niveles de API admitidos. En el caso de los dispositivos completamente administrados, si se establece este parámetro, se quitan todas las redes configuradas y solo se conservan las redes configuradas con la política . En el caso de los perfiles de trabajo en dispositivos empresariales, las redes configuradas existentes no se ven afectadas y el usuario no puede agregar, quitar ni modificar redes Wi-Fi. Nota: Si no se puede establecer una conexión de red durante el inicio y la configuración de Wi-Fi está inhabilitada, se mostrará el escape de red para actualizar la política del dispositivo (consulta ). |
WifiDirectSettings
Controla la configuración de Wi-Fi Direct. Es compatible con dispositivos empresariales que ejecutan Android 13 y versiones posteriores.
Enumeraciones | |
---|---|
WIFI_DIRECT_SETTINGS_UNSPECIFIED |
Sin especificar. La configuración predeterminada es . |
ALLOW_WIFI_DIRECT |
El usuario puede usar Wi-Fi Direct. |
DISALLOW_WIFI_DIRECT |
El usuario no tiene permiso para usar Wi-Fi Direct. Se informa un con si la versión de Android es anterior a la 13. |
TetheringSettings
Controla el grado en que se le permite al usuario usar diferentes formas de vinculación, como la vinculación por Wi-Fi, la vinculación por Bluetooth, etcétera.
Enumeraciones | |
---|---|
TETHERING_SETTINGS_UNSPECIFIED |
Sin especificar. El valor predeterminado es , a menos que esté establecido como verdadero. Si se establece como verdadero, esto equivale a . |
ALLOW_ALL_TETHERING |
Permite configurar y usar todas las formas de conexión. Se ignora . |
DISALLOW_WIFI_TETHERING |
No permite que el usuario use la conexión Wi-Fi. Es compatible con dispositivos propiedad de la empresa que ejecutan Android 13 y versiones posteriores. Si no se admite el parámetro de configuración, se establecerá . Se informa un con si la versión de Android es anterior a la 13. Se ignora . |
DISALLOW_ALL_TETHERING |
No permite ninguna forma de conexión. Es compatible con dispositivos completamente administrados y perfiles de trabajo en dispositivos empresariales, en todas las versiones de Android compatibles. Se ignora el parámetro de configuración . |
WifiSsidPolicy
Restricciones sobre los SSID de Wi-Fi a los que se puede conectar el dispositivo. Ten en cuenta que esto no afecta las redes que se pueden configurar en el dispositivo. Es compatible con dispositivos empresariales que ejecutan Android 13 y versiones posteriores.
Representación JSON |
---|
{ "wifiSsidPolicyType": enum ( |
Campos | |
---|---|
wifiSsidPolicyType |
Es el tipo de política de SSID de Wi-Fi que se aplicará. |
wifiSsids[] |
Opcional. Es la lista de SSID de Wi-Fi que se deben aplicar en la política. Este campo no debe estar vacío cuando WifiSsidPolicyType se establece en |
WifiSsidPolicyType
Son los tipos de políticas de SSID de Wi-Fi que se pueden aplicar en el dispositivo.
Enumeraciones | |
---|---|
WIFI_SSID_POLICY_TYPE_UNSPECIFIED |
La configuración predeterminada es . No se debe establecer . No hay restricciones sobre a qué SSID se puede conectar el dispositivo. |
WIFI_SSID_DENYLIST |
El dispositivo no se puede conectar a ninguna red Wi-Fi cuyo SSID esté en , pero sí a otras redes. |
WIFI_SSID_ALLOWLIST |
El dispositivo solo puede establecer conexiones Wi-Fi con los SSID que se encuentran en . no debe estar vacío. El dispositivo no podrá conectarse a ninguna otra red Wi-Fi. |
WifiSsid
Representa un SSID de Wi-Fi.
Representación JSON |
---|
{ "wifiSsid": string } |
Campos | |
---|---|
wifiSsid |
Es obligatorio. SSID de Wi-Fi representado como una cadena. |
WifiRoamingPolicy
Política de roaming de Wi-Fi.
Representación JSON |
---|
{
"wifiRoamingSettings": [
{
object ( |
Campos | |
---|---|
wifiRoamingSettings[] |
Opcional. Es la configuración de roaming de Wi-Fi. Los SSID proporcionados en esta lista deben ser únicos. De lo contrario, se rechazará la política. |
WifiRoamingSetting
Es el parámetro de configuración de roaming de Wi-Fi.
Representación JSON |
---|
{
"wifiSsid": string,
"wifiRoamingMode": enum ( |
Campos | |
---|---|
wifiSsid |
Es obligatorio. SSID de la red Wi-Fi. |
wifiRoamingMode |
Es obligatorio. Modo de itinerancia de Wi-Fi para el SSID especificado. |
WifiRoamingMode
Modo de roaming de Wi-Fi.
Enumeraciones | |
---|---|
WIFI_ROAMING_MODE_UNSPECIFIED |
Sin especificar. La configuración predeterminada es . |
WIFI_ROAMING_DISABLED |
La itinerancia Wi-Fi está inhabilitada. Es compatible con Android 15 y versiones posteriores en dispositivos completamente administrados y perfiles de trabajo en dispositivos empresariales. Se informa un con para otros modos de administración. Se informa un con si la versión de Android es inferior a 15. |
WIFI_ROAMING_DEFAULT |
Es el modo de roaming de Wi-Fi predeterminado del dispositivo. |
WIFI_ROAMING_AGGRESSIVE |
Modo de roaming agresivo que permite un roaming de Wi-Fi más rápido. Es compatible con Android 15 y versiones posteriores en dispositivos completamente administrados y perfiles de trabajo en dispositivos empresariales. Se informa un con para otros modos de administración. Se informa un con si la versión de Android es inferior a 15. Se informa un con si el dispositivo no admite el modo de roaming agresivo. |
BluetoothSharing
Controla si se permite el uso compartido por Bluetooth.
Enumeraciones | |
---|---|
BLUETOOTH_SHARING_UNSPECIFIED |
Sin especificar. El valor predeterminado es BLUETOOTH_SHARING_DISALLOWED en los perfiles de trabajo y BLUETOOTH_SHARING_ALLOWED en los dispositivos completamente administrados. |
BLUETOOTH_SHARING_ALLOWED |
Se permite el uso compartido por Bluetooth. Compatible con Android 8 y versiones posteriores. Se informa un |
BLUETOOTH_SHARING_DISALLOWED |
No se permite el uso compartido por Bluetooth. Compatible con Android 8 y versiones posteriores. Se informa un |
PreferentialNetworkServiceSettings
Configuración del servicio de red preferencial.
Representación JSON |
---|
{ "preferentialNetworkServiceConfigs": [ { object ( |
Campos | |
---|---|
preferentialNetworkServiceConfigs[] |
Es obligatorio. Configuraciones preferenciales de servicios de red que permiten tener varias segmentaciones empresariales No debe haber varias configuraciones con el mismo |
defaultPreferentialNetworkId |
Es obligatorio. Es el ID de red preferencial predeterminado para las aplicaciones que no están en
|
PreferentialNetworkServiceConfig
Configuración individual del servicio de red preferencial.
Representación JSON |
---|
{ "preferentialNetworkId": enum ( |
Campos | |
---|---|
preferentialNetworkId |
Es obligatorio. Es el identificador de red preferencial. No se debe establecer en |
fallbackToDefaultConnection |
Opcional. Indica si se permite la red predeterminada para todo el dispositivo como alternativa. Si se establece en |
nonMatchingNetworks |
Opcional. Indica si las apps a las que se aplica esta configuración tienen bloqueado el uso de redes que no sean el servicio preferencial. Si se establece en |
FallbackToDefaultConnection
Indica si se permite la red predeterminada para todo el dispositivo como alternativa. Ten en cuenta que, si bien este parámetro de configuración determina si las apps sujetas a esta configuración tienen una red predeterminada en ausencia de un servicio preferencial, las apps aún pueden decidir explícitamente usar otra red que no sea su red predeterminada solicitándola al sistema. Este parámetro de configuración no determina si se bloquea el uso de otras redes por parte de las apps. Consulta
para ver este parámetro de configuración.nonMatchingNetworks
Enumeraciones | |
---|---|
FALLBACK_TO_DEFAULT_CONNECTION_UNSPECIFIED |
Sin especificar. La configuración predeterminada es FALLBACK_TO_DEFAULT_CONNECTION_ALLOWED . |
FALLBACK_TO_DEFAULT_CONNECTION_ALLOWED |
Se permite la conexión de respaldo predeterminada. Si se establece este parámetro, no debe establecerse como NON_MATCHING_NETWORKS_DISALLOWED . De lo contrario, se rechazará la política. |
FALLBACK_TO_DEFAULT_CONNECTION_DISALLOWED |
No se permite la conexión de respaldo a la conexión predeterminada. |
NonMatchingNetworks
Indica si las apps a las que se aplica esta configuración pueden usar redes que no sean el servicio preferencial. Las apps pueden inspeccionar la lista de redes disponibles en el dispositivo y optar por usar varias redes de forma simultánea por motivos de rendimiento, privacidad o de otro tipo.
Enumeraciones | |
---|---|
NON_MATCHING_NETWORKS_UNSPECIFIED |
Sin especificar. La configuración predeterminada es NON_MATCHING_NETWORKS_ALLOWED . |
NON_MATCHING_NETWORKS_ALLOWED |
Las apps a las que se aplica esta configuración pueden usar redes que no sean el servicio preferencial. |
NON_MATCHING_NETWORKS_DISALLOWED |
Las apps a las que se aplica esta configuración no pueden usar otras redes que no sean el servicio preferencial. Se puede configurar en Android 14 y versiones posteriores. Se informa un con si la versión de Android es anterior a la 14. Si se establece este parámetro, debe establecerse como FALLBACK_TO_DEFAULT_CONNECTION_DISALLOWED . De lo contrario, se rechazará la política. |
ApnPolicy
Política de nombre de punto de acceso (APN). Es la configuración de los nombres de puntos de acceso (APN) que pueden anular cualquier otro APN del dispositivo. Consulta
y OVERRIDE_APNS_ENABLED
para obtener más información.overrideApns
Representación JSON |
---|
{ "overrideApns": enum ( |
Campos | |
---|---|
overrideApns |
Opcional. Indica si los APN de anulación están inhabilitados o habilitados. Consulta |
apnSettings[] |
Opcional. Es la configuración del APN para los APN de anulación. No debe haber ningún conflicto entre los parámetros de configuración del APN proporcionados; de lo contrario, se rechazará la política. Se considera que dos |
OverrideApns
Indica si los APN de anulación están inhabilitados o habilitados. Consulta DevicePolicyManager.setOverrideApnsEnabled
para obtener más detalles.
Enumeraciones | |
---|---|
OVERRIDE_APNS_UNSPECIFIED |
Sin especificar. La configuración predeterminada es OVERRIDE_APNS_DISABLED . |
OVERRIDE_APNS_DISABLED |
Se inhabilitaron los APN de anulación. Los configurados se guardan en el dispositivo, pero están inhabilitados y no tienen efecto. Cualquier otro APN del dispositivo seguirá en uso. |
OVERRIDE_APNS_ENABLED |
Se habilitaron los APN de anulación. Solo se usan los APN de anulación, y se ignoran los demás. Solo se puede configurar en dispositivos completamente administrados con Android 10 y versiones posteriores. En el caso de los perfiles de trabajo, las anulaciones de APNs se habilitan a través de , y este valor no se puede establecer. Se informa un con si la versión de Android es anterior a la 10. Se informa un con para los perfiles de trabajo. |
ApnSetting
Es una configuración del nombre de punto de acceso (APN) para una conexión de datos del operador. El APN proporciona la configuración para conectar un dispositivo de red móvil a una red de datos IP. Un operador usa este parámetro de configuración para decidir qué dirección IP asignar, qué métodos de seguridad aplicar y cómo se puede conectar el dispositivo a redes privadas.
Representación JSON |
---|
{ "apnTypes": [ enum ( |
Campos | |
---|---|
apnTypes[] |
Es obligatorio. Son las categorías de uso del APN. Se rechazará la política si este campo está vacío o contiene |
apn |
Es obligatorio. Nombre del APN. Se rechazará la política si este campo está vacío. |
displayName |
Es obligatorio. Es el nombre legible que describe el APN. Se rechazará la política si este campo está vacío. |
alwaysOnSetting |
Opcional. Indica si los recursos del plano de usuario se tienen que activar durante cada transición del modo CM-IDLE al estado CM-CONNECTED para este APN. Consulta la sección 5.6.13 de 3GPP TS 23.501. |
authType |
Opcional. Es el tipo de autenticación del APN. |
carrierId |
Opcional. Es el ID del operador para el APN. Un valor de 0 (predeterminado) significa que no se configuró, y se rechazan los valores negativos. |
mmsProxyAddress |
Opcional. Dirección de proxy de MMS (Servicio de mensajería multimedia) del APN, que puede ser una dirección IP o un nombre de host (no una URL). |
mmsProxyPort |
Opcional. Puerto de proxy de MMS (Servicio de mensajería multimedia) del APN. Un valor de 0 (predeterminado) significa que no se configuró, y se rechazan los valores negativos. |
mmsc |
Opcional. Es el URI del MMSC (Centro de servicio de mensajería multimedia) del APN. |
mtuV4 |
Opcional. Tamaño predeterminado de la MTU (unidad de transmisión máxima) en bytes de las rutas IPv4 que se activan con este parámetro de configuración del APN. Un valor de 0 (predeterminado) significa que no se configuró, y se rechazan los valores negativos. Compatible con Android 13 y versiones posteriores. Se informa un |
mtuV6 |
Opcional. Tamaño de la MTU (unidad máxima de transmisión) de la interfaz móvil IPv6 a la que se conectó el APN. Un valor de 0 (predeterminado) significa que no se configuró, y se rechazan los valores negativos. Compatible con Android 13 y versiones posteriores. Se informa un |
mvnoType |
Opcional. Es el tipo de coincidencia del OMV para el APN. |
networkTypes[] |
Opcional. Son las tecnologías de radio (tipos de redes) que puede usar el APN. Se rechazará la política si este campo contiene |
username |
Opcional. Nombre de usuario del APN. |
password |
Opcional. Contraseña del APN. |
numericOperatorId |
Opcional. Es el ID numérico del operador de la APN. El ID de operador numérico se define como MCC (código móvil de país) + MNC (código de red móvil). |
protocol |
Opcional. Es el protocolo que se usará para conectarse a este APN. |
roamingProtocol |
Opcional. Es el protocolo que se usará para conectarse a este APN mientras el dispositivo está en roaming. |
proxyAddress |
Opcional. Es la dirección del proxy del APN. |
proxyPort |
Opcional. Es el puerto del proxy del APN. Un valor de 0 (predeterminado) significa que no se configuró, y se rechazan los valores negativos. |
ApnType
Es la categoría de uso del APN.
Enumeraciones | |
---|---|
APN_TYPE_UNSPECIFIED |
Sin especificar. Este valor no se usa. |
ENTERPRISE |
Tipo de APN para el tráfico empresarial. Compatible con Android 13 y versiones posteriores. Se informa un con si la versión de Android es anterior a la 13. |
BIP |
Es el tipo de APN para BIP (protocolo independiente del portador). Solo se puede configurar en dispositivos completamente administrados con Android 12 y versiones posteriores. Se informa un con si la versión de Android es inferior a 12. Se informa un con para los perfiles de trabajo. |
CBS |
Tipo de APN para CBS (servicios con la marca del operador). Solo se puede configurar en dispositivos completamente administrados. Se informa un con para los perfiles de trabajo. |
DEFAULT |
Tipo de APN para el tráfico de datos predeterminado. Solo se puede configurar en dispositivos completamente administrados. Se informa un con para los perfiles de trabajo. |
DUN |
Es el tipo de APN para el tráfico de DUN (Dial-up networking). Solo se puede configurar en dispositivos completamente administrados. Se informa un con para los perfiles de trabajo. |
EMERGENCY |
Tipo de APN para la PDN de emergencia. No es un APN de IA, sino que se usa para acceder a los servicios del operador en una situación de llamada de emergencia. Solo se puede configurar en dispositivos completamente administrados. Se informa un con para los perfiles de trabajo. |
FOTA |
Tipo de APN para acceder al portal de FOTA (Firmware Over-the-Air) del operador, que se usa para las actualizaciones inalámbricas. Solo se puede configurar en dispositivos completamente administrados. Se informa un con para los perfiles de trabajo. |
HIPRI |
Es el tipo de APN para el tráfico de alta prioridad (HiPri). Solo se puede configurar en dispositivos completamente administrados. Se informa un con para los perfiles de trabajo. |
IA |
Es el tipo de APN para el APN de IA (vinculación inicial). Solo se puede configurar en dispositivos completamente administrados. Se informa un con para los perfiles de trabajo. |
IMS |
Tipo de APN para el tráfico de IMS (IP Multimedia Subsystem). Solo se puede configurar en dispositivos completamente administrados. Se informa un con para los perfiles de trabajo. |
MCX |
Tipo de APN para MCX (servicio esencial) donde X puede ser PTT, video o datos. Solo se puede configurar en dispositivos completamente administrados. Se informa un con para los perfiles de trabajo. |
MMS |
Es el tipo de APN para el tráfico de MMS (Servicio de mensajes multimedia). Solo se puede configurar en dispositivos completamente administrados. Se informa un con para los perfiles de trabajo. |
RCS |
Tipo de APN para RCS (servicios de comunicación enriquecida). Solo se puede configurar en dispositivos completamente administrados con Android 15 y versiones posteriores. Se informa un con si la versión de Android es inferior a 15. Se informa un con para los perfiles de trabajo. |
SUPL |
Es el tipo de APN para el GPS asistido por SUPL (Secure User Plane Location). Solo se puede configurar en dispositivos completamente administrados. Se informa un con para los perfiles de trabajo. |
VSIM |
Es el tipo de APN para el servicio de VSIM (SIM virtual). Solo se puede configurar en dispositivos completamente administrados con Android 12 y versiones posteriores. Se informa un con si la versión de Android es inferior a 12. Se informa un con para los perfiles de trabajo. |
XCAP |
Es el tipo de APN para el tráfico de XCAP (protocolo de acceso a la configuración XML). Solo se puede configurar en dispositivos completamente administrados con Android 11 y versiones posteriores. Se informa un con si la versión de Android es anterior a la 11. Se informa un con para los perfiles de trabajo. |
AlwaysOnSetting
Indica si los recursos del plano de usuario se tienen que activar durante cada transición del modo CM-IDLE al estado CM-CONNECTED para este APN. Consulta la sección 5.6.13 de 3GPP TS 23.501.
Enumeraciones | |
---|---|
ALWAYS_ON_SETTING_UNSPECIFIED |
Sin especificar. La configuración predeterminada es NOT_ALWAYS_ON . |
NOT_ALWAYS_ON |
La sesión de PDU que inicia este APN no debe estar siempre activa. |
ALWAYS_ON |
La sesión de PDU que inicia este APN siempre debe estar activa. Compatible con Android 15 y versiones posteriores. Se informa un con si la versión de Android es inferior a 15. |
AuthType
Es el tipo de autenticación del APN.
Enumeraciones | |
---|---|
AUTH_TYPE_UNSPECIFIED |
Sin especificar. Si está vacío, el valor predeterminado es NONE . De lo contrario, el valor predeterminado es PAP_OR_CHAP . |
NONE |
No se requiere autenticación. |
PAP |
Es el tipo de autenticación para PAP. |
CHAP |
Es el tipo de autenticación para CHAP. |
PAP_OR_CHAP |
Tipo de autenticación para PAP o CHAP. |
MvnoType
Es el tipo de coincidencia del OMV para el APN.
Enumeraciones | |
---|---|
MVNO_TYPE_UNSPECIFIED |
No se especificó el tipo de MVNO. |
GID |
Es el tipo de MVNO para el identificador de grupo de nivel 1. |
ICCID |
Tipo de OMV para el ICCID. |
IMSI |
Tipo de OMV para el IMSI. |
SPN |
Tipo de OMV para el SPN (nombre del proveedor de servicios). |
NetworkType
Es la tecnología de radio (tipo de red) que puede usar el APN.
Enumeraciones | |
---|---|
NETWORK_TYPE_UNSPECIFIED |
Sin especificar. No se debe usar este valor. |
EDGE |
Tecnología de radio EDGE. |
GPRS |
Tecnología de radio GPRS. |
GSM |
Tecnología de radio GSM. |
HSDPA |
Tecnología de radio HSDPA. |
HSPA |
Tecnología de radio HSPA. |
HSPAP |
Tecnología de radio HSPAP. |
HSUPA |
Tecnología de radio HSUPA. |
IWLAN |
Tecnología de radio IWLAN. |
LTE |
Tecnología de radio LTE. |
NR |
Tecnología de radio NR (New Radio) 5G. |
TD_SCDMA |
Tecnología de radio TD_SCDMA. |
UMTS |
Tecnología de radio UMTS. |
Protocolo
Es el protocolo que se usará para conectarse al APN.
Enumeraciones | |
---|---|
PROTOCOL_UNSPECIFIED |
No se especificó el protocolo. |
IP |
Es el protocolo de Internet. |
IPV4V6 |
Se introdujo el tipo de PDP virtual para controlar la capacidad del UE de pila doble de IP. |
IPV6 |
Es el protocolo de Internet, versión 6. |
NON_IP |
Transferencia de datos que no son de IP a una red externa de datos de paquetes. |
PPP |
Es el protocolo punto a punto. |
UNSTRUCTURED |
Transferencia de datos no estructurados a la red de datos a través de N6. |
DeviceRadioState
Controles para la configuración de radio del dispositivo.
Representación JSON |
---|
{ "wifiState": enum ( |
Campos | |
---|---|
wifiState |
Controla el estado actual de la conexión Wi-Fi y si el usuario puede cambiar su estado. |
airplaneModeState |
Controla si el usuario puede activar o desactivar el modo de avión. |
ultraWidebandState |
Controla el estado del parámetro de configuración de banda ultraancha y si el usuario puede activarlo o desactivarlo. |
cellularTwoGState |
Controla si el usuario puede activar o desactivar el parámetro de configuración de 2G celular. |
minimumWifiSecurityLevel |
Es el nivel de seguridad mínimo requerido de las redes Wi-Fi a las que se puede conectar el dispositivo. |
WifiState
Controla si la conexión Wi-Fi está activada o desactivada como estado y si el usuario puede cambiar dicho estado. Es compatible con dispositivos empresariales que ejecutan Android 13 y versiones posteriores.
Enumeraciones | |
---|---|
WIFI_STATE_UNSPECIFIED |
Sin especificar. La configuración predeterminada es . |
WIFI_STATE_USER_CHOICE |
El usuario puede habilitar o inhabilitar el Wi-Fi. |
WIFI_ENABLED |
El Wi-Fi está activado y el usuario no puede desactivarlo. Se informa un con si la versión de Android es inferior a la 13. |
WIFI_DISABLED |
El Wi-Fi está desactivado y el usuario no puede activarlo. Se informa un con si la versión de Android es anterior a la 13. |
AirplaneModeState
Controla el estado del modo de avión y si el usuario puede activarlo o desactivarlo. Se admite en Android 9 y versiones posteriores. Se admite en dispositivos completamente administrados y perfiles de trabajo en dispositivos empresariales.
Enumeraciones | |
---|---|
AIRPLANE_MODE_STATE_UNSPECIFIED |
Sin especificar. La configuración predeterminada es . |
AIRPLANE_MODE_USER_CHOICE |
El usuario puede activar o desactivar el modo avión. |
AIRPLANE_MODE_DISABLED |
El modo avión está inhabilitado. El usuario no puede activar el modo avión. Se informa un con si la versión de Android es anterior a la 9. |
UltraWidebandState
Controla el estado del parámetro de configuración de banda ultraancha y si el usuario puede activarlo o desactivarlo. Es compatible con Android 14 y versiones posteriores. Se admite en dispositivos completamente administrados y perfiles de trabajo en dispositivos empresariales.
Enumeraciones | |
---|---|
ULTRA_WIDEBAND_STATE_UNSPECIFIED |
Sin especificar. La configuración predeterminada es . |
ULTRA_WIDEBAND_USER_CHOICE |
El usuario puede activar o desactivar la banda ultraancha. |
ULTRA_WIDEBAND_DISABLED |
La banda ultraancha está inhabilitada. El usuario no puede activar la banda ultraancha a través de la configuración. Se informa un con si la versión de Android es anterior a la 14. |
CellularTwoGState
Controla el estado del parámetro de configuración de 2G celular y si el usuario puede activarlo o desactivarlo. Es compatible con Android 14 y versiones posteriores. Se admite en dispositivos completamente administrados y perfiles de trabajo en dispositivos empresariales.
Enumeraciones | |
---|---|
CELLULAR_TWO_G_STATE_UNSPECIFIED |
Sin especificar. La configuración predeterminada es . |
CELLULAR_TWO_G_USER_CHOICE |
El usuario puede activar o desactivar la red celular 2G. |
CELLULAR_TWO_G_DISABLED |
La conexión celular 2G está inhabilitada. El usuario no puede activar la red 2G móvil a través de la configuración. Se informa un con si la versión de Android es anterior a la 14. |
MinimumWifiSecurityLevel
Define los diferentes niveles mínimos de seguridad de Wi-Fi necesarios para conectarse a redes Wi-Fi. Compatible con Android 13 y versiones posteriores. Se admite en dispositivos completamente administrados y perfiles de trabajo en dispositivos empresariales.
Enumeraciones | |
---|---|
MINIMUM_WIFI_SECURITY_LEVEL_UNSPECIFIED |
El valor predeterminado es , lo que significa que el dispositivo podrá conectarse a todos los tipos de redes Wi-Fi. |
OPEN_NETWORK_SECURITY |
El dispositivo podrá conectarse a todo tipo de redes Wi-Fi. |
PERSONAL_NETWORK_SECURITY |
Una red personal, como WEP o WPA2-PSK, es la seguridad mínima requerida. El dispositivo no podrá conectarse a redes Wi-Fi abiertas. Esta opción es más estricta que . Se informa un con si la versión de Android es anterior a la 13. |
ENTERPRISE_NETWORK_SECURITY |
Una red EAP empresarial es el nivel de seguridad mínimo requerido. El dispositivo no podrá conectarse a redes Wi-Fi con un nivel de seguridad inferior a este. Esta opción es más estricta que . Se informa un con si la versión de Android es anterior a la 13. |
ENTERPRISE_BIT192_NETWORK_SECURITY |
Una red empresarial de 192 bits es el nivel de seguridad mínimo requerido. El dispositivo no podrá conectarse a redes Wi-Fi con un nivel de seguridad inferior a este. Esta opción es más estricta que . Se informa un con si la versión de Android es anterior a la 13. |
CredentialProviderPolicyDefault
Controla qué apps pueden actuar como proveedores de credenciales en Android 14 y versiones posteriores. Estas apps almacenan credenciales. Consulta este y este vínculo para obtener más información. Consulta también
.credentialProviderPolicy
Enumeraciones | |
---|---|
CREDENTIAL_PROVIDER_POLICY_DEFAULT_UNSPECIFIED |
Sin especificar. La configuración predeterminada es CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED. |
CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED |
Las apps con sin especificar no pueden actuar como proveedor de credenciales. |
CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED_EXCEPT_SYSTEM |
Las apps con sin especificar no pueden actuar como proveedores de credenciales, excepto los proveedores de credenciales predeterminados del OEM. Los proveedores de credenciales predeterminados del OEM siempre pueden actuar como proveedores de credenciales. |
PrintingPolicy
Controla si se permite la impresión. Esta función es compatible con dispositivos que ejecutan Android 9 y versiones posteriores.
Enumeraciones | |
---|---|
PRINTING_POLICY_UNSPECIFIED |
Sin especificar. La configuración predeterminada es . |
PRINTING_DISALLOWED |
No se permite la impresión. Se informa un con si la versión de Android es anterior a la 9. |
PRINTING_ALLOWED |
Se permite la impresión. |
DisplaySettings
Controles para la configuración de la pantalla.
Representación JSON |
---|
{ "screenBrightnessSettings": { object ( |
Campos | |
---|---|
screenBrightnessSettings |
Opcional. Controla la configuración de brillo de la pantalla. |
screenTimeoutSettings |
Opcional. Controla la configuración del tiempo de espera de la pantalla. |
ScreenBrightnessSettings
Controles para la configuración del brillo de la pantalla.
Representación JSON |
---|
{
"screenBrightnessMode": enum ( |
Campos | |
---|---|
screenBrightnessMode |
Opcional. Controla el modo de brillo de la pantalla. |
screenBrightness |
Opcional. Es el brillo de la pantalla entre 1 y 255, donde 1 es el brillo más bajo y 255 es el más alto. Un valor de 0 (predeterminado) significa que no se estableció el brillo de la pantalla. Se rechaza cualquier otro valor. |
ScreenBrightnessMode
Controla el modo de brillo de la pantalla.
Enumeraciones | |
---|---|
SCREEN_BRIGHTNESS_MODE_UNSPECIFIED |
Sin especificar. La configuración predeterminada es . |
BRIGHTNESS_USER_CHOICE |
El usuario puede configurar el brillo de la pantalla. No se debe establecer . |
BRIGHTNESS_AUTOMATIC |
El modo de brillo de la pantalla es automático, por lo que el brillo se ajusta automáticamente y el usuario no puede configurar el brillo de la pantalla. se puede seguir configurando y se tiene en cuenta mientras se ajusta el brillo automáticamente. Es compatible con Android 9 y versiones posteriores en dispositivos completamente administrados. Se informa un con si la versión de Android es anterior a la 9. Es compatible con perfiles de trabajo en dispositivos empresariales con Android 15 y versiones posteriores. |
BRIGHTNESS_FIXED |
El modo de brillo de la pantalla es fijo, en el que el brillo se establece en y el usuario no puede configurar el brillo de la pantalla. Se debe establecer . Es compatible con Android 9 y versiones posteriores en dispositivos completamente administrados. Se informa un con si la versión de Android es anterior a la 9. Es compatible con perfiles de trabajo en dispositivos empresariales con Android 15 y versiones posteriores. |
ScreenTimeoutSettings
Controla la configuración del tiempo de espera de la pantalla.
Representación JSON |
---|
{
"screenTimeoutMode": enum ( |
Campos | |
---|---|
screenTimeoutMode |
Opcional. Controla si el usuario puede configurar el tiempo de espera de la pantalla. |
screenTimeout |
Opcional. Controla la duración del tiempo de espera de la pantalla. La duración del tiempo de espera de la pantalla debe ser mayor que 0; de lo contrario, se rechazará. Además, no debe ser mayor que Una duración en segundos con hasta nueve dígitos decimales, que terminan en “ |
ScreenTimeoutMode
Controla si el usuario puede configurar el tiempo de espera de la pantalla.
Enumeraciones | |
---|---|
SCREEN_TIMEOUT_MODE_UNSPECIFIED |
Sin especificar. La configuración predeterminada es . |
SCREEN_TIMEOUT_USER_CHOICE |
El usuario puede configurar el tiempo de espera de la pantalla. No se debe establecer . |
SCREEN_TIMEOUT_ENFORCED |
El tiempo de espera de la pantalla está establecido en , y el usuario no puede configurar el tiempo de espera. Se debe establecer . Es compatible con Android 9 y versiones posteriores en dispositivos completamente administrados. Se informa un con si la versión de Android es anterior a la 9. Es compatible con perfiles de trabajo en dispositivos empresariales con Android 15 y versiones posteriores. |
AssistContentPolicy
Controla si se permite enviar AssistContent a una app privilegiada, como una app de asistente. AssistContent incluye capturas de pantalla e información sobre una app, como el nombre del paquete. Esta función es compatible con Android 15 y versiones posteriores.
Enumeraciones | |
---|---|
ASSIST_CONTENT_POLICY_UNSPECIFIED |
Sin especificar. La configuración predeterminada es . |
ASSIST_CONTENT_DISALLOWED |
Se bloquea el envío de contenido de asistencia a una app privilegiada. Compatible con Android 15 y versiones posteriores. Se informa un |
ASSIST_CONTENT_ALLOWED |
Se permite enviar contenido de asistencia a una app privilegiada. Compatible con Android 15 y versiones posteriores. |
WorkAccountSetupConfig
Controla la configuración de la cuenta de trabajo, como los detalles sobre si se requiere una cuenta autenticada de Google.
Representación JSON |
---|
{
"authenticationType": enum ( |
Campos | |
---|---|
authenticationType |
Opcional. Es el tipo de autenticación del usuario en el dispositivo. |
requiredAccountEmail |
Opcional. Es la dirección de correo electrónico específica de la cuenta de trabajo de Google que se agregará. Este campo solo es relevante si |
AuthenticationType
Es el tipo de autenticación del usuario en el dispositivo.
Enumeraciones | |
---|---|
AUTHENTICATION_TYPE_UNSPECIFIED |
Sin especificar. La configuración predeterminada es . |
AUTHENTICATION_TYPE_NOT_ENFORCED |
No se aplica el estado de autenticación del usuario en el dispositivo. |
GOOGLE_AUTHENTICATED |
El dispositivo debe administrarse con una cuenta autenticada por Google. |
WipeDataFlag
Son marcas de limpieza que indican qué datos se borran cuando se activa una limpieza del dispositivo o del perfil por cualquier motivo. (por ejemplo, cuando el dispositivo no cumple con los requisitos). Esto no se aplica al método
.enterprises.devices.delete
Enumeraciones | |
---|---|
WIPE_DATA_FLAG_UNSPECIFIED |
No se debe usar este valor. |
WIPE_ESIMS |
En el caso de los dispositivos propiedad de la empresa, establecer este parámetro en quitará todas las eSIM del dispositivo cuando se active el borrado por cualquier motivo. En los dispositivos personales, se quitarán solo las eSIM administradas del dispositivo. (eSIMs que se agregan a través del comando ) Esta función es compatible con dispositivos que ejecutan Android 15 y versiones posteriores. Se informa un con si la versión de Android es inferior a 15. |
EnterpriseDisplayNameVisibility
Controla si el
es visible en el dispositivo (p.ej., el mensaje de la pantalla de bloqueo en dispositivos propiedad de la empresa).enterpriseDisplayName
Enumeraciones | |
---|---|
ENTERPRISE_DISPLAY_NAME_VISIBILITY_UNSPECIFIED |
Sin especificar. De forma predeterminada, se muestra el nombre de la empresa que se configuró en el momento de la configuración del dispositivo. En el futuro, el valor predeterminado será ENTERPRISE_DISPLAY_NAME_VISIBLE . |
ENTERPRISE_DISPLAY_NAME_VISIBLE |
El nombre visible de la empresa se ve en el dispositivo. Se admite en perfiles de trabajo en Android 7 y versiones posteriores. Es compatible con dispositivos completamente administrados que ejecutan Android 8 y versiones posteriores. Se informa un con si la versión de Android es anterior a la 7. Se informa un con en dispositivos completamente administrados con Android 7. |
ENTERPRISE_DISPLAY_NAME_HIDDEN |
El nombre visible de la empresa está oculto en el dispositivo. |
AppFunctions
Controla si las apps del dispositivo (en el caso de los dispositivos completamente administrados) o del perfil de trabajo (en el caso de los dispositivos con perfiles de trabajo) pueden exponer funciones de la app.
Enumeraciones | |
---|---|
APP_FUNCTIONS_UNSPECIFIED |
Sin especificar. La configuración predeterminada es . |
APP_FUNCTIONS_DISALLOWED |
Las apps en el dispositivo (en el caso de los dispositivos completamente administrados) o en el perfil de trabajo (en el caso de los dispositivos con perfiles de trabajo) no pueden exponer funciones de la app. Si se establece este parámetro, no debe establecerse en . De lo contrario, se rechazará la política. |
APP_FUNCTIONS_ALLOWED |
Las apps del dispositivo (en el caso de los dispositivos completamente administrados) o del perfil de trabajo (en el caso de los dispositivos con perfiles de trabajo) pueden exponer funciones de la app. |
Métodos |
|
---|---|
|
Borra una política. |
|
Obtiene una política. |
|
Enumera las políticas de una empresa determinada. |
|
Actualiza o crea aplicaciones en una política. |
|
Actualiza o crea una política. |
|
Quita aplicaciones de una política. |