REST Resource: enterprises.policies

资源：Policy

政策资源表示一组用于控制受管理设备及其所安装应用的行为的设置。

JSON 表示法 
{
  "name": string,
  "version": string,
  "applications": [
    {
      object (ApplicationPolicy)
    }
  ],
  "maximumTimeToLock": string,
  "screenCaptureDisabled": boolean,
  "cameraDisabled": boolean,
  "keyguardDisabledFeatures": [
    enum (KeyguardDisabledFeature)
  ],
  "defaultPermissionPolicy": enum (PermissionPolicy),
  "persistentPreferredActivities": [
    {
      object (PersistentPreferredActivity)
    }
  ],
  "openNetworkConfiguration": {
    object
  },
  "systemUpdate": {
    object (SystemUpdate)
  },
  "accountTypesWithManagementDisabled": [
    string
  ],
  "addUserDisabled": boolean,
  "adjustVolumeDisabled": boolean,
  "factoryResetDisabled": boolean,
  "installAppsDisabled": boolean,
  "mountPhysicalMediaDisabled": boolean,
  "modifyAccountsDisabled": boolean,
  "safeBootDisabled": boolean,
  "uninstallAppsDisabled": boolean,
  "statusBarDisabled": boolean,
  "keyguardDisabled": boolean,
  "minimumApiLevel": integer,
  "statusReportingSettings": {
    object (StatusReportingSettings)
  },
  "bluetoothContactSharingDisabled": boolean,
  "shortSupportMessage": {
    object (UserFacingMessage)
  },
  "longSupportMessage": {
    object (UserFacingMessage)
  },
  "passwordRequirements": {
    object (PasswordRequirements)
  },
  "wifiConfigsLockdownEnabled": boolean,
  "bluetoothConfigDisabled": boolean,
  "cellBroadcastsConfigDisabled": boolean,
  "credentialsConfigDisabled": boolean,
  "mobileNetworksConfigDisabled": boolean,
  "tetheringConfigDisabled": boolean,
  "vpnConfigDisabled": boolean,
  "wifiConfigDisabled": boolean,
  "createWindowsDisabled": boolean,
  "networkResetDisabled": boolean,
  "outgoingBeamDisabled": boolean,
  "outgoingCallsDisabled": boolean,
  "removeUserDisabled": boolean,
  "shareLocationDisabled": boolean,
  "smsDisabled": boolean,
  "unmuteMicrophoneDisabled": boolean,
  "usbFileTransferDisabled": boolean,
  "ensureVerifyAppsEnabled": boolean,
  "permittedInputMethods": {
    object (PackageNameList)
  },
  "stayOnPluggedModes": [
    enum (BatteryPluggedMode)
  ],
  "recommendedGlobalProxy": {
    object (ProxyInfo)
  },
  "setUserIconDisabled": boolean,
  "setWallpaperDisabled": boolean,
  "choosePrivateKeyRules": [
    {
      object (ChoosePrivateKeyRule)
    }
  ],
  "alwaysOnVpnPackage": {
    object (AlwaysOnVpnPackage)
  },
  "frpAdminEmails": [
    string
  ],
  "deviceOwnerLockScreenInfo": {
    object (UserFacingMessage)
  },
  "dataRoamingDisabled": boolean,
  "locationMode": enum (LocationMode),
  "networkEscapeHatchEnabled": boolean,
  "bluetoothDisabled": boolean,
  "complianceRules": [
    {
      object (ComplianceRule)
    }
  ],
  "blockApplicationsEnabled": boolean,
  "installUnknownSourcesAllowed": boolean,
  "debuggingFeaturesAllowed": boolean,
  "funDisabled": boolean,
  "autoTimeRequired": boolean,
  "permittedAccessibilityServices": {
    object (PackageNameList)
  },
  "appAutoUpdatePolicy": enum (AppAutoUpdatePolicy),
  "kioskCustomLauncherEnabled": boolean,
  "androidDevicePolicyTracks": [
    enum (AppTrack)
  ],
  "skipFirstUseHintsEnabled": boolean,
  "privateKeySelectionEnabled": boolean,
  "encryptionPolicy": enum (EncryptionPolicy),
  "usbMassStorageEnabled": boolean,
  "permissionGrants": [
    {
      object (PermissionGrant)
    }
  ],
  "playStoreMode": enum (PlayStoreMode),
  "setupActions": [
    {
      object (SetupAction)
    }
  ],
  "passwordPolicies": [
    {
      object (PasswordRequirements)
    }
  ],
  "policyEnforcementRules": [
    {
      object (PolicyEnforcementRule)
    }
  ],
  "kioskCustomization": {
    object (KioskCustomization)
  },
  "advancedSecurityOverrides": {
    object (AdvancedSecurityOverrides)
  },
  "personalUsagePolicies": {
    object (PersonalUsagePolicies)
  },
  "autoDateAndTimeZone": enum (AutoDateAndTimeZone),
  "oncCertificateProviders": [
    {
      object (OncCertificateProvider)
    }
  ],
  "crossProfilePolicies": {
    object (CrossProfilePolicies)
  },
  "preferentialNetworkService": enum (PreferentialNetworkService),
  "usageLog": {
    object (UsageLog)
  },
  "cameraAccess": enum (CameraAccess),
  "microphoneAccess": enum (MicrophoneAccess),
  "deviceConnectivityManagement": {
    object (DeviceConnectivityManagement)
  },
  "deviceRadioState": {
    object (DeviceRadioState)
  },
  "credentialProviderPolicyDefault": enum (CredentialProviderPolicyDefault),
  "printingPolicy": enum (PrintingPolicy),
  "displaySettings": {
    object (DisplaySettings)
  },
  "assistContentPolicy": enum (AssistContentPolicy),
  "workAccountSetupConfig": {
    object (WorkAccountSetupConfig)
  },
  "wipeDataFlags": [
    enum (WipeDataFlag)
  ],
  "enterpriseDisplayNameVisibility": enum (EnterpriseDisplayNameVisibility),
  "appFunctions": enum (AppFunctions)
}
字段
name

string

政策的名称，格式为 enterprises/{enterpriseId}/policies/{policyId}。
version

string (int64 format)

政策的版本。此字段是只读字段。每次更新政策时，版本都会递增。
applications[]

object (ApplicationPolicy)

应用于应用的政策。此数组最多可包含 3,000 个元素。
maximumTimeToLock

string (int64 format)

用户活动的最长时间（以毫秒为单位），超过此时间后设备将锁定。值为 0 表示没有限制。
screenCaptureDisabled

boolean

是否停用了屏幕截取功能。
cameraDisabled
(deprecated)

boolean

如果 cameraAccess 设置为除 CAMERA_ACCESS_UNSPECIFIED 以外的任何值，则此属性无效。否则，此字段会控制摄像头是否处于停用状态：如果为 true，则所有摄像头均处于停用状态；否则，摄像头处于可用状态。对于完全受管设备，此字段适用于设备上的所有应用。对于工作资料，此字段仅适用于工作资料中的应用，工作资料之外的应用的摄像头访问权限不受影响。
keyguardDisabledFeatures[]

enum (KeyguardDisabledFeature)

停用了锁屏自定义功能，例如微件。
defaultPermissionPolicy

enum (PermissionPolicy)

针对运行时权限请求的默认权限政策。
persistentPreferredActivities[]

object (PersistentPreferredActivity)

默认 intent 处理程序 activity。
openNetworkConfiguration

object (Struct format)

设备的网络配置。如需了解详情，请参阅配置网络。
systemUpdate

object (SystemUpdate)

系统更新政策，用于控制操作系统更新的应用方式。如果更新类型为 WINDOWED，更新窗口也会自动应用于 Play 应用更新。

注意： Google Play 系统更新（也称为 Mainline 更新）会自动下载，但需要重新启动设备才能安装。如需了解详情，请参阅管理系统更新中的 Mainline 部分。
accountTypesWithManagementDisabled[]

string

无法由用户管理的账号类型。
addUserDisabled

boolean

是否禁止添加新用户和个人资料。对于 managementMode 为 DEVICE_OWNER 的设备，系统会忽略此字段，并且永远不允许用户添加或移除用户。
adjustVolumeDisabled

boolean

是否禁止调整主音量。还会将设备设为静音。此设置仅对完全托管的设备有效。
factoryResetDisabled

boolean

是否已禁止通过“设置”恢复出厂设置。
installAppsDisabled

boolean

用户安装应用是否已停用。
mountPhysicalMediaDisabled

boolean

装载实体外部媒体的用户是否已被停用。
modifyAccountsDisabled

boolean

是否已停用添加或移除账号功能。
safeBootDisabled
(deprecated)

boolean

是否禁止将设备重新启动进入安全启动模式。
uninstallAppsDisabled

boolean

用户是否无法卸载应用。这样一来，即使使用 applications 移除应用，也无法卸载应用
statusBarDisabled
(deprecated)

boolean

状态栏是否已停用。此设置会停用通知、快速设置和其他允许退出全屏模式的屏幕叠加层。已弃用。如需在自助服务终端设备上停用状态栏，请使用 InstallType KIOSK 或 kioskCustomLauncherEnabled。
keyguardDisabled

boolean

如果为 true，则会针对主显示屏和/或辅助显示屏停用锁定屏幕。此政策仅在专用设备管理模式下受支持。
minimumApiLevel

integer

允许的最低 Android API 级别。
statusReportingSettings

object (StatusReportingSettings)

状态报告设置
bluetoothContactSharingDisabled

boolean

蓝牙联系人共享是否已停用。
shortSupportMessage

object (UserFacingMessage)

在管理员停用功能的设置界面中向用户显示的消息。如果消息长度超过 200 个字符，则可能会被截断。
longSupportMessage

object (UserFacingMessage)

在设备管理员设置界面中向用户显示的消息。
passwordRequirements
(deprecated)

object (PasswordRequirements)

密码要求。不得设置 passwordRequirements.require_password_unlock 字段。已弃用 - 请改用 passwordPolicies。

注意：

PasswordQuality 的基于复杂程度的值（即 COMPLEXITY_LOW、COMPLEXITY_MEDIUM 和 COMPLEXITY_HIGH）不能在此处使用。此处无法使用 unifiedLockSettings。
wifiConfigsLockdownEnabled
(deprecated)

boolean

此版本已弃用。
bluetoothConfigDisabled

boolean

配置蓝牙是否已停用。
cellBroadcastsConfigDisabled

boolean

配置小区广播是否已停用。
credentialsConfigDisabled

boolean

是否已停用配置用户凭据。
mobileNetworksConfigDisabled

boolean

配置移动网络是否已停用。
tetheringConfigDisabled
(deprecated)

boolean

是否停用了配置网络共享和便携式热点的功能。如果 tetheringSettings 设置为 TETHERING_SETTINGS_UNSPECIFIED 以外的任何值，则此设置将被忽略。
vpnConfigDisabled

boolean

是否停用配置 VPN。
wifiConfigDisabled
(deprecated)

boolean

配置 Wi-Fi 网络是否已停用。完全受管理的设备和公司自有设备上的工作资料支持此设置。对于完全受管理设备，如果将此值设置为 true，则会移除所有已配置的网络，仅保留使用 openNetworkConfiguration 配置的网络。对于公司自有设备上的工作资料，现有已配置的网络不受影响，用户无法添加、移除或修改 Wi-Fi 网络。如果 configureWifi 设置为 CONFIGURE_WIFI_UNSPECIFIED 以外的任何值，则此设置将被忽略。注意：如果在启动时无法建立网络连接，并且 Wi-Fi 配置处于停用状态，系统会显示网络紧急出口，以便刷新设备政策（请参阅 networkEscapeHatchEnabled）。
createWindowsDisabled

boolean

是否停用创建应用窗口以外的窗口。
networkResetDisabled

boolean

是否停用重置网络设置。
outgoingBeamDisabled

boolean

是否停用使用 NFC 从应用传输数据。
outgoingCallsDisabled

boolean

是否停用去电。
removeUserDisabled

boolean

是否已停用移除其他用户的功能。
shareLocationDisabled

boolean

位置信息分享功能是否已停用。shareLocationDisabled 同时支持完全托管设备和个人自有工作资料。
smsDisabled

boolean

是否已停用短信发送和接收功能。
unmuteMicrophoneDisabled
(deprecated)

boolean

如果 microphoneAccess 设置为除 MICROPHONE_ACCESS_UNSPECIFIED 以外的任何值，则此属性无效。否则，此字段会控制麦克风是否处于停用状态：如果为 true，则所有麦克风都处于停用状态；否则，麦克风处于可用状态。此功能仅适用于完全受管设备。
usbFileTransferDisabled
(deprecated)

boolean

是否停用了通过 USB 传输文件的功能。只有公司自有设备支持此功能。
ensureVerifyAppsEnabled
(deprecated)

boolean

应用验证是否强制启用。
permittedInputMethods

object (PackageNameList)

如果存在，则仅允许使用此列表中的软件包提供的输入法。如果此字段存在，但列表为空，则仅允许使用系统输入法。
stayOnPluggedModes[]

enum (BatteryPluggedMode)

设备在哪些已接通电源的模式下保持开启状态。使用此设置时，建议清除 maximumTimeToLock，以免设备在保持开启状态时自行锁定。
recommendedGlobalProxy

object (ProxyInfo)

独立于网络的全局 HTTP 代理。通常，应在 openNetworkConfiguration 中按网络配置代理。不过，对于一般内部过滤等特殊配置，全局 HTTP 代理可能很有用。如果无法访问代理，网络访问可能会中断。全局代理只是一个建议，部分应用可能会忽略它。
setUserIconDisabled

boolean

是否禁止更改用户图标。此设置仅对完全托管的设备有效。
setWallpaperDisabled

boolean

是否停用了更改壁纸的功能。
choosePrivateKeyRules[]

object (ChoosePrivateKeyRule)

用于确定应用对私钥的访问权限的规则。如需了解详情，请参阅 ChoosePrivateKeyRule。如果任何应用具有 CERT_SELECTION 委托范围，则此字段必须为空。
alwaysOnVpnPackage

object (AlwaysOnVpnPackage)

始终开启的 VPN 连接的配置。与 vpnConfigDisabled 搭配使用可防止修改此设置。
frpAdminEmails[]

string

用于恢复出厂设置保护机制的设备管理员的电子邮件地址。当设备恢复出厂设置后，需要其中一位管理员使用 Google 账号电子邮件地址和密码登录才能解锁设备。如果未指定任何管理员，设备将不会提供恢复出厂设置保护。
deviceOwnerLockScreenInfo

object (UserFacingMessage)

要在锁定屏幕上显示的设备所有者信息。
dataRoamingDisabled

boolean

漫游数据服务是否已停用。
locationMode

enum (LocationMode)

已启用的位置信息检测程度。
networkEscapeHatchEnabled

boolean

网络逃生舱是否已启用。如果在启动时无法建立网络连接，逃生出口会提示用户暂时连接到网络，以便刷新设备政策。应用政策后，系统会忘记临时网络，设备将继续启动。这样可防止出现以下情况：如果上一个政策中没有合适的网络，并且设备以锁定任务模式启动到某个应用，或者用户无法访问设备设置，则无法连接到网络。

注意：在特定情况下，将 wifiConfigDisabled 设置为 true 会覆盖此设置。如需了解详情，请参阅 wifiConfigDisabled。在特定情况下，将 configureWifi 设置为 DISALLOW_CONFIGURING_WIFI 会替换此设置。如需了解详情，请参阅 DISALLOW_CONFIGURING_WIFI。
bluetoothDisabled

boolean

蓝牙是否已停用。我们建议您优先使用此设置，而不是 bluetoothConfigDisabled，因为用户可以绕过 bluetoothConfigDisabled。
complianceRules[]
(deprecated)

object (ComplianceRule)

用于声明当设备不符合其政策时应采取哪些缓解措施的规则。如果满足多条规则的条件，系统会采取相应规则的所有缓解措施。规则数量上限为 100 条。请改用政策强制执行规则。
blockApplicationsEnabled
(deprecated)

boolean

是否禁止安装 applications 中配置的应用以外的应用。如果设置了此政策，系统会自动卸载根据先前政策安装但不再出现在该政策中的应用。
installUnknownSourcesAllowed
(deprecated)

boolean

此字段无效。
debuggingFeaturesAllowed
(deprecated)

boolean

用户是否可以启用调试功能。
funDisabled

boolean

用户是否可以玩乐。控制是否停用“设置”中的彩蛋游戏。
autoTimeRequired
(deprecated)

boolean

是否需要自动设置时间，如果需要，则禁止用户手动设置日期和时间。如果设置了 autoDateAndTimeZone，则此字段会被忽略。
permittedAccessibilityServices

object (PackageNameList)

指定允许的无障碍服务。如果未设置该字段，则可以使用任何无障碍服务。如果设置了该字段，则只能使用此列表中的辅助服务和系统的内置辅助服务。特别是，如果该字段设置为空，则只能使用系统的内置无障碍服务。此设置可在完全受管设备和工作资料中进行。如果将此设置应用于工作资料，则会同时影响个人资料和工作资料。
appAutoUpdatePolicy

enum (AppAutoUpdatePolicy)

建议的替代方案：autoUpdateMode，此设置是按应用设置的，可更灵活地控制更新频率。

如果 autoUpdateMode 设置为 AUTO_UPDATE_POSTPONED 或 AUTO_UPDATE_HIGH_PRIORITY，此字段将不起作用。

应用自动更新政策，用于控制何时可以应用自动应用更新。
kioskCustomLauncherEnabled

boolean

信息亭自定义启动器是否已启用。这会将主屏幕替换为启动器，该启动器会将设备锁定为通过 applications 设置安装的应用。应用会按字母顺序显示在单个页面上。使用 kioskCustomization 进一步配置自助服务终端设备行为。
androidDevicePolicyTracks[]
(deprecated)

enum (AppTrack)

不支持此设置。系统会忽略任何值。
skipFirstUseHintsEnabled

boolean

用于在首次使用时跳过提示的标志。企业管理员可以启用应用系统推荐功能，以便用户在首次启动时跳过用户教程和其他入门提示。
privateKeySelectionEnabled

boolean

允许在设备上显示界面，以便用户在 ChoosePrivateKeyRules 中没有匹配规则时选择私钥别名。对于低于 Android P 的设备，设置此标志可能会使企业密钥容易受到攻击。如果任何应用具有 CERT_SELECTION 委托范围，此值将不起作用。
encryptionPolicy

enum (EncryptionPolicy)

是否已启用加密
usbMassStorageEnabled
(deprecated)

boolean

是否启用了 USB 存储设备。已弃用。
permissionGrants[]

object (PermissionGrant)

针对所有应用的明确权限或群组授予/拒绝。这些值会替换 defaultPermissionPolicy。
playStoreMode

enum (PlayStoreMode)

此模式用于控制 Play 商店中可供用户使用的应用，以及从政策中移除应用时设备上的行为。
setupActions[]

object (SetupAction)

在设置过程中需要采取的操作。最多只能指定一项操作。
passwordPolicies[]

object (PasswordRequirements)

密码要求政策。通过在政策中设置 passwordScope 字段，可以为工作资料或完全受管设备设置不同的政策。
policyEnforcementRules[]

object (PolicyEnforcementRule)

用于定义特定政策无法应用于设备时的行为的规则
kioskCustomization

object (KioskCustomization)

用于控制设备在自助服务终端模式下的行为的设置。如需启用自助服务终端模式，请将 kioskCustomLauncherEnabled 设置为 true，或在政策中指定应用并使用 installType KIOSK。
advancedSecurityOverrides

object (AdvancedSecurityOverrides)

高级安全设置。在大多数情况下，无需设置这些属性。
personalUsagePolicies

object (PersonalUsagePolicies)

用于管理公司自有设备上的个人使用情况的政策。
autoDateAndTimeZone

enum (AutoDateAndTimeZone)

公司自有设备上是否启用了自动确定日期、时间和时区功能。如果设置了此值，则会忽略 autoTimeRequired。
oncCertificateProviders[]

object (OncCertificateProvider)

此功能尚未正式发布。
crossProfilePolicies

object (CrossProfilePolicies)

设备上应用的跨个人资料政策。
preferentialNetworkService

enum (PreferentialNetworkService)

控制是否在工作资料或完全受管理的设备上启用优先网络服务。例如，某组织可能与运营商达成协议，规定其员工设备中的所有工作数据都将通过专供企业使用的网络服务发送。受支持的优先网络服务的一个示例是 5G 网络上的企业切片。如果搭载 Android 13 或更高版本的设备上设置了 preferentialNetworkServiceSettings 或 ApplicationPolicy.preferentialNetworkId，此政策将不会产生任何影响。
usageLog

object (UsageLog)

设备活动日志记录的配置。
cameraAccess

enum (CameraAccess)

控制相机的使用情况以及用户是否可以访问相机访问权限切换开关。
microphoneAccess

enum (MicrophoneAccess)

控制麦克风的使用，以及用户是否可以访问麦克风使用权切换开关。此设置仅适用于全代管式设备。
deviceConnectivityManagement

object (DeviceConnectivityManagement)

涵盖设备连接的控制，例如 Wi-Fi、USB 数据访问、键盘/鼠标连接等。
deviceRadioState

object (DeviceRadioState)

涵盖了无线状态（例如 Wi-Fi、蓝牙等）的控制。
credentialProviderPolicyDefault

enum (CredentialProviderPolicyDefault)

控制哪些应用可以在 Android 14 及更高版本上充当凭据提供程序。这些应用会存储凭据，如需了解详情，请参阅这篇文章和这篇文章。另请参阅 credentialProviderPolicy。
printingPolicy

enum (PrintingPolicy)

可选。控制是否允许打印。搭载 Android 9 及更高版本的设备支持此功能。。
displaySettings

object (DisplaySettings)

可选。显示设置的控件。
assistContentPolicy

enum (AssistContentPolicy)

可选。控制是否允许将 AssistContent 发送到特权应用（例如辅助应用）。AssistContent 包括屏幕截图和有关应用的信息（例如软件包名称）。Android 15 及更高版本支持此功能。
workAccountSetupConfig

object (WorkAccountSetupConfig)

可选。控制工作账号设置配置，例如是否需要经过 Google 身份验证的账号。
wipeDataFlags[]

enum (WipeDataFlag)

可选。擦除标志，用于指示因任何原因（例如不合规）触发设备或个人资料擦除时，系统会擦除哪些数据。此属性不适用于 enterprises.devices.delete 方法。。此列表不得包含重复项。
enterpriseDisplayNameVisibility

enum (EnterpriseDisplayNameVisibility)

可选。控制 enterpriseDisplayName 是否在设备上显示（例如公司自有设备上的锁定屏幕消息）。
appFunctions

enum (AppFunctions)

可选。控制是否允许完全受管理的设备上的应用或具有工作资料的设备上的工作资料中的应用公开应用功能。

ApplicationPolicy

针对单个应用的政策。注意：如果 installAppsDisabled 已启用，则无法使用此政策更改特定设备上的应用可用性。您可为每项政策指定最多 3,000 个应用。

JSON 表示法 
{
  "packageName": string,
  "installType": enum (InstallType),
  "lockTaskAllowed": boolean,
  "defaultPermissionPolicy": enum (PermissionPolicy),
  "permissionGrants": [
    {
      object (PermissionGrant)
    }
  ],
  "managedConfiguration": {
    object
  },
  "disabled": boolean,
  "minimumVersionCode": integer,
  "delegatedScopes": [
    enum (DelegatedScope)
  ],
  "managedConfigurationTemplate": {
    object (ManagedConfigurationTemplate)
  },
  "accessibleTrackIds": [
    string
  ],
  "connectedWorkAndPersonalApp": enum (ConnectedWorkAndPersonalApp),
  "autoUpdateMode": enum (AutoUpdateMode),
  "extensionConfig": {
    object (ExtensionConfig)
  },
  "alwaysOnVpnLockdownExemption": enum (AlwaysOnVpnLockdownExemption),
  "workProfileWidgets": enum (WorkProfileWidgets),
  "credentialProviderPolicy": enum (CredentialProviderPolicy),
  "installConstraint": [
    {
      object (InstallConstraint)
    }
  ],
  "installPriority": integer,
  "userControlSettings": enum (UserControlSettings),
  "preferentialNetworkId": enum (PreferentialNetworkId)
}
字段
packageName

string

应用的软件包名称。例如，YouTube 应用的软件包名称为 com.google.android.youtube。
installType

enum (InstallType)

要执行的安装类型。
lockTaskAllowed
(deprecated)

boolean

应用是否可以锁定为全屏模式。已弃用。使用 InstallType KIOSK 或 kioskCustomLauncherEnabled 配置专用设备。
defaultPermissionPolicy

enum (PermissionPolicy)

应用请求的所有权限的默认政策。如果指定，此值会覆盖适用于所有应用的政策级 defaultPermissionPolicy。它不会替换适用于所有应用的 permissionGrants。
permissionGrants[]

object (PermissionGrant)

针对应用的显式权限授予或拒绝。这些值会替换适用于所有应用的 defaultPermissionPolicy 和 permissionGrants。
managedConfiguration

object (Struct format)

应用于应用的受管配置。配置的格式由应用支持的 ManagedProperty 值决定。受管配置中的每个字段名称都必须与 ManagedProperty 的 key 字段匹配。字段值必须与 ManagedProperty 的 type 兼容：

typeJSON 值
BOOLtrue 或 false
STRING字符串
INTEGER数值
CHOICE字符串
MULTISELECT字符串数组
HIDDEN字符串
BUNDLE_ARRAY对象数组
disabled

boolean

应用是否已停用。停用后，应用数据仍会保留。
minimumVersionCode

integer

设备上运行的应用的最低版本。如果设置了此值，设备会尝试将应用更新到至少此版本号。如果应用不是最新状态，设备将包含一个 NonComplianceDetail，并将 nonComplianceReason 设置为 APP_NOT_UPDATED。应用必须已发布到 Google Play，且版本代码大于或等于此值。每项政策最多可指定 20 个应用的最低版本代码。
delegatedScopes[]

enum (DelegatedScope)

从 Android Device Policy 委托给应用的范围。这些权限可为应用提供额外的特权。
managedConfigurationTemplate

object (ManagedConfigurationTemplate)

应用的托管配置模板，从托管配置 iframe 中保存。如果设置了 managedConfiguration，则此字段将被忽略。
accessibleTrackIds[]

string

企业所属设备可访问的应用轨道 ID 列表。如果该列表包含多个轨道 ID，设备会接收所有可访问轨道中的最新版本。如果该列表不包含任何轨道 ID，设备只能访问应用的正式版轨道。如需详细了解每个轨道，请参阅 AppTrackInfo。
connectedWorkAndPersonalApp

enum (ConnectedWorkAndPersonalApp)

控制应用是否可以在设备的工作资料和个人资料之间相互通信，但需征得用户同意。
autoUpdateMode

enum (AutoUpdateMode)

控制应用的自动更新模式。
extensionConfig

object (ExtensionConfig)

配置，用于将此应用作为扩展应用启用，并具备离线与 Android 设备政策互动的能力。

此字段最多只能为一个应用设置。

设备上应用的签名密钥证书指纹必须与 signingKeyFingerprintsSha256 中的某个条目相匹配，或者与从 Play 商店获取的签名密钥证书指纹相匹配，这样应用才能与 Android Device Policy 通信。如果应用不在 Play 商店中，且未设置 signingKeyFingerprintsSha256，则会报告包含 INVALID_VALUE 的 NonComplianceDetail。
alwaysOnVpnLockdownExemption

enum (AlwaysOnVpnLockdownExemption)

指定在未连接 VPN 且 alwaysOnVpnPackage.lockdownEnabled 处于启用状态时，是否允许应用联网。如果设置为 VPN_LOCKDOWN_ENFORCED，则不允许应用联网；如果设置为 VPN_LOCKDOWN_EXEMPTION，则允许应用联网。仅在搭载 Android 10 及更高版本的设备上受支持。如果设备不支持此功能，则设备将包含一个 NonComplianceDetail，其中 nonComplianceReason 设置为 API_LEVEL，并包含一个 fieldPath。如果此设置不适用于相应应用，设备将包含一个 NonComplianceDetail，其中 nonComplianceReason 设置为 UNSUPPORTED，并包含一个 fieldPath。fieldPath 设置为 applications[i].alwaysOnVpnLockdownExemption，其中 i 是 applications 政策中软件包的索引。
workProfileWidgets

enum (WorkProfileWidgets)

指定工作资料中安装的应用是否可以向主屏幕添加 widget。
credentialProviderPolicy

enum (CredentialProviderPolicy)

可选。应用是否可以在 Android 14 及更高版本上充当凭据提供程序。
installConstraint[]

object (InstallConstraint)

可选。安装应用的限制条件。您最多可以指定一个 InstallConstraint。多个限制条件被拒绝。
installPriority

integer

可选。在将 installType 设置为以下值的应用中：

此属性用于控制安装的相对优先级。值为 0（默认值）表示此应用不比其他应用具有更高的优先级。对于介于 1 到 10,000 之间的值，值越小，优先级越高。超出 0 到 10,000（含）范围的值将被拒绝。
userControlSettings

enum (UserControlSettings)

可选。指定是否允许用户控制应用。用户控制包括强行停止和清除应用数据等用户操作。某些类型的应用会受到特殊处理，详情请参阅 USER_CONTROL_SETTINGS_UNSPECIFIED 和 USER_CONTROL_ALLOWED。
preferentialNetworkId

enum (PreferentialNetworkId)

可选。应用使用的优先网络的 ID。preferentialNetworkServiceConfigs 中必须存在指定网络 ID 的配置。如果设置为 PREFERENTIAL_NETWORK_ID_UNSPECIFIED，应用将使用 defaultPreferentialNetworkId 中指定的默认网络 ID。如需查看不采用此默认设置的应用列表，请参阅 defaultPreferentialNetworkId 的文档。此方法适用于 Android 13 及更高版本上的工作资料和完全受管设备。

InstallType

要为应用执行的安装类型。如果 setupAction 引用了某个应用，则该应用必须将 installType 设置为 REQUIRED_FOR_SETUP，否则设置将失败。

枚举
INSTALL_TYPE_UNSPECIFIED 未指定。默认值为 AVAILABLE。
PREINSTALLED 应用会自动安装，但用户可以移除它。
FORCE_INSTALLED 无论设置的维护窗口如何，应用都会自动安装，并且用户无法将其移除。
BLOCKED 该应用已被屏蔽，无法安装。如果已根据先前的政策安装了该应用，系统会卸载它。这也会阻止其免安装应用功能。
AVAILABLE 该应用可供安装。
REQUIRED_FOR_SETUP 该应用会自动安装，用户无法将其移除，并且在安装完成之前，设置将无法完成。
KIOSK 应用在自助服务终端模式下会自动安装：它会被设置为首选主屏幕 intent，并列入锁定任务模式的许可名单。在安装该应用之前，设备设置将无法完成。安装后，用户将无法移除该应用。每项政策只能为一款应用设置此 installType。如果政策中包含此项，状态栏将自动停用。

PermissionPolicy

此政策用于向应用授予所请求的权限。

枚举
PERMISSION_POLICY_UNSPECIFIED 未指定政策。如果在任何等级都未针对相应权限指定政策，系统便会默认使用 PROMPT 行为。
PROMPT 提示用户授予相应权限。
GRANT

自动授予权限。

在 Android 12 及更高版本中，READ_SMS 和以下与传感器相关的权限只能在完全受管理设备上授予：
DENY 自动拒绝授予相应权限。

PermissionGrant

Android 权限及其授予状态的配置。

JSON 表示法 
{
  "permission": string,
  "policy": enum (PermissionPolicy)
}
字段
permission

string

Android 权限或群组，例如 android.permission.READ_CALENDAR 或 android.permission_group.CALENDAR。
policy

enum (PermissionPolicy)

授予权限的政策。

DelegatedScope

另一个软件包可从 Android 设备政策中获取的委托范围。这些权限可为应用提供额外的特权。

枚举
DELEGATED_SCOPE_UNSPECIFIED 未指定委托范围。
CERT_INSTALL 授予证书安装和管理权限。此范围可以委托给多个应用。
MANAGED_CONFIGURATIONS 授予对受管理的配置的管理权限。此范围可以委托给多个应用。
BLOCK_UNINSTALL 授予阻止卸载的权限。此范围可以委托给多个应用。
PERMISSION_GRANT 授予对权限政策和权限授予状态的访问权限。此范围可以委托给多个应用。
PACKAGE_ACCESS 授予对软件包访问状态的访问权限。此范围可以委托给多个应用。
ENABLE_SYSTEM_APP 授予启用系统应用的访问权限。此范围可以委托给多个应用。
NETWORK_ACTIVITY_LOGS 授予对网络活动日志的访问权限。允许委托应用调用 setNetworkLoggingEnabled、isNetworkLoggingEnabled 和 retrieveNetworkLogs 方法。此范围最多可委托给一个应用。适用于搭载 Android 10 及更高版本的完全受管设备。Android 12 及更高版本支持工作资料。如果支持并设置了委托，系统会忽略 NETWORK_ACTIVITY_LOGS。
SECURITY_LOGS 授予对安全日志的访问权限。允许委托的应用调用 setSecurityLoggingEnabled、isSecurityLoggingEnabled、retrieveSecurityLogs 和 retrievePreRebootSecurityLogs 方法。此范围最多可委托给一个应用。适用于搭载 Android 12 及更高版本的全托管式设备和设有工作资料的公司自有设备。如果支持并设置了委托，系统会忽略 SECURITY_LOGS。
CERT_SELECTION 代表请求应用授予对 KeyChain 证书的选择权限。获得授权后，委托的应用将开始接收 DelegatedAdminReceiver#onChoosePrivateKeyAlias。允许委托应用调用 grantKeyPairToApp 和 revokeKeyPairFromApp 方法。此范围最多可委托给一个应用。如果证书选择委托给应用，则 choosePrivateKeyRules 必须为空，并且 privateKeySelectionEnabled 不起作用。

ManagedConfigurationTemplate

应用的托管配置模板，从托管配置 iframe 中保存。

JSON 表示法 
{
  "templateId": string,
  "configurationVariables": {
    string: string,
    ...
  }
}
字段
templateId

string

受管理的配置模板的 ID。
configurationVariables

map (key: string, value: string)

可选，一个包含为配置定义的 <键，值> 配置变量的映射。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。

ConnectedWorkAndPersonalApp

控制应用是否可以在不同个人资料之间进行通信，但需征得用户同意。

枚举
CONNECTED_WORK_AND_PERSONAL_APP_UNSPECIFIED 未指定。默认值为 CONNECTED_WORK_AND_PERSONAL_APPS_DISALLOWED。
CONNECTED_WORK_AND_PERSONAL_APP_DISALLOWED 默认值。防止应用跨资料进行通信。
CONNECTED_WORK_AND_PERSONAL_APP_ALLOWED 允许应用在征得用户同意后跨个人资料进行通信。

AutoUpdateMode

控制应用的自动更新模式。如果设备用户手动更改设备设置，AutoUpdateMode 会忽略这些选择，因为它的优先级更高。

枚举
AUTO_UPDATE_MODE_UNSPECIFIED 未指定。默认为 AUTO_UPDATE_DEFAULT。
AUTO_UPDATE_DEFAULT

默认更新模式。

应用会自动更新，但优先级较低，以最大限度地减少对用户的影响。

当满足以下所有限制条件时，应用会更新：

  • 设备未被积极使用。
  • 设备已连接到不按流量计费的网络。
  • 设备正在充电。
  • 要更新的应用未在前台运行。

开发者发布新更新后，设备会在 24 小时内收到通知，之后，当满足上述限制条件时，应用便会更新。
AUTO_UPDATE_POSTPONED

应用过期后，系统最多不会自动更新应用 90 天。

应用过时 90 天后，系统会自动安装最新可用版本，但优先级较低（请参阅 AUTO_UPDATE_DEFAULT）。应用更新后，只有在再次过时 90 天后，系统才会再次自动更新。

用户仍可随时从 Play 商店手动更新应用。
AUTO_UPDATE_HIGH_PRIORITY

应用会尽快更新。未应用任何限制。

新更新可用后，设备会尽快收到通知。

注意：在整个 Android 生态系统中大规模部署的应用的更新可能需要长达 24 小时。

ExtensionConfig

用于将应用配置为扩展应用，使其能够离线与 Android Device Policy 进行交互。对于 Android 版本 11 及更高版本，扩展应用不受电池限制，因此不会被放入受限的应用待机模式存储分区。扩展应用还可防止用户清除其数据或强行关闭应用，不过，如果需要，管理员可以继续在 Android 11 及更高版本的扩展应用上使用 clear app data command。

JSON 表示法 
{
  "signingKeyFingerprintsSha256": [
    string
  ],
  "notificationReceiver": string
}
字段
signingKeyFingerprintsSha256[]

string

扩展应用签名密钥证书的十六进制编码 SHA-256 哈希值。只有 64 个字符的十六进制字符串表示形式有效。

签名密钥证书指纹始终从 Play 商店获取，此字段用于提供额外的签名密钥证书指纹。不过，如果应用未在 Play 商店中发布，则需要设置此字段。如果应用在 Play 商店中不可用，但未设置此字段，则会报告 INVALID_VALUE 的 NonComplianceDetail。

设备上扩展应用所用签名密钥证书的指纹必须与从 Play 商店获取的签名密钥证书指纹之一相符，或者与此字段中提供的指纹之一相符，这样应用才能与 Android 设备政策进行通信。

在生产用例中，建议将此字段留空。
notificationReceiver

string

接收器服务类的完全限定类名称，用于让 Android Device Policy 向扩展应用通知任何本地命令状态更新。该服务必须在扩展应用中导出，并扩展 NotificationReceiverService（如需了解详情，请参阅与 AMAPI SDK 集成指南）。AndroidManifest.xml

AlwaysOnVpnLockdownExemption

控制应用是否不受 alwaysOnVpnPackage.lockdownEnabled 设置的限制。

枚举
ALWAYS_ON_VPN_LOCKDOWN_EXEMPTION_UNSPECIFIED 未指定。默认为 VPN_LOCKDOWN_ENFORCED。
VPN_LOCKDOWN_ENFORCED 应用会遵守“始终开启的 VPN”锁定设置。
VPN_LOCKDOWN_EXEMPTION 相应应用不受“始终开启的 VPN”锁定设置的限制。

WorkProfileWidgets

控制是否允许工作资料应用向主屏幕添加 widget。

枚举
WORK_PROFILE_WIDGETS_UNSPECIFIED 未指定。默认设置为 workProfileWidgetsDefault
WORK_PROFILE_WIDGETS_ALLOWED 允许使用工作资料 widget。这意味着应用将能够向主屏幕添加 widget。
WORK_PROFILE_WIDGETS_DISALLOWED 不允许使用工作资料 widget。这意味着应用将无法向主屏幕添加 widget。

CredentialProviderPolicy

应用是否可以在 Android 14 及更高版本上充当凭据提供程序。

枚举
CREDENTIAL_PROVIDER_POLICY_UNSPECIFIED 未指定。此行为受 credentialProviderPolicyDefault 的约束。
CREDENTIAL_PROVIDER_ALLOWED 允许应用充当凭据提供方。

InstallConstraint

在将 InstallType 设置为以下值的应用中：

这会为应用安装定义一组限制。必须设置至少一个字段。如果设置了多个字段，则必须满足所有限制条件，应用才能安装。

JSON 表示法 
{
  "networkTypeConstraint": enum (NetworkTypeConstraint),
  "chargingConstraint": enum (ChargingConstraint),
  "deviceIdleConstraint": enum (DeviceIdleConstraint)
}
字段
networkTypeConstraint

enum (NetworkTypeConstraint)

可选。网络类型限制。
chargingConstraint

enum (ChargingConstraint)

可选。充电限制。
deviceIdleConstraint

enum (DeviceIdleConstraint)

可选。设备空闲状态限制。

NetworkTypeConstraint

网络类型限制。

枚举
NETWORK_TYPE_CONSTRAINT_UNSPECIFIED 未指定。默认为 INSTALL_ON_ANY_NETWORK。
INSTALL_ON_ANY_NETWORK 任何有效网络（WLAN、移动数据网络等）。
INSTALL_ONLY_ON_UNMETERED_NETWORK 任何不按流量计费的网络（例如 Wi-Fi）。

ChargingConstraint

充电限制。

枚举
CHARGING_CONSTRAINT_UNSPECIFIED 未指定。默认为 CHARGING_NOT_REQUIRED。
CHARGING_NOT_REQUIRED 设备不必处于充电状态。
INSTALL_ONLY_WHEN_CHARGING 设备必须正在充电。

DeviceIdleConstraint

设备空闲状态限制。

枚举
DEVICE_IDLE_CONSTRAINT_UNSPECIFIED 未指定。默认为 DEVICE_IDLE_NOT_REQUIRED。
DEVICE_IDLE_NOT_REQUIRED 设备不必处于空闲状态，可以在用户与设备互动时安装应用。
INSTALL_ONLY_WHEN_DEVICE_IDLE 设备必须处于闲置状态。

UserControlSettings

指定是否允许用户控制给定的应用。用户控制包括强行停止和清除应用数据等用户操作。

枚举
USER_CONTROL_SETTINGS_UNSPECIFIED

使用应用的默认行为来确定是否允许用户控件。默认情况下，大多数应用都允许用户控制，但以下类型的应用除外：

  • 扩展应用（如需了解详情，请参阅 extensionConfig）
  • 自助服务终端应用（如需了解详情，请参阅 KIOSK 安装类型）
  • 其他关键系统应用
USER_CONTROL_ALLOWED 允许用户控制应用。自助服务终端应用可以使用此标志来允许用户控制。对于扩展应用（如需了解详情，请参阅 extensionConfig），即使设置了此值，也不允许用户控制。对于自助服务终端应用（如需了解详情，请参阅 KIOSK 安装类型），此值可用于允许用户控制。
USER_CONTROL_DISALLOWED 不允许用户控制应用。此功能在 Android 11 及更高版本中受支持。如果 Android 版本低于 11，则会报告带有 API_LEVEL 的 NonComplianceDetail。

PreferentialNetworkId

优先网络标识符。

枚举
PREFERENTIAL_NETWORK_ID_UNSPECIFIED 此值是否有效以及其含义取决于使用位置，相关字段中对此进行了说明。
NO_PREFERENTIAL_NETWORK 应用不使用任何优先网络。
PREFERENTIAL_NETWORK_ID_ONE 优先网络标识符 1。
PREFERENTIAL_NETWORK_ID_TWO 优先网络标识符 2。
PREFERENTIAL_NETWORK_ID_THREE 优先网络标识符 3。
PREFERENTIAL_NETWORK_ID_FOUR 优先网络标识符 4。
PREFERENTIAL_NETWORK_ID_FIVE 优先网络标识符 5。

KeyguardDisabledFeature

可停用的 Keyguard（锁屏）功能。

枚举
KEYGUARD_DISABLED_FEATURE_UNSPECIFIED 此值会被忽略。
CAMERA 在安全锁屏界面（例如 PIN 码）上停用摄像头。
NOTIFICATIONS 停用在安全锁屏界面上显示所有通知的功能。
UNREDACTED_NOTIFICATIONS 在安全锁屏界面上停用未经过编辑的通知。
TRUST_AGENTS 忽略安全 Keyguard 屏幕上的可信代理状态。
DISABLE_FINGERPRINT 在安全锁屏界面上停用指纹传感器。
DISABLE_REMOTE_INPUT 在搭载 Android 6 及更低版本的设备上，禁止在安全锁屏界面上输入通知文本。对 Android 7 及更高版本没有影响。
FACE 在安全 Keyguard 屏幕上停用人脸识别身份验证。
IRIS 在安全 Keyguard 屏幕上停用虹膜身份验证。
BIOMETRICS 在安全 Keyguard 屏幕上停用所有生物识别身份验证。
SHORTCUTS 在 Android 14 及更高版本的安全锁屏界面上停用所有快捷方式。
ALL_FEATURES 停用当前和未来的所有锁屏自定义设置。

PersistentPreferredActivity

用于处理与特定 intent 过滤器匹配的 intent 的默认 activity。注意：如需设置信息亭，请将 InstallType 设置为 KIOSK，而不是使用持久的首选 activity。

JSON 表示法 
{
  "receiverActivity": string,
  "actions": [
    string
  ],
  "categories": [
    string
  ]
}
字段
receiverActivity

string

应作为默认 intent 处理程序的 activity。这应为 Android 组件名称，例如 com.android.enterprise.app/.MainActivity。或者，该值也可以是应用的软件包名称，这会导致 Android 设备政策从应用中选择合适的 activity 来处理 intent。
actions[]

string

要在过滤器中匹配的 intent 操作。如果过滤条件中包含任何操作，则 intent 的操作必须是这些值之一，才能匹配。如果未包含任何操作，则忽略 intent 操作。
categories[]

string

要在过滤器中匹配的 intent 类别。intent 包含其所需的所有类别，所有这些类别都必须包含在过滤器中才能匹配。换句话说，除非 intent 中指定了某个类别，否则向过滤器添加该类别不会对匹配产生任何影响。

SystemUpdate

用于管理系统更新的配置

注意： Google Play 系统更新（也称为 Mainline 更新）会自动下载，但需要重新启动设备才能安装。如需了解详情，请参阅管理系统更新中的 Mainline 部分。

JSON 表示法 
{
  "type": enum (SystemUpdateType),
  "startMinutes": integer,
  "endMinutes": integer,
  "freezePeriods": [
    {
      object (FreezePeriod)
    }
  ]
}
字段
type

enum (SystemUpdateType)

要配置的系统更新类型。
startMinutes

integer

如果类型为 WINDOWED，则表示维护窗口的开始时间，以设备本地时间午夜后的分钟数来衡量。此值必须介于 0 到 1439 之间（含首尾）。
endMinutes

integer

如果类型为 WINDOWED，则表示维护窗口的结束时间，以设备本地时间午夜后的分钟数来衡量。此值必须介于 0 到 1439 之间（含首尾）。如果此值小于 startMinutes，则维护窗口会跨越午夜。如果指定的维护窗口小于 30 分钟，则实际窗口会延长到开始时间后的 30 分钟。
freezePeriods[]

object (FreezePeriod)

每年重复出现的时间段，在此期间，无线下载 (OTA) 系统更新会被推迟，以冻结设备上运行的操作系统版本。为防止设备无限期冻结，每次冻结期之间必须间隔至少 60 天。

SystemUpdateType

系统更新配置的类型。

枚举
SYSTEM_UPDATE_TYPE_UNSPECIFIED 遵循设备的默认更新行为，该行为通常要求用户接受系统更新。
AUTOMATIC 有可用更新时立即自动安装。
WINDOWED

在每日维护时段内自动安装。这还会配置在窗口内更新 Play 应用。对于自助服务终端设备，强烈建议使用此方法，因为这是 Play 更新持续固定到前台的应用的唯一方式。

如果应用的 autoUpdateMode 设置为 AUTO_UPDATE_HIGH_PRIORITY，则系统会忽略该应用的维护窗口，并尽快更新该应用，即使在维护窗口之外也是如此。
POSTPONE 最多可将自动安装推迟 30 天。此政策不会影响安全更新（例如每月安全补丁）。

FreezePeriod

系统冻结期。当设备的时钟处于冻结时段内时，所有传入的系统更新（包括安全补丁）都会被阻止，并且不会安装。

当设备不在任何设定的冻结期内时，系统会应用正常政策行为（自动、窗口化或推迟）。

在计算冻结期时，系统会忽略闰年，具体而言：

  • 如果将 2 月 29 日设置为冻结期的开始日期或结束日期，则冻结期将改为在 2 月 28 日开始或结束。
  • 当设备的系统时钟显示 2 月 29 日时，系统会将其视为 2 月 28 日。
  • 在计算冻结期天数或两个冻结期之间的时间时，系统会忽略 2 月 29 日，不会将其计为一天。

注意：如需使冻结期生效，SystemUpdateType 不得指定为 SYSTEM_UPDATE_TYPE_UNSPECIFIED，因为冻结期需要指定已定义的政策。

JSON 表示法 
{
  "startDate": {
    object (Date)
  },
  "endDate": {
    object (Date)
  }
}
字段
startDate

object (Date)

冻结期的开始日期（含）。注意：必须设置 day 和 month。不应设置 year，因为该属性不会被使用。例如 {"month": 1,"date": 30}。
endDate

object (Date)

冻结期的结束日期（含此日期）。不得晚于开始日期后的 90 天。如果结束日期早于开始日期，则冻结期被视为跨年。注意：必须设置 day 和 month。不应设置 year，因为该属性不会被使用。例如 {"month": 1,"date": 30}。

日期

表示整个或部分日历日期（例如生日）。一天中的时间和时区要么在别处指定，要么不重要。日期相对于公历。可以表示以下任一情况：

  • 包含非零年份、月份和天值的完整日期。
  • 月份和天，年份值为零（例如周年纪念日）。
  • 单独的年份，月份和天值为零。
  • 年份和月份，天值为零（例如，信用卡到期日期）。

相关类型：

JSON 表示法 
{
  "year": integer,
  "month": integer,
  "day": integer
}
字段
year

integer

日期中的年份。必须介于 1 到 9999 之间，或为 0（即指定不含年份的日期）。
month

integer

一年中的第几个月。必须介于 1 到 12 之间，或为 0（即只指定年份，不指定月份和天值）。
day

integer

一个月中的第几天。必须介于 1 到 31 之间并且对年份和月份有效，或为 0（即天不重要，指定单独的年份或者年份和月份）。

StatusReportingSettings

控制状态报告行为的设置。

JSON 表示法 
{
  "applicationReportsEnabled": boolean,
  "deviceSettingsEnabled": boolean,
  "softwareInfoEnabled": boolean,
  "memoryInfoEnabled": boolean,
  "networkInfoEnabled": boolean,
  "displayInfoEnabled": boolean,
  "powerManagementEventsEnabled": boolean,
  "hardwareStatusEnabled": boolean,
  "systemPropertiesEnabled": boolean,
  "applicationReportingSettings": {
    object (ApplicationReportingSettings)
  },
  "commonCriteriaModeEnabled": boolean
}
字段
applicationReportsEnabled

boolean

是否启用了应用报告。
deviceSettingsEnabled

boolean

是否已启用设备设置报告。
softwareInfoEnabled

boolean

是否已启用软件信息报告。
memoryInfoEnabled

boolean

是否启用了内存事件报告。
networkInfoEnabled

boolean

是否启用了网络信息报告。
displayInfoEnabled

boolean

是否启用了展示报告。报告数据不适用于设置了工作资料的个人自有设备。
powerManagementEventsEnabled

boolean

是否启用了电源管理事件报告。报告数据不适用于设置了工作资料的个人自有设备。
hardwareStatusEnabled

boolean

是否启用硬件状态报告。报告数据不适用于设置了工作资料的个人自有设备。
systemPropertiesEnabled

boolean

是否启用了系统属性报告。
applicationReportingSettings

object (ApplicationReportingSettings)

应用报告设置。仅在 applicationReportsEnabled 为 true 时适用。
commonCriteriaModeEnabled

boolean

是否启用了 Common Criteria Mode 报告。只有公司自有设备支持此功能。

ApplicationReportingSettings

用于控制应用报告行为的设置。

JSON 表示法 
{
  "includeRemovedApps": boolean
}
字段
includeRemovedApps

boolean

是否在应用报告中包含已移除的应用。

PackageNameList

软件包名称列表。

JSON 表示法 
{
  "packageNames": [
    string
  ]
}
字段
packageNames[]

string

软件包名称列表。

BatteryPluggedMode

插入电池时的模式。

枚举
BATTERY_PLUGGED_MODE_UNSPECIFIED 此值会被忽略。
AC 电源是交流充电器。
USB 电源是 USB 端口。
WIRELESS 电源为无线。

ProxyInfo

HTTP 代理的配置信息。对于直接代理，请设置 host、port 和 excludedHosts 字段。对于 PAC 脚本代理，请设置 pacUri 字段。

JSON 表示法 
{
  "host": string,
  "port": integer,
  "excludedHosts": [
    string
  ],
  "pacUri": string
}
字段
host

string

直接代理的主机。
port

integer

直接代理的端口。
excludedHosts[]

string

对于直接代理，绕过代理的主机。主机名可以包含通配符，例如 *.example.com。
pacUri

string

用于配置代理的 PAC 脚本的 URI。

ChoosePrivateKeyRule

控制应用对私钥的访问权限。该规则用于确定 Android 设备政策向指定应用授予哪个私钥（如果有）。当应用调用 KeyChain.choosePrivateKeyAlias（或任何重载）来请求给定网址的私钥别名时，或者对于非特定于网址的规则（即，如果 urlPattern 未设置或设置为空字符串或 .*），在 Android 11 及更高版本上，直接授予访问权限，以便应用可以直接调用 KeyChain.getPrivateKey，而不必先调用 KeyChain.choosePrivateKeyAlias。

当应用调用 KeyChain.choosePrivateKeyAlias 时，如果有多个 choosePrivateKeyRules 匹配项，则最后一个匹配规则会定义要返回的密钥别名。

JSON 表示法 
{
  "urlPattern": string,
  "packageNames": [
    string
  ],
  "privateKeyAlias": string
}
字段
urlPattern

string

要与请求的网址进行匹配的网址格式。如果未设置或为空，则匹配所有网址。此字段使用 java.util.regex.Pattern 的正则表达式语法。
packageNames[]

string

此规则所适用的软件包名称。系统会根据 Play 提供的哈希验证每个应用的签名证书的哈希。如果未指定任何软件包名称，则别名会提供给调用 KeyChain.choosePrivateKeyAlias 或任何重载的所有应用（但即使在 Android 11 及更高版本上，也必须调用 KeyChain.choosePrivateKeyAlias）。如果某个应用的 Android UID 与此处指定的软件包相同，则该应用在调用 KeyChain.choosePrivateKeyAlias 时将具有访问权限。
privateKeyAlias

string

要使用的私钥的别名。

AlwaysOnVpnPackage

始终开启的 VPN 连接的配置。

JSON 表示法 
{
  "packageName": string,
  "lockdownEnabled": boolean
}
字段
packageName

string

VPN 应用的软件包名称。
lockdownEnabled

boolean

不允许在 VPN 未连接时进行联网。

LocationMode

工作资料和完全受管设备上启用的位置信息检测程度。

枚举
LOCATION_MODE_UNSPECIFIED 默认为 LOCATION_USER_CHOICE。
HIGH_ACCURACY

在 Android 8 及更低版本中，所有位置检测方法均已启用，包括 GPS、网络和其他传感器。在 Android 9 及更高版本中，这等同于 LOCATION_ENFORCED。
SENSORS_ONLY

在 Android 8 及更低版本中，仅启用 GPS 和其他传感器。在 Android 9 及更高版本中，这等同于 LOCATION_ENFORCED。
BATTERY_SAVING

在 Android 8 及更低版本中，仅启用网络位置信息提供程序。在 Android 9 及更高版本中，这等同于 LOCATION_ENFORCED。
OFF

在 Android 8 及更低版本中，位置信息设置和精确度处于停用状态。在 Android 9 及更高版本中，这等同于 LOCATION_DISABLED。
LOCATION_USER_CHOICE 设备上的位置信息设置未受限。未设置或强制执行任何特定行为。
LOCATION_ENFORCED 在设备上启用位置信息设置。
LOCATION_DISABLED 在设备上停用位置信息设置。

ComplianceRule

一种规则，用于声明在设备不符合其政策时应采取哪些缓解措施。对于每条规则，始终存在一个隐式的缓解措施，即针对 Device 资源将 policyCompliant 设置为 false，并在设备上显示一条消息，指明设备不符合其政策。您还可以选择采取其他缓解措施，具体取决于规则中的字段值。

JSON 表示法 
{
  "disableApps": boolean,
  "packageNamesToDisable": [
    string
  ],

  // Union field condition can be only one of the following:
  "nonComplianceDetailCondition": {
    object (NonComplianceDetailCondition)
  },
  "apiLevelCondition": {
    object (ApiLevelCondition)
  }
  // End of list of possible types for union field condition.
}
字段
disableApps

boolean

如果设置为 true，则规则包含用于停用应用的缓解措施，以便有效停用设备，但保留应用数据。如果设备在锁定任务模式下运行应用，系统将关闭该应用，并显示一个界面来告知不合规的原因。
packageNamesToDisable[]

string

如果设置了此属性，规则会包含一项缓解措施，用于停用列表中指定的应用，但应用数据会保留。
联合字段 condition。条件，满足该条件时会触发规则中定义的缓解措施。必须设置其中一个条件。condition 只能是下列其中一项：
nonComplianceDetailCondition

object (NonComplianceDetailCondition)

如果设备存在任何匹配的 NonComplianceDetail，则满足相应条件。
apiLevelCondition

object (ApiLevelCondition)

一种条件，如果设备上的 Android 框架 API 级别不满足最低要求，则满足该条件。

NonComplianceDetailCondition

一种合规性规则条件，如果设备存在任何匹配的 NonComplianceDetail，则满足该条件。如果 NonComplianceDetailCondition 中设置的所有字段都与相应的 NonComplianceDetail 字段匹配，则 NonComplianceDetail 与 NonComplianceDetailCondition 匹配。

JSON 表示法 
{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string
}
字段
settingName

string

政策设置的名称。这是顶级 Policy 字段的 JSON 字段名称。如果未设置，则此条件与任何设置名称都匹配。
nonComplianceReason

enum (NonComplianceReason)

设备不符合相应设置的原因。如果未设置，则此条件会匹配任何原因。
packageName

string

不合规应用的软件包名称。如果未设置，则此条件与任何软件包名称都匹配。

ApiLevelCondition

一种合规性规则条件，如果设备上的 Android 框架 API 级别不满足最低要求，则满足该条件。每项政策只能有一条具有此类条件的规则。

JSON 表示法 
{
  "minApiLevel": integer
}
字段
minApiLevel

integer

所需的最低 Android 框架 API 级别。如果设备不满足最低要求，则满足此条件。必须大于零。

AppAutoUpdatePolicy

建议的替代方案：autoUpdateMode，此设置是按应用设置的，可更灵活地控制更新频率。

如果 autoUpdateMode 设置为 AUTO_UPDATE_POSTPONED 或 AUTO_UPDATE_HIGH_PRIORITY，此字段将不起作用。

应用自动更新政策，用于控制何时可以应用自动应用更新。

枚举
APP_AUTO_UPDATE_POLICY_UNSPECIFIED 未设置自动更新政策。等同于 CHOICE_TO_THE_USER。
CHOICE_TO_THE_USER 用户可以控制自动更新。
NEVER 一律不自动更新应用。
WIFI_ONLY 应用仅通过 WLAN 自动更新。
ALWAYS 应用随时自动更新。这可能会产生流量费。

AppTrack

Google Play 应用发布轨道。

枚举
APP_TRACK_UNSPECIFIED 此值会被忽略。
PRODUCTION 正式版轨道，提供最新的稳定版本。
BETA Beta 版轨道，提供最新的 Beta 版。

EncryptionPolicy

加密类型

枚举
ENCRYPTION_POLICY_UNSPECIFIED 此值会被忽略，即不需要加密
ENABLED_WITHOUT_PASSWORD 需要加密，但启动时不需要密码
ENABLED_WITH_PASSWORD 需要加密，且需要密码才能启动

PlayStoreMode

Play 商店模式政策的可能值。

枚举
PLAY_STORE_MODE_UNSPECIFIED 未指定。默认值为 WHITELIST。
WHITELIST 只有政策中包含的应用可用，任何不在政策中的应用都会自动从设备中卸载。
BLACKLIST 所有应用均可用，任何不应出现在设备上的应用都应在 applications 政策中明确标记为“已屏蔽”。

SetupAction

设置期间执行的操作。

JSON 表示法 
{
  "title": {
    object (UserFacingMessage)
  },
  "description": {
    object (UserFacingMessage)
  },

  // Union field action can be only one of the following:
  "launchApp": {
    object (LaunchAppAction)
  }
  // End of list of possible types for union field action.
}
字段
title

object (UserFacingMessage)

相应操作的标题。
description

object (UserFacingMessage)

相应操作的说明。
联合字段 action。在设置期间要执行的操作。action 只能是下列其中一项：
launchApp

object (LaunchAppAction)

用于启动应用的操作。系统将使用包含 extra 的 intent 启动应用，该 extra 的键 com.google.android.apps.work.clouddpc.EXTRA_LAUNCHED_AS_SETUP_ACTION 设置为布尔值 true，以表明这是一个设置操作流程。如果 SetupAction 引用了某个应用，则应用政策中对应的 installType 必须设置为 REQUIRED_FOR_SETUP，否则相应设置会失败。

LaunchAppAction

用于启动应用的操作。

JSON 表示法 
{

  // Union field launch can be only one of the following:
  "packageName": string
  // End of list of possible types for union field launch.
}
字段
联合字段 launch。要执行的启动操作的说明 launch 只能是以下值之一：
packageName

string

要启动的应用的软件包名称

PolicyEnforcementRule

用于定义在设备或工作资料不符合 settingName 中指定的政策时应采取的操作的规则。如果存在多条匹配的或触发的违规处置规则，系统会将这些规则合并，并采取最严厉的处置措施。不过，系统仍会跟踪所有已触发的规则，包括初始触发时间和所有相关的不合规详情。如果满足最严格的违规处置规则，系统会应用下一个最合适的处置措施。

JSON 表示法 
{
  "blockAction": {
    object (BlockAction)
  },
  "wipeAction": {
    object (WipeAction)
  },

  // Union field trigger can be only one of the following:
  "settingName": string
  // End of list of possible types for union field trigger.
}
字段
blockAction

object (BlockAction)

用于阻止对公司自有设备或工作资料中的应用和数据的访问的操作。此操作还会触发面向用户的通知，其中包含有关如何修正违规问题的信息（如果可能）。注意：还必须指定 wipeAction。
wipeAction

object (WipeAction)

用于重置公司自有设备或删除工作资料的操作。注意：还必须指定 blockAction。
联合字段 trigger。触发相应规则的条件。trigger 只能是下列其中一项：
settingName

string

要强制执行的顶级政策。例如，applications 或 passwordPolicies。

BlockAction

用于阻止对完全受管设备或工作资料中的应用和数据的访问权限的操作。此操作还会触发设备或工作资料显示面向用户的通知，其中包含有关如何修正违规问题的信息（如果可能）。注意：还必须指定 wipeAction。

JSON 表示法 
{
  "blockAfterDays": integer,
  "blockScope": enum (BlockScope)
}
字段
blockAfterDays

integer

在设备或工作资料被屏蔽之前，政策处于不合规状态的天数。如需立即阻止访问，请设置为 0。blockAfterDays 必须小于 wipeAfterDays。
blockScope

enum (BlockScope)

指定相应 BlockAction 的范围。仅适用于公司自有设备。

BlockScope

指定 BlockAction 的范围。仅适用于公司自有设备。

枚举
BLOCK_SCOPE_UNSPECIFIED 未指定。默认为 BLOCK_SCOPE_WORK_PROFILE。
BLOCK_SCOPE_WORK_PROFILE “禁止”操作仅应用于工作资料中的应用。个人资料中的应用不受影响。
BLOCK_SCOPE_DEVICE 屏蔽操作会应用于整个设备，包括个人资料中的应用。

WipeAction

用于重置公司自有设备或删除工作资料的操作。注意：还必须指定 blockAction。

JSON 表示法 
{
  "wipeAfterDays": integer,
  "preserveFrp": boolean
}
字段
wipeAfterDays

integer

设备或工作资料在违规多少天后会被擦除。wipeAfterDays 必须大于 blockAfterDays。
preserveFrp

boolean

设备上是否保留了恢复出厂设置保护机制数据。此设置不适用于工作资料。

KioskCustomization

用于控制设备在自助服务终端模式下的行为的设置。如需启用自助服务终端模式，请将 kioskCustomLauncherEnabled 设置为 true，或在政策中指定应用并使用 installType KIOSK。

JSON 表示法 
{
  "powerButtonActions": enum (PowerButtonActions),
  "systemErrorWarnings": enum (SystemErrorWarnings),
  "systemNavigation": enum (SystemNavigation),
  "statusBar": enum (StatusBar),
  "deviceSettings": enum (DeviceSettings)
}
字段
powerButtonActions

enum (PowerButtonActions)

设置设备在信息亭模式下，当用户按住（长按）电源按钮时的行为。
systemErrorWarnings

enum (SystemErrorWarnings)

指定在自助服务终端模式下是否屏蔽崩溃或无响应的应用的系统错误对话框。如果应用被屏蔽，系统会强制停止该应用，就像用户在界面上选择“关闭应用”选项一样。
systemNavigation

enum (SystemNavigation)

指定在自助服务终端模式下启用哪些导航功能（例如“主屏幕”按钮、“概览”按钮）。
statusBar

enum (StatusBar)

指定在自助服务终端模式下是否停用系统信息和通知。
deviceSettings

enum (DeviceSettings)

指定是否允许在自助服务终端模式下使用“设置”应用。

PowerButtonActions

设置设备在信息亭模式下，当用户按住（长按）电源按钮时的行为。

枚举
POWER_BUTTON_ACTIONS_UNSPECIFIED 如果未指定，则默认为 POWER_BUTTON_AVAILABLE。
POWER_BUTTON_AVAILABLE 当用户在自助服务终端模式下长按设备的电源按钮时，系统会显示电源菜单（例如“关机”“重新启动”）。
POWER_BUTTON_BLOCKED 当用户在自助服务终端模式下长按设备的电源按钮时，系统不会显示电源菜单（例如“关机”“重新启动”）。注意：这可能会阻止用户关闭设备。

SystemErrorWarnings

指定在自助服务终端模式下是否屏蔽崩溃或无响应的应用的系统错误对话框。

枚举
SYSTEM_ERROR_WARNINGS_UNSPECIFIED 如果未指定，则默认为 ERROR_AND_WARNINGS_MUTED。
ERROR_AND_WARNINGS_ENABLED 显示所有系统错误对话框，例如崩溃和应用无响应 (ANR)。
ERROR_AND_WARNINGS_MUTED 所有系统错误对话框（例如崩溃和应用无响应 [ANR]）都被屏蔽。当应用被屏蔽时，系统会强制停止该应用，就像用户从界面中关闭该应用一样。

SystemNavigation

指定在自助服务终端模式下启用哪些导航功能（例如“主屏幕”按钮、“概览”按钮）。

枚举
SYSTEM_NAVIGATION_UNSPECIFIED 如果未指定，则默认为 NAVIGATION_DISABLED。
NAVIGATION_ENABLED “主页”按钮和“概览”按钮已启用。
NAVIGATION_DISABLED 主屏幕按钮和概览按钮无法访问。
HOME_BUTTON_ONLY 仅启用主屏幕按钮。

StatusBar

指定在自助服务终端模式下是否停用系统信息和通知。

枚举
STATUS_BAR_UNSPECIFIED 如果未指定，则默认为 INFO_AND_NOTIFICATIONS_DISABLED。
NOTIFICATIONS_AND_SYSTEM_INFO_ENABLED

在自助服务终端模式下，系统信息和通知会显示在状态栏中。

注意：如需使此政策生效，必须使用 kioskCustomization.systemNavigation 启用设备的 Home 按钮。
NOTIFICATIONS_AND_SYSTEM_INFO_DISABLED 在自助服务终端模式下，系统信息和通知处于停用状态。
SYSTEM_INFO_ONLY 状态栏上仅显示系统信息。

DeviceSettings

指定用户在自助服务终端模式下是否可以访问设备的“设置”应用。

枚举
DEVICE_SETTINGS_UNSPECIFIED 如果未指定，则默认为 SETTINGS_ACCESS_ALLOWED。
SETTINGS_ACCESS_ALLOWED 在自助服务终端模式下，允许访问“设置”应用。
SETTINGS_ACCESS_BLOCKED 在自助服务终端模式下，不允许访问“设置”应用。

AdvancedSecurityOverrides

高级安全设置。在大多数情况下，无需设置这些属性。

JSON 表示法 
{
  "untrustedAppsPolicy": enum (UntrustedAppsPolicy),
  "googlePlayProtectVerifyApps": enum (GooglePlayProtectVerifyApps),
  "developerSettings": enum (DeveloperSettings),
  "commonCriteriaMode": enum (CommonCriteriaMode),
  "personalAppsThatCanReadWorkNotifications": [
    string
  ],
  "mtePolicy": enum (MtePolicy),
  "contentProtectionPolicy": enum (ContentProtectionPolicy)
}
字段
untrustedAppsPolicy

enum (UntrustedAppsPolicy)

在设备上强制执行的针对不受信任的应用（来自未知来源的应用）的政策。取代了 installUnknownSourcesAllowed (deprecated).
googlePlayProtectVerifyApps

enum (GooglePlayProtectVerifyApps)

是否强制执行 Google Play 保护机制验证。取代 ensureVerifyAppsEnabled（已弃用）。
developerSettings

enum (DeveloperSettings)

控制对开发者设置（开发者选项和安全启动）的访问权限。取代 safeBootDisabled（已弃用）和 debuggingFeaturesAllowed（已弃用）。
commonCriteriaMode

enum (CommonCriteriaMode)

控制 Common Criteria 模式 - 信息技术安全评估通用准则 (CC) 中定义的安全标准。启用通用标准模式可以增强设备上某些安全组件的安全性，详情请参阅 CommonCriteriaMode。

警告：通用评估准则模式会强制执行严格的安全模型，通常仅适用于国家安全系统和其他高度敏感的组织中使用的 IT 产品。标准设备使用可能会受到影响。仅在需要时启用。如果之前已启用 Common Criteria 模式，但之后又将其关闭，则所有用户配置的 Wi-Fi 网络可能会丢失，并且任何需要用户输入的企业配置的 Wi-Fi 网络可能都需要重新配置。
personalAppsThatCanReadWorkNotifications[]

string

可以使用 NotificationListenerService 读取工作资料通知的个人应用。默认情况下，除了系统应用之外，任何个人应用都无法读取工作通知。列表中的每个值都必须是软件包名称。
mtePolicy

enum (MtePolicy)

可选。控制设备上的内存标记扩展 (MTE)。设备需要重新启动才能应用对 MTE 政策的更改。
contentProtectionPolicy

enum (ContentProtectionPolicy)

可选。控制是否启用内容保护功能（该功能会扫描欺骗性应用）。Android 15 及更高版本支持此功能。

UntrustedAppsPolicy

在设备上强制执行的针对不受信任的应用（来自未知来源的应用）的政策。取代了 installUnknownSourcesAllowed (deprecated).

枚举
UNTRUSTED_APPS_POLICY_UNSPECIFIED 未指定。默认值为 DISALLOW_INSTALL。
DISALLOW_INSTALL 默认值。禁止在整个设备上安装不受信任的应用。
ALLOW_INSTALL_IN_PERSONAL_PROFILE_ONLY 对于设置了工作资料的设备，仅允许在设备的个人资料中安装不受信任的应用。
ALLOW_INSTALL_DEVICE_WIDE 允许在整个设备上安装不受信任的应用。

GooglePlayProtectVerifyApps

是否强制执行 Google Play 保护机制验证。取代 ensureVerifyAppsEnabled（已弃用）。

枚举
GOOGLE_PLAY_PROTECT_VERIFY_APPS_UNSPECIFIED 未指定。默认值为 VERIFY_APPS_ENFORCED。
VERIFY_APPS_ENFORCED 默认值。强制启用应用验证。
VERIFY_APPS_USER_CHOICE 允许用户选择是否启用应用验证功能。

DeveloperSettings

控制对开发者设置（开发者选项和安全启动）的访问权限。取代 safeBootDisabled（已弃用）和 debuggingFeaturesAllowed（已弃用）。

枚举
DEVELOPER_SETTINGS_UNSPECIFIED 未指定。默认值为 DEVELOPER_SETTINGS_DISABLED。
DEVELOPER_SETTINGS_DISABLED 默认值。停用所有开发者设置，并禁止用户访问这些设置。
DEVELOPER_SETTINGS_ALLOWED 允许所有开发者设置。用户可以访问并选择性地配置这些设置。

CommonCriteriaMode

控制 Common Criteria 模式 - 信息技术安全评估通用准则 (CC) 中定义的安全标准。启用通用标准模式可以增强设备上某些安全组件的安全性，包括：

  1. 蓝牙长期密钥的 AES-GCM 加密
  2. Wi-Fi 配置存储区
  3. 需要使用 TLSv1.2 连接到 AM API 目标主机的其他网络证书验证
  4. 加密政策完整性检查。建议将 statusReportingSettings.commonCriteriaModeEnabled 设置为 true，以获取政策完整性检查的状态。如果政策签名验证失败，则政策不会应用到设备，并且 commonCriteriaModeInfo.policy_signature_verification_status 会设置为 POLICY_SIGNATURE_VERIFICATION_FAILED。

通用标准模式仅适用于搭载 Android 11 或更高版本的公司自有设备。

警告：通用评估准则模式会强制执行严格的安全模型，通常仅适用于国家安全系统和其他高度敏感的组织中使用的 IT 产品。标准设备使用可能会受到影响。仅在需要时启用。如果之前已启用 Common Criteria 模式，但之后又将其关闭，则所有用户配置的 Wi-Fi 网络可能会丢失，并且任何需要用户输入的企业配置的 Wi-Fi 网络可能都需要重新配置。

枚举
COMMON_CRITERIA_MODE_UNSPECIFIED 未指定。默认值为 COMMON_CRITERIA_MODE_DISABLED。
COMMON_CRITERIA_MODE_DISABLED 默认值。停用 Common Criteria 模式。
COMMON_CRITERIA_MODE_ENABLED 启用 Common Criteria 模式。

MtePolicy

控制设备上的内存标记扩展 (MTE)。

枚举
MTE_POLICY_UNSPECIFIED 未指定。默认为 MTE_USER_CHOICE。
MTE_USER_CHOICE 如果设备支持 MTE，用户可以选择在设备上启用或停用 MTE。
MTE_ENFORCED

设备上已启用 MTE，且不允许用户更改此设置。此设置可在完全托管设备和公司自有设备上的工作资料中进行设置。对于其他管理模式，系统会报告 NonComplianceDetail（含 MANAGEMENT_MODE）。如果设备不支持 MTE，则报告 DEVICE_INCOMPATIBLE 为 NonComplianceDetail 的事件。

支持 Android 14 及更高版本。如果 Android 版本低于 14，则报告具有 API_LEVEL 的 NonComplianceDetail。
MTE_DISABLED

设备上的 MTE 已停用，且不允许用户更改此设置。此设置仅适用于全代管式设备。在其他情况下，系统会报告一个包含 MANAGEMENT_MODE 的 NonComplianceDetail。如果设备不支持 MTE，则报告 DEVICE_INCOMPATIBLE 为 NonComplianceDetail 的事件。

支持 Android 14 及更高版本。如果 Android 版本低于 14，则报告具有 API_LEVEL 的 NonComplianceDetail。

ContentProtectionPolicy

控制是否启用内容保护功能（该功能会扫描欺骗性应用）。Android 15 及更高版本支持此功能。

枚举
CONTENT_PROTECTION_POLICY_UNSPECIFIED 未指定。默认为 CONTENT_PROTECTION_DISABLED。
CONTENT_PROTECTION_DISABLED 内容保护功能已停用，且用户无法更改此设置。
CONTENT_PROTECTION_ENFORCED

内容保护功能已启用，且用户无法更改此设置。

在 Android 15 及更高版本上受支持。如果 Android 版本低于 15，则报告 NonComplianceDetail（含 API_LEVEL）。
CONTENT_PROTECTION_USER_CHOICE

内容保护不受政策控制。允许用户选择内容保护的行为。

在 Android 15 及更高版本上受支持。如果 Android 版本低于 15，则报告 NonComplianceDetail（含 API_LEVEL）。

PersonalUsagePolicies

用于控制装有工作资料的公司自有设备上的个人使用情况的政策。

JSON 表示法 
{
  "cameraDisabled": boolean,
  "screenCaptureDisabled": boolean,
  "accountTypesWithManagementDisabled": [
    string
  ],
  "maxDaysWithWorkOff": integer,
  "personalPlayStoreMode": enum (PlayStoreMode),
  "personalApplications": [
    {
      object (PersonalApplicationPolicy)
    }
  ],
  "privateSpacePolicy": enum (PrivateSpacePolicy),
  "bluetoothSharing": enum (BluetoothSharing)
}
字段
cameraDisabled

boolean

如果为 true，则表示在个人资料中停用了相机。
screenCaptureDisabled

boolean

如果为 true，则禁止所有用户截屏。
accountTypesWithManagementDisabled[]

string

无法由用户管理的账号类型。
maxDaysWithWorkOff

integer

控制工作资料可以保持关闭状态的时间。最短时长必须至少为 3 天。其他详细信息如下：

  • 如果将时长设置为 0，则该功能会关闭。
  • 如果将时长设置为小于最短时长的值，该功能会返回错误。
注意：如果您想避免个人资料在长时间的非工作时间被暂停，可以暂时为此参数设置一个较大的值。
personalPlayStoreMode

enum (PlayStoreMode)

与 personalApplications 搭配使用，以控制个人资料中的应用是被允许还是被屏蔽。
personalApplications[]

object (PersonalApplicationPolicy)

应用于个人资料中应用的政策。
privateSpacePolicy

enum (PrivateSpacePolicy)

可选。控制是否允许在设备上使用私密空间。
bluetoothSharing

enum (BluetoothSharing)

可选。是否允许蓝牙共享。

PlayStoreMode

与 personalApplications 搭配使用，以控制个人资料中的应用是被允许还是被屏蔽。

枚举
PLAY_STORE_MODE_UNSPECIFIED 未指定。默认为 BLOCKLIST。
BLACKLIST

所有 Play 商店应用都可以在个人资料中安装，但 personalApplications 中 installType 为 BLOCKED 的应用除外。
BLOCKLIST 所有 Play 商店应用都可以在个人资料中安装，但 personalApplications 中 installType 为 BLOCKED 的应用除外。
ALLOWLIST 只有在 personalApplications 中明确指定且 installType 设置为 AVAILABLE 的应用才能安装在个人资料中。

PersonalApplicationPolicy

装有工作资料的公司自有设备的个人资料中的应用所适用的政策。

JSON 表示法 
{
  "packageName": string,
  "installType": enum (InstallType)
}
字段
packageName

string

应用的软件包名称。
installType

enum (InstallType)

要执行的安装类型。

InstallType

个人资料应用可具有的安装行为类型。

枚举
INSTALL_TYPE_UNSPECIFIED 未指定。默认为 AVAILABLE。
BLOCKED 该应用已被屏蔽，无法在个人资料中安装。如果之前已在设备上安装该应用，系统会将其卸载。
AVAILABLE 该应用可在个人资料中安装。

PrivateSpacePolicy

控制是否允许在设备上使用私密空间。

枚举
PRIVATE_SPACE_POLICY_UNSPECIFIED 未指定。默认为 PRIVATE_SPACE_ALLOWED。
PRIVATE_SPACE_ALLOWED 用户可以创建私密空间个人资料。
PRIVATE_SPACE_DISALLOWED 用户无法创建私密空间个人资料。仅适用于设有工作资料的公司自有设备。注意：系统将移除所有现有的私密空间。

BluetoothSharing

是否允许在装有工作资料的公司自有设备的个人资料中使用蓝牙共享。

枚举
BLUETOOTH_SHARING_UNSPECIFIED 未指定。默认为 BLUETOOTH_SHARING_ALLOWED。
BLUETOOTH_SHARING_ALLOWED

个人资料允许蓝牙共享。

支持 Android 8 及更高版本。如果为个人设备设置了此项，则会报告 NonComplianceDetail（含 MANAGEMENT_MODE）。
BLUETOOTH_SHARING_DISALLOWED

个人资料不允许进行蓝牙共享。

支持 Android 8 及更高版本。如果 Android 版本低于 8，则会报告具有 API_LEVEL 的 NonComplianceDetail。如果为个人设备设置了此项，则会报告 NonComplianceDetail（含 MANAGEMENT_MODE）。

AutoDateAndTimeZone

公司自有设备上是否启用了自动设置日期、时间和时区功能。

枚举
AUTO_DATE_AND_TIME_ZONE_UNSPECIFIED 未指定。默认为 AUTO_DATE_AND_TIME_ZONE_USER_CHOICE。
AUTO_DATE_AND_TIME_ZONE_USER_CHOICE 自动确定日期、时间和时区由用户自行选择。
AUTO_DATE_AND_TIME_ZONE_ENFORCED 在设备上强制执行自动日期、时间和时区。

OncCertificateProvider

此功能尚未正式发布。

JSON 表示法 
{
  "certificateReferences": [
    string
  ],

  // Union field endpoint can be only one of the following:
  "contentProviderEndpoint": {
    object (ContentProviderEndpoint)
  }
  // End of list of possible types for union field endpoint.
}
字段
certificateReferences[]

string

此功能尚未正式发布。

联合字段 endpoint。

此功能尚未正式发布。endpoint 只能是下列其中一项：
contentProviderEndpoint

object (ContentProviderEndpoint)

此功能尚未正式发布。

ContentProviderEndpoint

此功能尚未正式发布。

JSON 表示法 
{
  "uri": string,
  "packageName": string,
  "signingCertsSha256": [
    string
  ]
}
字段
uri

string

此功能尚未正式发布。
packageName

string

此功能尚未正式发布。
signingCertsSha256[]

string

必需。此功能尚未正式发布。

CrossProfilePolicies

控制可从个人资料访问的工作资料中的数据，反之亦然。如果设备没有工作资料，则会报告带有 MANAGEMENT_MODE 的 NonComplianceDetail。

JSON 表示法 
{
  "showWorkContactsInPersonalProfile": enum (ShowWorkContactsInPersonalProfile),
  "crossProfileCopyPaste": enum (CrossProfileCopyPaste),
  "crossProfileDataSharing": enum (CrossProfileDataSharing),
  "workProfileWidgetsDefault": enum (WorkProfileWidgetsDefault),
  "crossProfileAppFunctions": enum (CrossProfileAppFunctions),
  "exemptionsToShowWorkContactsInPersonalProfile": {
    object (PackageNameList)
  }
}
字段
showWorkContactsInPersonalProfile

enum (ShowWorkContactsInPersonalProfile)

个人应用是否可以访问工作资料中存储的联系人。

另请参阅 exemptionsToShowWorkContactsInPersonalProfile。
crossProfileCopyPaste

enum (CrossProfileCopyPaste)

从一个个人资料（个人或工作）复制的文本是否可以粘贴到另一个个人资料中。
crossProfileDataSharing

enum (CrossProfileDataSharing)

一个资料（个人或工作）中的数据是否可以与另一个资料中的应用共享。专门控制通过 intent 进行的简单数据共享。其他跨资料通信渠道（例如联系人搜索、复制/粘贴或关联的工作应用和个人应用）的管理功能需单独配置。
workProfileWidgetsDefault

enum (WorkProfileWidgetsDefault)

指定工作资料 widget 的默认行为。如果政策未针对特定应用指定 workProfileWidgets，则会根据此处指定的值运行。
crossProfileAppFunctions

enum (CrossProfileAppFunctions)

可选。控制个人资料应用是否可以调用工作资料中的应用公开的应用函数。
exemptionsToShowWorkContactsInPersonalProfile

object (PackageNameList)

从 ShowWorkContactsInPersonalProfile 设置中排除的应用的列表。若要设置此属性，ShowWorkContactsInPersonalProfile 必须设置为以下值之一：

支持 Android 14 及更高版本。如果 Android 版本低于 14，则报告具有 API_LEVEL 的 NonComplianceDetail。

ShowWorkContactsInPersonalProfile

个人应用是否可以访问工作资料联系人，包括联系人搜索和来电

注意：一旦任何个人应用访问了工作联系人，就无法保证该联系人会保留在同一应用中，因为该联系人可能会被共享或转移到任何其他应用，具体取决于允许的应用的行为。

枚举
SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_UNSPECIFIED

未指定。默认为 SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_ALLOWED。

如果设置了此字段，则不得设置 exemptionsToShowWorkContactsInPersonalProfile。
SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED

防止个人应用访问工作资料联系人和查找工作联系人。

设置此值后，exemptionsToShowWorkContactsInPersonalProfile 中指定的个人应用会被列入许可名单，可以直接访问工作资料联系人。

此设置适用于 Android 7.0 及更高版本。如果 Android 版本低于 7.0，则报告 NonComplianceDetail（含 API_LEVEL）。
SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_ALLOWED

默认值。允许个人资料中的应用访问工作资料联系人，包括联系人搜索和来电。

设置此值后，exemptionsToShowWorkContactsInPersonalProfile 中指定的个人应用会被列入禁止名单，无法直接访问工作资料联系人。

此设置适用于 Android 7.0 及更高版本。如果 Android 版本低于 7.0，则报告 NonComplianceDetail（含 API_LEVEL）。
SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED_EXCEPT_SYSTEM

防止大多数个人应用访问工作资料联系人（包括联系人搜索和来电），但 OEM 默认的拨号器、信息和通讯录应用除外。无论是用户配置的拨号器、信息和通讯录应用，还是任何其他系统或 Play 安装的应用，都无法直接查询工作联系人。

设置此值后，exemptionsToShowWorkContactsInPersonalProfile 中指定的个人应用会被列入许可名单，并且可以访问工作资料联系人。

支持 Android 14 及更高版本。如果此值是在 Android 版本低于 14 的设备上设置的，则行为会回退到 SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED，并报告 API_LEVEL 为 NonComplianceDetail 的 NonComplianceDetail。

CrossProfileCopyPaste

从一个个人资料（个人或工作）复制的文本是否可以粘贴到另一个个人资料中。

枚举
CROSS_PROFILE_COPY_PASTE_UNSPECIFIED 未指定。默认值为 COPY_FROM_WORK_TO_PERSONAL_DISALLOWED
COPY_FROM_WORK_TO_PERSONAL_DISALLOWED 默认值。禁止用户将从工作资料复制的文本粘贴到个人资料中。从个人资料复制的文本可以粘贴到工作资料中，从工作资料复制的文本也可以粘贴到工作资料中。
CROSS_PROFILE_COPY_PASTE_ALLOWED 在任一资料中复制的文字都可以粘贴到另一资料中。

CrossProfileDataSharing

一个资料（个人或工作）中的数据是否可以与另一个资料中的应用共享。专门控制通过 intent 进行的简单数据共享。这包括打开网络浏览器、打开地图、分享内容、打开文档等操作。其他跨个人资料通信渠道（例如联系人搜索、复制/粘贴或关联的工作应用和个人应用）的管理功能需单独配置。

枚举
CROSS_PROFILE_DATA_SHARING_UNSPECIFIED 未指定。默认值为 DATA_SHARING_FROM_WORK_TO_PERSONAL_DISALLOWED。
CROSS_PROFILE_DATA_SHARING_DISALLOWED 防止数据从个人资料共享到工作资料，以及从工作资料共享到个人资料。
DATA_SHARING_FROM_WORK_TO_PERSONAL_DISALLOWED 默认值。禁止用户将工作资料中的数据分享到个人资料中的应用。个人数据可以与工作应用共享。
CROSS_PROFILE_DATA_SHARING_ALLOWED 任一个人资料中的数据都可以与另一个人资料共享。

WorkProfileWidgetsDefault

控制在未定义任何特定于应用的政策的情况下，是否允许工作资料应用向主屏幕添加 widget。否则，应用专用政策的优先级将高于此政策。

枚举
WORK_PROFILE_WIDGETS_DEFAULT_UNSPECIFIED 未指定。默认值为 WORK_PROFILE_WIDGETS_DEFAULT_DISALLOWED。
WORK_PROFILE_WIDGETS_DEFAULT_ALLOWED 默认允许使用工作资料 widget。这意味着，如果政策未将应用的 workProfileWidgets 指定为 WORK_PROFILE_WIDGETS_DISALLOWED，则该应用将能够向主屏幕添加 widget。
WORK_PROFILE_WIDGETS_DEFAULT_DISALLOWED 工作资料 widget 默认处于禁止状态。这意味着，如果政策未将应用的 workProfileWidgets 指定为 WORK_PROFILE_WIDGETS_ALLOWED，则应用将无法向主屏幕添加 widget。

CrossProfileAppFunctions

控制是否允许个人资料应用调用工作资料中应用公开的应用功能。

枚举
CROSS_PROFILE_APP_FUNCTIONS_UNSPECIFIED 未指定。如果 appFunctions 设置为 APP_FUNCTIONS_ALLOWED，则默认为 CROSS_PROFILE_APP_FUNCTIONS_ALLOWED。如果 appFunctions 设置为 APP_FUNCTIONS_DISALLOWED，则默认为 CROSS_PROFILE_APP_FUNCTIONS_DISALLOWED。
CROSS_PROFILE_APP_FUNCTIONS_DISALLOWED 个人资料应用不得调用工作资料中的应用公开的应用函数。
CROSS_PROFILE_APP_FUNCTIONS_ALLOWED 个人资料应用可以调用工作资料中的应用公开的应用函数。如果设置了此政策，则不得将 appFunctions 设置为 APP_FUNCTIONS_DISALLOWED，否则系统将拒绝该政策。

PreferentialNetworkService

控制是否在工作资料或完全受管理的设备上启用优先网络服务。详情请参见 preferentialNetworkService。

枚举
PREFERENTIAL_NETWORK_SERVICE_UNSPECIFIED 未指定。默认为 PREFERENTIAL_NETWORK_SERVICES_DISABLED。
PREFERENTIAL_NETWORK_SERVICE_DISABLED 工作资料中已停用优选网络服务。
PREFERENTIAL_NETWORK_SERVICE_ENABLED 工作资料已启用优选网络服务。此设置仅适用于搭载 Android 12 或更高版本的设备上的工作资料。从 Android 13 开始，还支持全代管式设备。

UsageLog

控制从设备收集并通过 Pub/Sub 通知报告的设备活动日志类型。

JSON 表示法 
{
  "enabledLogTypes": [
    enum (LogType)
  ],
  "uploadOnCellularAllowed": [
    enum (LogType)
  ]
}
字段
enabledLogTypes[]

enum (LogType)

指定启用了哪些日志类型。请注意，启用使用情况日志记录后，用户会收到设备上的消息。
uploadOnCellularAllowed[]

enum (LogType)

指定哪些已启用的日志类型可以通过移动数据上传。默认情况下，当设备连接到 Wi-Fi 时，日志会排队等待上传。

LogType

从设备报告的设备活动日志的类型。

枚举
LOG_TYPE_UNSPECIFIED 未使用此值。
SECURITY_LOGS 启用设备端安全事件的日志记录，例如设备密码输入错误或可移除存储设备已装载。如需查看记录的安全事件的完整说明，请参阅 UsageLogEvent。适用于搭载 Android 7 及更高版本的完全受管设备。适用于搭载 Android 12 及更高版本且设有工作资料的公司自有设备，此类设备仅记录工作资料中的安全事件。可由应用委托范围 SECURITY_LOGS 替换
NETWORK_ACTIVITY_LOGS 启用对设备端网络事件（例如 DNS 查询和 TCP 连接）的日志记录。如需查看记录的网络事件的完整说明，请参阅 UsageLogEvent。Android 8 及更高版本上的全受管设备支持此设置。适用于搭载 Android 12 及更高版本且设有工作资料的公司自有设备，此类设备只会记录工作资料中的网络事件。可由应用委托范围 NETWORK_ACTIVITY_LOGS 替换

CameraAccess

控制相机的使用情况，以及用户是否可以访问相机访问权限切换开关。摄像头访问权限切换开关适用于 Android 12 及更高版本。一般来说，在完全受管设备上，停用相机的可能性适用于整个设备；而在具有工作资料的设备上，停用相机的可能性仅适用于工作资料。停用摄像头使用权限切换开关的可能性仅适用于完全受管理设备，在这种情况下，该设置适用于整个设备。如需了解具体信息，请参阅枚举值。

枚举
CAMERA_ACCESS_UNSPECIFIED 如果 cameraDisabled 为 true，则等同于 CAMERA_ACCESS_DISABLED。否则，此值等同于 CAMERA_ACCESS_USER_CHOICE。
CAMERA_ACCESS_USER_CHOICE 系统会忽略 cameraDisabled 字段。这是默认的设备行为：设备上的所有摄像头均可使用。在 Android 12 及更高版本中，用户可以使用摄像头使用权限切换开关。
CAMERA_ACCESS_DISABLED

系统会忽略 cameraDisabled 字段。设备上的所有相机均已停用（对于完全受管设备，此设置适用于整个设备；对于工作资料，此设置仅适用于工作资料）。

Android 12 及更高版本未对摄像头使用权限切换开关设置明确限制：在完全受管的设备上，摄像头使用权限切换开关无效，因为所有摄像头均处于停用状态。在设有工作资料的设备上，此开关对工作资料中的应用没有影响，但会影响工作资料之外的应用。
CAMERA_ACCESS_ENFORCED 系统会忽略 cameraDisabled 字段。设备上的所有摄像头均可用。在搭载 Android 12 及更高版本的完全受管理设备上，用户无法使用摄像头使用权限切换开关。在非完全受管的设备或搭载 Android 11 及以下版本的设备上，此值相当于 CAMERA_ACCESS_USER_CHOICE。

MicrophoneAccess

在完全托管的设备上，控制麦克风的使用情况以及用户是否可以访问麦克风访问权限切换开关。此设置对非完全托管的设备没有任何影响。麦克风使用权限切换开关适用于 Android 12 及更高版本。

枚举
MICROPHONE_ACCESS_UNSPECIFIED 如果 unmuteMicrophoneDisabled 为 true，则等同于 MICROPHONE_ACCESS_DISABLED。否则，此值等同于 MICROPHONE_ACCESS_USER_CHOICE。
MICROPHONE_ACCESS_USER_CHOICE 系统会忽略 unmuteMicrophoneDisabled 字段。这是默认的设备行为：设备上的麦克风可用。在 Android 12 及更高版本中，用户可以使用麦克风使用权限切换开关。
MICROPHONE_ACCESS_DISABLED

系统会忽略 unmuteMicrophoneDisabled 字段。设备上的麦克风已停用（对于完全受管理的设备，此设置适用于整个设备）。

由于麦克风已停用，因此麦克风使用权限切换开关不起作用。
MICROPHONE_ACCESS_ENFORCED 系统会忽略 unmuteMicrophoneDisabled 字段。设备上的麦克风可用。在搭载 Android 12 及更高版本的设备上，用户无法使用麦克风使用权限切换开关。在搭载 Android 11 或更低版本的设备上，此值等同于 MICROPHONE_ACCESS_USER_CHOICE。

DeviceConnectivityManagement

涵盖设备连接的控制，例如 Wi-Fi、USB 数据访问、键盘/鼠标连接等。

JSON 表示法 
{
  "usbDataAccess": enum (UsbDataAccess),
  "configureWifi": enum (ConfigureWifi),
  "wifiDirectSettings": enum (WifiDirectSettings),
  "tetheringSettings": enum (TetheringSettings),
  "wifiSsidPolicy": {
    object (WifiSsidPolicy)
  },
  "wifiRoamingPolicy": {
    object (WifiRoamingPolicy)
  },
  "bluetoothSharing": enum (BluetoothSharing),
  "preferentialNetworkServiceSettings": {
    object (PreferentialNetworkServiceSettings)
  },
  "apnPolicy": {
    object (ApnPolicy)
  }
}
字段
usbDataAccess

enum (UsbDataAccess)

控制可通过 USB 传输哪些文件和/或数据。仅限公司自有设备。
configureWifi

enum (ConfigureWifi)

控制 Wi-Fi 配置权限。根据设置的选项，用户在配置 Wi-Fi 网络时将拥有完全控制权、有限控制权或无控制权。
wifiDirectSettings

enum (WifiDirectSettings)

控制配置和使用 Wi-Fi Direct 设置。在搭载 Android 13 及更高版本的公司自有设备上受支持。
tetheringSettings

enum (TetheringSettings)

控制网络共享设置。根据设置的值，部分或完全禁止用户使用不同形式的网络共享。
wifiSsidPolicy

object (WifiSsidPolicy)

限制设备可以连接到的 Wi-Fi SSID。请注意，这不会影响可在设备上配置的网络。在搭载 Android 13 及更高版本的公司自有设备上受支持。
wifiRoamingPolicy

object (WifiRoamingPolicy)

可选。Wi-Fi 漫游政策。
bluetoothSharing

enum (BluetoothSharing)

可选。控制是否允许蓝牙共享。
preferentialNetworkServiceSettings

object (PreferentialNetworkServiceSettings)

可选。优先网络服务配置。设置此字段会覆盖 preferentialNetworkService。此设置可在搭载 Android 13 及更高版本的设备上针对工作资料和完全受管设备进行设置。如需了解详情，请参阅 5G 网络切片指南。
apnPolicy

object (ApnPolicy)

可选。接入点名称 (APN) 政策。接入点名称 (APN) 的配置，可能会替换设备上的任何其他 APN。如需了解详情，请参阅 OVERRIDE_APNS_ENABLED 和 overrideApns。

UsbDataAccess

控制可通过 USB 传输哪些文件和/或数据。不会影响充电功能。仅限公司自有设备。

枚举
USB_DATA_ACCESS_UNSPECIFIED 未指定。默认为 DISALLOW_USB_FILE_TRANSFER。
ALLOW_USB_DATA_TRANSFER 允许所有类型的 USB 数据传输。系统会忽略 usbFileTransferDisabled。
DISALLOW_USB_FILE_TRANSFER 不允许通过 USB 传输文件。允许其他类型的 USB 数据连接，例如鼠标和键盘连接。系统会忽略 usbFileTransferDisabled。
DISALLOW_USB_DATA_TRANSFER 设置后，系统会禁止所有类型的 USB 数据传输。适用于搭载 Android 12 或更高版本且使用 USB HAL 1.3 或更高版本的设备。如果不支持该设置，则会设置 DISALLOW_USB_FILE_TRANSFER。如果 Android 版本低于 12，则报告 API_LEVEL 的 NonComplianceDetail。如果设备没有 USB HAL 1.3 或更高版本，则会报告 DEVICE_INCOMPATIBLE 的 NonComplianceDetail。系统会忽略 usbFileTransferDisabled。

ConfigureWifi

控制 Wi-Fi 配置权限。根据所设置的选项，用户在配置 Wi-Fi 网络时将拥有完全控制权、有限控制权或无控制权。

枚举
CONFIGURE_WIFI_UNSPECIFIED 未指定。除非将 wifiConfigDisabled 设置为 true，否则默认为 ALLOW_CONFIGURING_WIFI。如果 wifiConfigDisabled 设置为 true，则相当于 DISALLOW_CONFIGURING_WIFI。
ALLOW_CONFIGURING_WIFI 允许用户配置 Wi-Fi。系统会忽略 wifiConfigDisabled。
DISALLOW_ADD_WIFI_CONFIG 不允许添加新的 Wi-Fi 配置。用户只能在已配置的网络之间切换。在搭载 Android 13 及更高版本的全托管式设备和公司自有设备上的工作资料中受支持。如果不支持该设置，则会设置 ALLOW_CONFIGURING_WIFI。如果 Android 版本低于 13，则报告 NonComplianceDetail（含 API_LEVEL）。系统会忽略 wifiConfigDisabled。
DISALLOW_CONFIGURING_WIFI 禁止配置 Wi-Fi 网络。设置此值时，系统会忽略 wifiConfigDisabled 设置。在完全受管设备和公司自有设备上的工作资料中受支持，适用于所有受支持的 API 级别。对于完全受管理的设备，设置此标志会移除所有已配置的网络，并仅保留使用 openNetworkConfiguration 政策配置的网络。对于公司自有设备上的工作资料，现有已配置的网络不受影响，用户无法添加、移除或修改 Wi-Fi 网络。注意：如果在启动时无法建立网络连接，并且 Wi-Fi 配置处于停用状态，系统会显示网络紧急出口，以便刷新设备政策（请参阅 networkEscapeHatchEnabled）。

WifiDirectSettings

控制 Wi-Fi 直连设置。在搭载 Android 13 及更高版本的公司自有设备上受支持。

枚举
WIFI_DIRECT_SETTINGS_UNSPECIFIED 未指定。默认设置为 ALLOW_WIFI_DIRECT
ALLOW_WIFI_DIRECT 用户可以正常使用 Wi-Fi Direct。
DISALLOW_WIFI_DIRECT 用户不得使用 Wi-Fi Direct。如果 Android 版本低于 13，则报告 API_LEVEL 的 NonComplianceDetail。

TetheringSettings

控制用户在多大程度上可以使用不同形式的网络共享，例如 WLAN 网络共享、蓝牙网络共享等。

枚举
TETHERING_SETTINGS_UNSPECIFIED 未指定。除非将 tetheringConfigDisabled 设置为 true，否则默认为 ALLOW_ALL_TETHERING。如果 tetheringConfigDisabled 设置为 true，则相当于 DISALLOW_ALL_TETHERING。
ALLOW_ALL_TETHERING 允许配置和使用所有形式的网络共享。系统会忽略 tetheringConfigDisabled。
DISALLOW_WIFI_TETHERING 禁止用户使用 Wi-Fi 网络共享。在搭载 Android 13 及更高版本的公司自有设备上受支持。如果不支持该设置，则会设置 ALLOW_ALL_TETHERING。如果 Android 版本低于 13，则报告 NonComplianceDetail（含 API_LEVEL）。系统会忽略 tetheringConfigDisabled。
DISALLOW_ALL_TETHERING 禁止所有形式的网络共享。在完全受管设备和公司自有设备上的工作资料中受支持，适用于所有受支持的 Android 版本。系统会忽略 tetheringConfigDisabled 设置。

WifiSsidPolicy

限制设备可以连接到的 Wi-Fi SSID。请注意，这不会影响可在设备上配置的网络。在搭载 Android 13 及更高版本的公司自有设备上受支持。

JSON 表示法 
{
  "wifiSsidPolicyType": enum (WifiSsidPolicyType),
  "wifiSsids": [
    {
      object (WifiSsid)
    }
  ]
}
字段
wifiSsidPolicyType

enum (WifiSsidPolicyType)

要应用的 Wi-Fi SSID 政策的类型。
wifiSsids[]

object (WifiSsid)

可选。应在政策中应用的 Wi-Fi SSID 列表。当 WifiSsidPolicyType 设置为 WIFI_SSID_ALLOWLIST 时，此字段不得为空。如果此属性设置为非空列表，则当 Android 版本低于 13 时，系统会报告包含 API_LEVEL 的 NonComplianceDetail 详细信息；对于非公司自有设备，系统会报告包含 MANAGEMENT_MODE 的 NonComplianceDetail。

WifiSsidPolicyType

可应用于设备的 Wi-Fi SSID 政策类型。

枚举
WIFI_SSID_POLICY_TYPE_UNSPECIFIED 默认为 WIFI_SSID_DENYLIST。不得设置 wifiSsids。设备可以连接到任何 SSID。
WIFI_SSID_DENYLIST 设备无法连接到 SSID 位于 wifiSsids 中的任何 Wi-Fi 网络，但可以连接到其他网络。
WIFI_SSID_ALLOWLIST 设备只能连接到 wifiSsids 中的 SSID。wifiSsids 不能为空。设备将无法连接到任何其他 Wi-Fi 网络。

WifiSsid

表示 Wi-Fi SSID。

JSON 表示法 
{
  "wifiSsid": string
}
字段
wifiSsid

string

必需。以字符串表示的 Wi-Fi SSID。

WifiRoamingPolicy

Wi-Fi 漫游政策。

JSON 表示法 
{
  "wifiRoamingSettings": [
    {
      object (WifiRoamingSetting)
    }
  ]
}
字段
wifiRoamingSettings[]

object (WifiRoamingSetting)

可选。Wi-Fi 漫游设置。此列表中提供的 SSID 必须是唯一的，否则系统会拒绝相应政策。

WifiRoamingSetting

Wi-Fi 漫游设置。

JSON 表示法 
{
  "wifiSsid": string,
  "wifiRoamingMode": enum (WifiRoamingMode)
}
字段
wifiSsid

string

必需。Wi-Fi 网络的 SSID。
wifiRoamingMode

enum (WifiRoamingMode)

必需。指定 SSID 的 Wi-Fi 漫游模式。

WifiRoamingMode

WLAN 漫游模式。

枚举
WIFI_ROAMING_MODE_UNSPECIFIED 未指定。默认为 WIFI_ROAMING_DEFAULT。
WIFI_ROAMING_DISABLED Wi-Fi 漫游已停用。在 Android 15 及更高版本中，完全受管理的设备和公司自有设备上的工作资料支持此功能。对于其他管理模式，系统会报告 NonComplianceDetail（含 MANAGEMENT_MODE）。如果 Android 版本低于 15，则报告 NonComplianceDetail（含 API_LEVEL）。
WIFI_ROAMING_DEFAULT 设备的默认 Wi-Fi 漫游模式。
WIFI_ROAMING_AGGRESSIVE 激进漫游模式，可实现更快的 Wi-Fi 漫游。在 Android 15 及更高版本中，完全受管理的设备和公司自有设备上的工作资料支持此功能。对于其他管理模式，系统会报告 NonComplianceDetail（含 MANAGEMENT_MODE）。如果 Android 版本低于 15，则报告 NonComplianceDetail（含 API_LEVEL）。如果设备不支持激进漫游模式，则报告 NonComplianceDetail（值为 DEVICE_INCOMPATIBLE）。

BluetoothSharing

控制是否允许蓝牙共享。

枚举
BLUETOOTH_SHARING_UNSPECIFIED 未指定。默认为工作资料中的 BLUETOOTH_SHARING_DISALLOWED 和完全受管设备中的 BLUETOOTH_SHARING_ALLOWED。
BLUETOOTH_SHARING_ALLOWED

允许蓝牙共享。

支持 Android 8 及更高版本。如果 Android 版本低于 8，则工作资料上会报告带有 API_LEVEL 的 NonComplianceDetail。
BLUETOOTH_SHARING_DISALLOWED

不允许进行蓝牙共享。

支持 Android 8 及更高版本。如果 Android 版本低于 8，则会在全托管式设备上报告具有 API_LEVEL 的 NonComplianceDetail。

PreferentialNetworkServiceSettings

优选网络服务设置。

JSON 表示法 
{
  "preferentialNetworkServiceConfigs": [
    {
      object (PreferentialNetworkServiceConfig)
    }
  ],
  "defaultPreferentialNetworkId": enum (PreferentialNetworkId)
}
字段
preferentialNetworkServiceConfigs[]

object (PreferentialNetworkServiceConfig)

必需。优先网络服务配置，可实现多个企业切片。不得有多个具有相同 preferentialNetworkId 的配置。如果某个配置未通过设置 ApplicationPolicy.preferentialNetworkId 或 defaultPreferentialNetworkId 被任何应用引用，则会被忽略。对于使用 4G 网络的设备，还需要配置企业 APN，以便设置数据通话来使用优先网络服务。可以使用 apnPolicy 添加这些 APN。
defaultPreferentialNetworkId

enum (PreferentialNetworkId)

必需。不在 applications 中的应用的默认优先网络 ID，或者当 ApplicationPolicy.preferentialNetworkId 设置为 PREFERENTIAL_NETWORK_ID_UNSPECIFIED 时应用的默认优先网络 ID。除非将此属性设置为 NO_PREFERENTIAL_NETWORK，否则 preferentialNetworkServiceConfigs 中必须包含指定网络 ID 的配置。如果设置为 PREFERENTIAL_NETWORK_ID_UNSPECIFIED 或未设置，则默认为 NO_PREFERENTIAL_NETWORK。注意：如果默认的优先网络配置错误，未设置 ApplicationPolicy.preferentialNetworkId 的应用将无法访问互联网。此设置不适用于以下关键应用：

  • com.google.android.apps.work.clouddpc
  • com.google.android.gms

ApplicationPolicy.preferentialNetworkId 仍可用于为其配置首选网络。

PreferentialNetworkServiceConfig

个性化偏好网络服务配置。

JSON 表示法 
{
  "preferentialNetworkId": enum (PreferentialNetworkId),
  "fallbackToDefaultConnection": enum (FallbackToDefaultConnection),
  "nonMatchingNetworks": enum (NonMatchingNetworks)
}
字段
preferentialNetworkId

enum (PreferentialNetworkId)

必需。优先网络标识符。不得将其设置为 NO_PREFERENTIAL_NETWORK 或 PREFERENTIAL_NETWORK_ID_UNSPECIFIED，否则系统会拒绝该政策。
fallbackToDefaultConnection

enum (FallbackToDefaultConnection)

可选。是否允许回退到设备级默认网络。如果此政策设置为 FALLBACK_TO_DEFAULT_CONNECTION_ALLOWED，则 nonMatchingNetworks 不得设置为 NON_MATCHING_NETWORKS_DISALLOWED，否则该政策将被拒绝。注意：如果此设置设为 FALLBACK_TO_DEFAULT_CONNECTION_DISALLOWED，则在 5G 切片不可用的情况下，应用将无法访问互联网。
nonMatchingNetworks

enum (NonMatchingNetworks)

可选。此配置所适用的应用是否被禁止使用优先服务以外的网络。如果此字段设置为 NON_MATCHING_NETWORKS_DISALLOWED，则 fallbackToDefaultConnection 必须设置为 FALLBACK_TO_DEFAULT_CONNECTION_DISALLOWED。

FallbackToDefaultConnection

是否允许回退到设备级默认网络。请注意，虽然此设置决定了受此配置约束的应用在没有首选服务时是否具有默认网络，但应用仍然可以通过向系统请求来明确决定使用除默认网络之外的其他网络。此设置不决定是否阻止应用使用此类其他网络。请参阅 nonMatchingNetworks 了解此设置。

枚举
FALLBACK_TO_DEFAULT_CONNECTION_UNSPECIFIED 未指定。默认为 FALLBACK_TO_DEFAULT_CONNECTION_ALLOWED。
FALLBACK_TO_DEFAULT_CONNECTION_ALLOWED 允许回退到默认连接。如果设置了此政策，则不得将 nonMatchingNetworks 设置为 NON_MATCHING_NETWORKS_DISALLOWED，否则系统会拒绝该政策。
FALLBACK_TO_DEFAULT_CONNECTION_DISALLOWED 不允许回退到默认连接。

NonMatchingNetworks

此配置所适用的应用是否允许使用优先服务以外的网络。应用可以检查设备上可用的网络列表，并出于性能、隐私或其他原因选择同时使用多个网络。

枚举
NON_MATCHING_NETWORKS_UNSPECIFIED 未指定。默认为 NON_MATCHING_NETWORKS_ALLOWED。
NON_MATCHING_NETWORKS_ALLOWED 应用此配置的应用可以使用优先服务以外的网络。
NON_MATCHING_NETWORKS_DISALLOWED 应用此配置的应用不得使用优先服务以外的其他网络。此设置可在 Android 14 及更高版本上进行。如果 Android 版本低于 14，则报告具有 API_LEVEL 的 NonComplianceDetail。如果设置了此值，则 fallbackToDefaultConnection 必须设置为 FALLBACK_TO_DEFAULT_CONNECTION_DISALLOWED，否则系统会拒绝该政策。

ApnPolicy

接入点名称 (APN) 政策。接入点名称 (APN) 的配置，可能会替换设备上的任何其他 APN。如需了解详情，请参阅 OVERRIDE_APNS_ENABLED 和 overrideApns。

JSON 表示法 
{
  "overrideApns": enum (OverrideApns),
  "apnSettings": [
    {
      object (ApnSetting)
    }
  ]
}
字段
overrideApns

enum (OverrideApns)

可选。替换 APN 是处于停用状态还是启用状态。如需了解详情，请参阅 DevicePolicyManager.setOverrideApnsEnabled。
apnSettings[]

object (ApnSetting)

可选。用于替换 APN 的 APN 设置。所提供的任何 APN 设置之间不得存在任何冲突，否则系统将拒绝相应政策。如果两个 ApnSetting 的以下所有字段都匹配，则这两个 ApnSetting 被视为冲突：numericOperatorId、apn、proxyAddress、proxyPort、mmsProxyAddress、mmsProxyPort、mmsc、mvnoType、protocol、roamingProtocol。如果部分 APN 设置导致不符合 INVALID_VALUE，则这些设置将被忽略。此设置可在搭载 Android 10 及更高版本的完全受管设备上进行。此设置还可以在 Android 13 及更高版本的工作资料上进行，但仅适用于具有 ENTERPRISE APN 类型的 ApnSetting。如果 Android 版本低于 10，则报告 API_LEVEL 的 NonComplianceDetail。对于 Android 13 之前的版本，工作资料会报告 NonComplianceDetail，并带有 MANAGEMENT_MODE。

OverrideApns

替换 APN 是处于停用状态还是启用状态。如需了解详情，请参阅 DevicePolicyManager.setOverrideApnsEnabled。

枚举
OVERRIDE_APNS_UNSPECIFIED 未指定。默认为 OVERRIDE_APNS_DISABLED。
OVERRIDE_APNS_DISABLED 替换 APN 已停用。所有已配置的 apnSettings 都会保存在设备上，但处于停用状态，不会产生任何影响。设备上的任何其他 APN 仍在使用中。
OVERRIDE_APNS_ENABLED 已启用替换 APN。仅使用替换 APN，忽略任何其他 APN。此设置只能在搭载 Android 10 及更高版本的完全托管设备上进行。对于工作资料，可通过 preferentialNetworkServiceSettings 启用替换 APN，因此无法设置此值。如果 Android 版本低于 10，则报告 API_LEVEL 的 NonComplianceDetail。系统会针对工作资料报告 MANAGEMENT_MODE 的 NonComplianceDetail。

ApnSetting

运营商数据连接的接入点名称 (APN) 配置。APN 提供配置，以将移动网络设备连接到 IP 数据网络。运营商会使用此设置来决定要分配的 IP 地址、要应用的安全方法，以及设备可能如何连接到专用网络。

JSON 表示法 
{
  "apnTypes": [
    enum (ApnType)
  ],
  "apn": string,
  "displayName": string,
  "alwaysOnSetting": enum (AlwaysOnSetting),
  "authType": enum (AuthType),
  "carrierId": integer,
  "mmsProxyAddress": string,
  "mmsProxyPort": integer,
  "mmsc": string,
  "mtuV4": integer,
  "mtuV6": integer,
  "mvnoType": enum (MvnoType),
  "networkTypes": [
    enum (NetworkType)
  ],
  "username": string,
  "password": string,
  "numericOperatorId": string,
  "protocol": enum (Protocol),
  "roamingProtocol": enum (Protocol),
  "proxyAddress": string,
  "proxyPort": integer
}
字段
apnTypes[]

enum (ApnType)

必需。APN 的使用类别。如果此字段为空或包含 APN_TYPE_UNSPECIFIED 或重复项，则政策将被拒绝。完全托管的设备上可以设置多种 APN 类型。ENTERPRISE 是工作资料中唯一允许的 APN 类型。对于工作资料中的任何其他值，系统都会报告 MANAGEMENT_MODE 的 NonComplianceDetail。设备或管理模式不支持的 APN 类型将被忽略。如果这导致列表为空，则系统会忽略 APN 设置，因为 apnTypes 是必填字段。如果设备或管理模式不支持任何 APN 类型，则报告 NonComplianceDetail（值为 INVALID_VALUE）。
apn

string

必需。APN 的名称。如果此字段为空，政策将被拒绝。
displayName

string

必需。描述 APN 的直观易懂的名称。如果此字段为空，政策将被拒绝。
alwaysOnSetting

enum (AlwaysOnSetting)

可选。在每次从 CM-IDLE 模式转换到 CM-CONNECTED 状态时，是否必须为此 APN 激活用户平面资源。请参阅 3GPP TS 23.501 第 5.6.13 节。
authType

enum (AuthType)

可选。APN 的身份验证类型。
carrierId

integer

可选。APN 的运营商 ID。值为 0（默认值）表示未设置，负值会被拒绝。
mmsProxyAddress

string

可选。APN 的 MMS（多媒体消息服务）代理地址，可以是 IP 地址或主机名（而非网址）。
mmsProxyPort

integer

可选。APN 的彩信（多媒体消息服务）代理端口。值为 0（默认值）表示未设置，负值会被拒绝。
mmsc

string

可选。APN 的 MMSC（多媒体消息服务中心）URI。
mtuV4

integer

可选。此 APN 设置所建立的 IPv4 路由的默认 MTU（最大传输单元）大小（以字节为单位）。值为 0（默认值）表示未设置，负值会被拒绝。Android 13 及更高版本支持此功能。如果 Android 版本低于 13，则报告 API_LEVEL 的 NonComplianceDetail。
mtuV6

integer

可选。APN 连接到的 IPv6 移动接口的 MTU（最大传输单元）大小。值为 0（默认值）表示未设置，负值会被拒绝。Android 13 及更高版本支持此功能。如果 Android 版本低于 13，则报告 API_LEVEL 的 NonComplianceDetail。
mvnoType

enum (MvnoType)

可选。相应 APN 的 MVNO 匹配类型。
networkTypes[]

enum (NetworkType)

可选。APN 可能使用的无线电技术（网络类型）。如果此字段包含 NETWORK_TYPE_UNSPECIFIED 或重复项，则政策将被拒绝。
username

string

可选。相应 APN 的 APN 用户名。
password

string

可选。相应 APN 的 APN 密码。
numericOperatorId

string

可选。APN 的数字运营商 ID。数字运营商 ID 定义为 MCC（移动设备国家/地区代码）+ MNC（移动网络代码）。
protocol

enum (Protocol)

可选。用于连接到相应 APN 的协议。
roamingProtocol

enum (Protocol)

可选。设备漫游时用于连接到相应 APN 的协议。
proxyAddress

string

可选。APN 的代理地址。
proxyPort

integer

可选。APN 的代理端口。值为 0（默认值）表示未设置，负值会被拒绝。

ApnType

APN 的使用类别。

枚举
APN_TYPE_UNSPECIFIED 未指定。未使用此值。
ENTERPRISE 企业流量的 APN 类型。Android 13 及更高版本支持此功能。如果 Android 版本低于 13，则报告 API_LEVEL 的 NonComplianceDetail。
BIP BIP（独立于载体的协议）的 APN 类型。此设置只能在搭载 Android 12 及更高版本的完全受管设备上进行。如果 Android 版本低于 12，则报告 API_LEVEL 的 NonComplianceDetail。系统会针对工作资料报告 MANAGEMENT_MODE 的 NonComplianceDetail。
CBS CBS（运营商品牌服务）的 APN 类型。此设置只能在完全受管设备上进行。系统会针对工作资料报告 MANAGEMENT_MODE 的 NonComplianceDetail。
DEFAULT 默认数据流量的 APN 类型。此设置只能在完全受管设备上进行。系统会针对工作资料报告 MANAGEMENT_MODE 的 NonComplianceDetail。
DUN DUN（拨号网络）流量的 APN 类型。此设置只能在完全受管设备上进行。系统会针对工作资料报告 MANAGEMENT_MODE 的 NonComplianceDetail。
EMERGENCY 紧急 PDN 的 APN 类型。这不是 IA APN，但用于在紧急呼叫情况下访问运营商服务。此设置只能在完全受管设备上进行。系统会针对工作资料报告 MANAGEMENT_MODE 的 NonComplianceDetail。
FOTA 用于访问运营商的 FOTA（固件无线下载）门户的 APN 类型，用于无线下载更新。此设置只能在完全受管设备上进行。系统会针对工作资料报告 MANAGEMENT_MODE 的 NonComplianceDetail。
HIPRI HiPri（高优先级）流量的 APN 类型。此设置只能在完全受管设备上进行。系统会针对工作资料报告 MANAGEMENT_MODE 的 NonComplianceDetail。
IA IA（初始连接）APN 的 APN 类型。此设置只能在完全受管设备上进行。系统会针对工作资料报告 MANAGEMENT_MODE 的 NonComplianceDetail。
IMS IMS（IP 多媒体子系统）流量的 APN 类型。此设置只能在完全受管设备上进行。系统会针对工作资料报告 MANAGEMENT_MODE 的 NonComplianceDetail。
MCX MCX（关键任务服务）的 APN 类型，其中 X 可以是 PTT/视频/数据。此设置只能在完全受管设备上进行。系统会针对工作资料报告 MANAGEMENT_MODE 的 NonComplianceDetail。
MMS 彩信 (MMS) 流量的 APN 类型。此设置只能在完全受管设备上进行。系统会针对工作资料报告 MANAGEMENT_MODE 的 NonComplianceDetail。
RCS RCS（富通讯解决方案）的 APN 类型。此设置只能在搭载 Android 15 及更高版本的完全受管设备上进行。如果 Android 版本低于 15，则报告 NonComplianceDetail（含 API_LEVEL）。系统会针对工作资料报告 MANAGEMENT_MODE 的 NonComplianceDetail。
SUPL 适用于 SUPL（安全用户平面定位）辅助 GPS 的 APN 类型。此设置只能在完全受管设备上进行。系统会针对工作资料报告 MANAGEMENT_MODE 的 NonComplianceDetail。
VSIM VSIM（虚拟 SIM 卡）服务的 APN 类型。此设置只能在搭载 Android 12 及更高版本的完全受管设备上进行。如果 Android 版本低于 12，则报告 API_LEVEL 的 NonComplianceDetail。系统会针对工作资料报告 MANAGEMENT_MODE 的 NonComplianceDetail。
XCAP XCAP（XML 配置访问协议）流量的 APN 类型。此设置只能在搭载 Android 11 及更高版本的完全受管设备上进行。如果 Android 版本低于 11，则会报告带有 API_LEVEL 的 NonComplianceDetail。系统会针对工作资料报告 MANAGEMENT_MODE 的 NonComplianceDetail。

AlwaysOnSetting

在每次从 CM-IDLE 模式转换到 CM-CONNECTED 状态时，是否必须为此 APN 激活用户平面资源。请参阅 3GPP TS 23.501 第 5.6.13 节。

枚举
ALWAYS_ON_SETTING_UNSPECIFIED 未指定。默认为 NOT_ALWAYS_ON。
NOT_ALWAYS_ON 此 APN 建立的 PDU 会话不应始终处于开启状态。
ALWAYS_ON 此 APN 建立的 PDU 会话应始终处于开启状态。在 Android 15 及更高版本上受支持。如果 Android 版本低于 15，则报告 NonComplianceDetail（含 API_LEVEL）。

AuthType

APN 的身份验证类型。

枚举
AUTH_TYPE_UNSPECIFIED 未指定。如果 username 为空，则默认为 NONE。否则，默认为 PAP_OR_CHAP。
NONE 无需进行身份验证。
PAP PAP 的身份验证类型。
CHAP CHAP 的身份验证类型。
PAP_OR_CHAP PAP 或 CHAP 的身份验证类型。

MvnoType

相应 APN 的 MVNO 匹配类型。

枚举
MVNO_TYPE_UNSPECIFIED 未指定 MVNO 类型。
GID 组标识符级别 1 的 MVNO 类型。
ICCID 相应 ICCID 的 MVNO 类型。
IMSI IMSI 的 MVNO 类型。
SPN SPN（服务提供商名称）的 MVNO 类型。

NetworkType

APN 可能使用的无线电技术（网络类型）。

枚举
NETWORK_TYPE_UNSPECIFIED 未指定。不得使用此值。
EDGE 无线电技术 EDGE。
GPRS 无线电技术 GPRS。
GSM 无线电技术 GSM。
HSDPA 无线电技术 HSDPA。
HSPA 无线电技术 HSPA。
HSPAP 无线电技术 HSPAP。
HSUPA 无线电技术 HSUPA。
IWLAN 无线电技术 IWLAN。
LTE 无线电技术 LTE。
NR 无线电技术 NR（新无线电）5G。
TD_SCDMA 无线电技术 TD_SCDMA。
UMTS 无线电技术 UMTS。

协议

用于连接到 APN 的协议。

枚举
PROTOCOL_UNSPECIFIED 未指定协议。
IP 互联网协议。
IPV4V6 引入了虚拟 PDP 类型，以处理双 IP 栈 UE 功能。
IPV6 互联网协议，版本 6。
NON_IP 将非 IP 数据传输到外部数据包数据网络。
PPP 点对点协议。
UNSTRUCTURED 通过 N6 将非结构化数据传输到数据网络。

DeviceRadioState

用于控制设备无线装置设置。

JSON 表示法 
{
  "wifiState": enum (WifiState),
  "airplaneModeState": enum (AirplaneModeState),
  "ultraWidebandState": enum (UltraWidebandState),
  "cellularTwoGState": enum (CellularTwoGState),
  "minimumWifiSecurityLevel": enum (MinimumWifiSecurityLevel)
}
字段
wifiState

enum (WifiState)

控制 Wi-Fi 的当前状态以及用户是否可以更改其状态。
airplaneModeState

enum (AirplaneModeState)

控制用户是否可以切换飞行模式。
ultraWidebandState

enum (UltraWidebandState)

控制超宽带设置的状态，以及用户是否可以开启或关闭该设置。
cellularTwoGState

enum (CellularTwoGState)

控制用户是否可以切换移动网络 2G 设置。
minimumWifiSecurityLevel

enum (MinimumWifiSecurityLevel)

设备可连接的 Wi-Fi 网络的最低必需安全级别。

WifiState

控制 Wi-Fi 是开启还是关闭（作为一种状态），以及用户是否可以更改该状态。在搭载 Android 13 及更高版本的公司自有设备上受支持。

枚举
WIFI_STATE_UNSPECIFIED 未指定。默认设置为 WIFI_STATE_USER_CHOICE
WIFI_STATE_USER_CHOICE 允许用户启用/停用 Wi-Fi。
WIFI_ENABLED WLAN 已开启，且用户无法将其关闭。如果 Android 版本低于 13，则会报告 API_LEVEL 的 NonComplianceDetail。
WIFI_DISABLED Wi-Fi 已关闭，且不允许用户开启。如果 Android 版本低于 13，则报告 API_LEVEL 的 NonComplianceDetail。

AirplaneModeState

控制飞行模式的状态以及用户是否可以开启或关闭飞行模式。支持 Android 9 及更高版本。完全受管理的设备和公司自有设备上的工作资料支持此设置。

枚举
AIRPLANE_MODE_STATE_UNSPECIFIED 未指定。默认为 AIRPLANE_MODE_USER_CHOICE。
AIRPLANE_MODE_USER_CHOICE 允许用户开启或关闭飞行模式。
AIRPLANE_MODE_DISABLED 飞行模式已停用。用户无法开启飞行模式。如果 Android 版本低于 9，则会报告 NonComplianceDetail，并显示 API_LEVEL。

UltraWidebandState

控制超宽带设置的状态以及用户是否可以开启或关闭该设置。支持 Android 14 及更高版本。完全受管理的设备和公司自有设备上的工作资料支持此设置。

枚举
ULTRA_WIDEBAND_STATE_UNSPECIFIED 未指定。默认为 ULTRA_WIDEBAND_USER_CHOICE。
ULTRA_WIDEBAND_USER_CHOICE 允许用户开启或关闭超宽带。
ULTRA_WIDEBAND_DISABLED 超宽带已停用。用户无法通过设置开启超宽带。如果 Android 版本低于 14，则报告具有 API_LEVEL 的 NonComplianceDetail。

CellularTwoGState

控制移动网络 2G 设置的状态，以及用户是否可以开启或关闭该设置。支持 Android 14 及更高版本。完全受管理的设备和公司自有设备上的工作资料支持此设置。

枚举
CELLULAR_TWO_G_STATE_UNSPECIFIED 未指定。默认为 CELLULAR_TWO_G_USER_CHOICE。
CELLULAR_TWO_G_USER_CHOICE 允许用户开启或关闭移动 2G 网络。
CELLULAR_TWO_G_DISABLED 移动网络 2G 已停用。用户无法通过设置开启移动 2G 网络。如果 Android 版本低于 14，则报告具有 API_LEVEL 的 NonComplianceDetail。

MinimumWifiSecurityLevel

定义了连接到 Wi-Fi 网络所需的各种最低 Wi-Fi 安全级别。Android 13 及更高版本支持此功能。完全受管理的设备和公司自有设备上的工作资料支持此设置。

枚举
MINIMUM_WIFI_SECURITY_LEVEL_UNSPECIFIED 默认值为 OPEN_NETWORK_SECURITY，这意味着设备将能够连接到所有类型的 Wi-Fi 网络。
OPEN_NETWORK_SECURITY 设备将能够连接到所有类型的 Wi-Fi 网络。
PERSONAL_NETWORK_SECURITY 个人网络（例如 WEP、WPA2-PSK）是最低要求的安全性。设备将无法连接到开放式 Wi-Fi 网络。这比 OPEN_NETWORK_SECURITY 更严格。如果 Android 版本低于 13，则报告 API_LEVEL 的 NonComplianceDetail。
ENTERPRISE_NETWORK_SECURITY 企业 EAP 网络是最低要求的安全级别。设备将无法连接到低于此安全级别的 Wi-Fi 网络。这比 PERSONAL_NETWORK_SECURITY 更严格。如果 Android 版本低于 13，则报告 API_LEVEL 的 NonComplianceDetail。
ENTERPRISE_BIT192_NETWORK_SECURITY 192 位企业网络是所需的最低安全级别。设备将无法连接到低于此安全级别的 Wi-Fi 网络。这比 ENTERPRISE_NETWORK_SECURITY 更严格。如果 Android 版本低于 13，则报告 API_LEVEL 的 NonComplianceDetail。

CredentialProviderPolicyDefault

控制哪些应用可以在 Android 14 及更高版本上充当凭据提供程序。这些应用会存储凭据，如需了解详情，请参阅这篇文章和这篇文章。另请参阅 credentialProviderPolicy。

枚举
CREDENTIAL_PROVIDER_POLICY_DEFAULT_UNSPECIFIED 未指定。默认值为 CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED。
CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED 不允许具有 credentialProviderPolicy 未指定值的应用充当凭据提供方。
CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED_EXCEPT_SYSTEM 除了 OEM 默认凭据提供程序之外，credentialProviderPolicy 未指定的应用不得充当凭据提供程序。OEM 默认凭据提供程序始终可以充当凭据提供程序。

PrintingPolicy

控制是否允许打印。搭载 Android 9 及更高版本的设备支持此功能。

枚举
PRINTING_POLICY_UNSPECIFIED 未指定。默认为 PRINTING_ALLOWED。
PRINTING_DISALLOWED 不允许打印。如果 Android 版本低于 9，则会报告 NonComplianceDetail，并显示 API_LEVEL。
PRINTING_ALLOWED 允许打印。

DisplaySettings

显示设置的控件。

JSON 表示法 
{
  "screenBrightnessSettings": {
    object (ScreenBrightnessSettings)
  },
  "screenTimeoutSettings": {
    object (ScreenTimeoutSettings)
  }
}
字段
screenBrightnessSettings

object (ScreenBrightnessSettings)

可选。控制屏幕亮度设置。
screenTimeoutSettings

object (ScreenTimeoutSettings)

可选。控制屏幕超时设置。

ScreenBrightnessSettings

用于控制屏幕亮度设置。

JSON 表示法 
{
  "screenBrightnessMode": enum (ScreenBrightnessMode),
  "screenBrightness": integer
}
字段
screenBrightnessMode

enum (ScreenBrightnessMode)

可选。控制屏幕亮度模式。
screenBrightness

integer

可选。介于 1 到 255 之间的屏幕亮度，其中 1 为最低亮度，255 为最高亮度。值为 0（默认值）表示未设置屏幕亮度。任何其他值都会被拒绝。screenBrightnessMode 必须为 BRIGHTNESS_AUTOMATIC 或 BRIGHTNESS_FIXED 才能设置此项。在全托管式设备上，此功能适用于 Android 9 及更高版本。如果 Android 版本低于 9，则会报告具有 API_LEVEL 的 NonComplianceDetail。在搭载 Android 15 及更高版本的公司自有设备上的工作资料中受支持。

ScreenBrightnessMode

控制屏幕亮度模式。

枚举
SCREEN_BRIGHTNESS_MODE_UNSPECIFIED 未指定。默认为 BRIGHTNESS_USER_CHOICE。
BRIGHTNESS_USER_CHOICE 允许用户配置屏幕亮度。不得设置 screenBrightness。
BRIGHTNESS_AUTOMATIC 屏幕亮度模式为自动，亮度会自动调整，用户无法配置屏幕亮度。您仍然可以设置 screenBrightness，系统在自动调节亮度时会考虑此设置。在全托管式设备上，此功能适用于 Android 9 及更高版本。如果 Android 版本低于 9，则会报告具有 API_LEVEL 的 NonComplianceDetail。在搭载 Android 15 及更高版本的公司自有设备上的工作资料中受支持。
BRIGHTNESS_FIXED 屏幕亮度模式固定，亮度设置为 screenBrightness，且不允许用户配置屏幕亮度。必须设置 screenBrightness。在全托管式设备上，此功能适用于 Android 9 及更高版本。如果 Android 版本低于 9，则会报告具有 API_LEVEL 的 NonComplianceDetail。在搭载 Android 15 及更高版本的公司自有设备上的工作资料中受支持。

ScreenTimeoutSettings

控制屏幕超时设置。

JSON 表示法 
{
  "screenTimeoutMode": enum (ScreenTimeoutMode),
  "screenTimeout": string
}
字段
screenTimeoutMode

enum (ScreenTimeoutMode)

可选。控制是否允许用户配置屏幕超时。
screenTimeout

string (Duration format)

可选。控制屏幕超时时长。屏幕超时时长必须大于 0，否则系统会拒绝。此外，它不应大于 maximumTimeToLock，否则屏幕超时时间会设置为 maximumTimeToLock，并报告 INVALID_VALUE 原因和 SCREEN_TIMEOUT_GREATER_THAN_MAXIMUM_TIME_TO_LOCK 具体原因的 NonComplianceDetail。如果屏幕超时时间小于某个下限，则将其设置为该下限。下限可能因设备而异。如果设置了此标志，则 screenTimeoutMode 必须为 SCREEN_TIMEOUT_ENFORCED。在全托管式设备上，此功能适用于 Android 9 及更高版本。如果 Android 版本低于 9，则会报告具有 API_LEVEL 的 NonComplianceDetail。在搭载 Android 15 及更高版本的公司自有设备上的工作资料中受支持。

该时长以秒为单位，最多包含九个小数位，以“s”结尾。示例："3.5s"。

ScreenTimeoutMode

控制是否允许用户配置屏幕超时。

枚举
SCREEN_TIMEOUT_MODE_UNSPECIFIED 未指定。默认为 SCREEN_TIMEOUT_USER_CHOICE。
SCREEN_TIMEOUT_USER_CHOICE 允许用户配置屏幕超时。不得设置 screenTimeout。
SCREEN_TIMEOUT_ENFORCED 屏幕超时时限设置为 screenTimeout，并且不允许用户配置超时时限。必须设置 screenTimeout。在全托管式设备上，此功能适用于 Android 9 及更高版本。如果 Android 版本低于 9，则会报告具有 API_LEVEL 的 NonComplianceDetail。在搭载 Android 15 及更高版本的公司自有设备上的工作资料中受支持。

AssistContentPolicy

控制是否允许将 AssistContent 发送到特权应用（例如辅助应用）。AssistContent 包括屏幕截图和有关应用的信息（例如软件包名称）。Android 15 及更高版本支持此功能。

枚举
ASSIST_CONTENT_POLICY_UNSPECIFIED 未指定。默认为 ASSIST_CONTENT_ALLOWED。
ASSIST_CONTENT_DISALLOWED

阻止将辅助内容发送到特权应用。

在 Android 15 及更高版本上受支持。如果 Android 版本低于 15，则报告 NonComplianceDetail（含 API_LEVEL）。
ASSIST_CONTENT_ALLOWED

允许将辅助内容发送到特权应用。

在 Android 15 及更高版本上受支持。

WorkAccountSetupConfig

控制工作账号设置配置，例如是否需要经过 Google 身份验证的账号。

JSON 表示法 
{
  "authenticationType": enum (AuthenticationType),
  "requiredAccountEmail": string
}
字段
authenticationType

enum (AuthenticationType)

可选。设备上用户的身份验证类型。
requiredAccountEmail

string

可选。要添加的特定 Google 工作账号电子邮件地址。只有当 authenticationType 为 GOOGLE_AUTHENTICATED 时，此字段才相关。此账号必须是企业账号，而非个人账号。设置此字段并将经过 Google 身份验证的账号添加到设备后，更改此字段将不会有任何效果，因此建议仅设置一次。

AuthenticationType

设备上用户的身份验证类型。

枚举
AUTHENTICATION_TYPE_UNSPECIFIED 未指定。默认为 AUTHENTICATION_TYPE_NOT_ENFORCED。
AUTHENTICATION_TYPE_NOT_ENFORCED 未强制执行设备上用户的身份验证状态。
GOOGLE_AUTHENTICATED 需要使用经过 Google 身份验证的账号来管理设备。

WipeDataFlag

擦除标志，用于指示因任何原因触发设备或个人资料擦除时要擦除哪些数据。（例如，当设备不合规时）。此属性不适用于 enterprises.devices.delete 方法。

枚举
WIPE_DATA_FLAG_UNSPECIFIED 不得使用此值。
WIPE_ESIMS 对于公司自有设备，在 wipeDataFlags 中设置此项后，当因任何原因触发擦除时，系统会移除设备上的所有 eSIM 卡。在个人自带设备上，此操作只会移除设备上的受管理 eSIM 卡。（通过 ADD_ESIM 命令添加的 eSIM 卡）。搭载 Android 15 及更高版本的设备支持此功能。如果 Android 版本低于 15，则报告 NonComplianceDetail（含 API_LEVEL）。

EnterpriseDisplayNameVisibility

控制 enterpriseDisplayName 是否在设备上显示（例如公司自有设备上的锁定屏幕消息）。

枚举
ENTERPRISE_DISPLAY_NAME_VISIBILITY_UNSPECIFIED 未指定。默认显示设备设置时设置的企业名称。未来，此值将默认为 ENTERPRISE_DISPLAY_NAME_VISIBLE。
ENTERPRISE_DISPLAY_NAME_VISIBLE 企业显示名称会显示在设备上。在 Android 7 及更高版本的工作资料中受支持。此设置适用于搭载 Android 8 及更高版本的完全受管设备。如果 Android 版本低于 7，则报告具有 API_LEVEL 的 NonComplianceDetail。在搭载 Android 7 的全代管式设备上，系统会报告 NonComplianceDetail（含 MANAGEMENT_MODE）。
ENTERPRISE_DISPLAY_NAME_HIDDEN 企业显示名称在设备上处于隐藏状态。

AppFunctions

控制是否允许完全受管理的设备上的应用或具有工作资料的设备上的工作资料中的应用公开应用功能。

枚举
APP_FUNCTIONS_UNSPECIFIED 未指定。默认为 APP_FUNCTIONS_ALLOWED。
APP_FUNCTIONS_DISALLOWED 全托管式设备上的应用或具有工作资料的设备上的工作资料中的应用不得公开应用功能。如果设置了此政策，则不得将 crossProfileAppFunctions 设置为 CROSS_PROFILE_APP_FUNCTIONS_ALLOWED，否则系统将拒绝该政策。
APP_FUNCTIONS_ALLOWED 完全受管理的设备上的应用或具有工作资料的设备上的工作资料中的应用可以公开应用功能。

方法

delete

 删除政策。

get

 获取政策。

list

 列出指定企业的政策。

modifyPolicyApplications

 更新或创建政策中的应用。

patch

 更新或创建政策。

removePolicyApplications

 移除政策中的应用。