REST Resource: enterprises.policies

資源:政策

政策資源代表一組設定,可控管受管理裝置行為,以及裝置上安裝的應用程式。

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)
}
欄位
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)

預設意圖處理常式活動。

openNetworkConfiguration

object (Struct format)

裝置的網路設定。詳情請參閱設定網路

systemUpdate

object (SystemUpdate)

系統更新政策:控管 OS 更新的套用方式。如果更新類型為 WINDOWED,更新視窗也會自動套用至 Play 應用程式更新。

注意: Google Play 系統更新 (也稱為 Mainline 更新) 會自動下載,且需要重新啟動裝置才能安裝。詳情請參閱「管理系統更新」中的主要部分。

accountTypesWithManagementDisabled[]

string

使用者無法管理的帳戶類型。

addUserDisabled

boolean

是否無法新增使用者和個人資料。

adjustVolumeDisabled

boolean

是否停用調整主磁碟區功能。同時將裝置設為靜音。

factoryResetDisabled

boolean

是否停用透過設定恢復原廠設定的功能。

installAppsDisabled

boolean

是否停用使用者安裝應用程式的功能。

mountPhysicalMediaDisabled

boolean

使用者是否停用掛接實體外部媒體。

modifyAccountsDisabled

boolean

新增或移除帳戶的功能已停用。

safeBootDisabled
(deprecated)

boolean

「重新啟動裝置」是否安全啟動功能已停用。

uninstallAppsDisabled

boolean

是否停用使用者解除安裝應用程式功能。這可以防止使用者解除安裝應用程式,即使是透過 applications 移除的應用程式也一樣

statusBarDisabled
(deprecated)

boolean

是否停用狀態列。這會停用通知、快速設定以及其他允許從全螢幕模式跳脫的螢幕重疊顯示。已淘汰。如要停用資訊站裝置上的狀態列,請使用 InstallType KIOSKkioskCustomLauncherEnabled

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_LOWCOMPLEXITY_MEDIUMCOMPLEXITY_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 的 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 Proxy。一般來說,openNetworkConfiguration 中應為每個網路設定 Proxy。不過,對於一般設定 (例如一般內部篩選) 來說,我們會建議你使用全域 HTTP Proxy。如果無法存取 Proxy,網路存取權可能會中斷。全域 Proxy 只是建議項目,有些應用程式可能會忽略這項 Proxy。

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_POSTPONEDAUTO_UPDATE_HIGH_PRIORITY 時,這個欄位不會有任何作用。

應用程式自動更新政策,可控管可套用自動更新應用程式的時間。

kioskCustomLauncherEnabled

boolean

是否已啟用資訊站自訂啟動器。這會將主畫面替換為啟動器,可用於鎖定透過 applications 設定安裝的應用程式,鎖定該應用程式。應用程式會依字母順序顯示在單一頁面中。使用 kioskCustomization 進一步設定資訊站裝置行為。

androidDevicePolicyTracks[]
(deprecated)

enum (AppTrack)

不支援這項設定。系統會忽略所有值。

skipFirstUseHintsEnabled

boolean

初次使用時略過提示的旗標。企業管理員可以啟用系統建議,讓應用程式在首次啟動時略過使用者教學課程和其他入門提示。

privateKeySelectionEnabled

boolean

允許在 ChoosePrivateKeyRules 中沒有相符的規則時,在裝置上顯示 UI,讓使用者選擇私密金鑰別名。如果是搭載 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)

這些設定可控管裝置在 Kiosk 模式的行為。如要啟用 Kiosk 模式,請將 kioskCustomLauncherEnabled 設為 true,或在政策中使用 installType KIOSK 指定應用程式。

advancedSecurityOverrides

object (AdvancedSecurityOverrides)

進階安全性設定。在大多數情況下,您不需要進行這些設定。

personalUsagePolicies

object (PersonalUsagePolicies)

管理公司裝置個人使用行為的政策。

autoDateAndTimeZone

enum (AutoDateAndTimeZone)

公司裝置是否啟用自動日期、時間和時區。如果設定此屬性,系統會忽略 autoTimeRequired

oncCertificateProviders[]

object (OncCertificateProvider)

這項功能尚未正式發布。

crossProfilePolicies

object (CrossProfilePolicies)

在裝置上套用的跨設定檔政策。

preferentialNetworkService

enum (PreferentialNetworkService)

控管是否在工作資料夾中啟用偏好的網路服務。舉例來說,特定機構可能與電信業者簽訂協議,列出所有員工的工作資料裝置會透過企業專用網路服務傳送。使用 5G 網路的企業配量便是支援首選網路服務的例子。這不會對完全受管理的裝置造成影響。

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 以上版本。

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)
}
欄位
packageName

string

應用程式的套件名稱。例如 com.google.android.youtube 代表 YouTube 應用程式。

installType

enum (InstallType)

要執行的安裝類型。

lockTaskAllowed
(deprecated)

boolean

是否允許應用程式自行以全螢幕模式鎖定。已淘汰。使用 InstallType KIOSKkioskCustomLauncherEnabled 設定專用裝置。

defaultPermissionPolicy

enum (PermissionPolicy)

應用程式要求所有權限的預設政策。若指定,系統會覆寫適用於所有應用程式的政策層級 defaultPermissionPolicy。不會覆寫套用至所有應用程式的 permissionGrants

permissionGrants[]

object (PermissionGrant)

授予或拒絕應用程式的明確權限。這些值會覆寫所有應用程式的 defaultPermissionPolicypermissionGrants

managedConfiguration

object (Struct format)

已將受管理設定套用至應用程式。設定格式取決於應用程式支援的 ManagedProperty 值。受管理設定中的每個欄位名稱都必須與 ManagedPropertykey 欄位相符。欄位值必須與 ManagedPropertytype 相容:

類型JSON 值
BOOLtruefalse
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 Device Policy 互動。

最多可以為一個應用程式設定這個欄位。

alwaysOnVpnLockdownExemption

enum (AlwaysOnVpnLockdownExemption)

指定在未連線 VPN 且啟用 alwaysOnVpnPackage.lockdownEnabled 的情況下,應用程式是否允許網路。如果設為 VPN_LOCKDOWN_ENFORCED,應用程式就不得連上網路;如果設為 VPN_LOCKDOWN_EXEMPTION,應用程式則可使用網路。僅支援搭載 Android 10 以上版本的裝置。如果裝置不支援這項操作,裝置會包含 NonComplianceDetail,其中 nonComplianceReason 設為 API_LEVEL 和 fieldPath。如果這不適用於應用程式,裝置會包含 NonComplianceDetail,其中 nonComplianceReason 設為 UNSUPPORTED,以及 fieldPath。columnPath 設為 applications[i].alwaysOnVpnLockdownExemption,其中 iapplications 政策中套件的索引。

workProfileWidgets

enum (WorkProfileWidgets)

指定是否能在工作資料夾中安裝的應用程式在主畫面中新增小工具。

credentialProviderPolicy

enum (CredentialProviderPolicy)

選用設定。是否允許應用程式在 Android 14 以上版本中做為憑證提供者。

installConstraint[]

object (InstallConstraint)

選用設定。安裝應用程式的限制。您最多可以指定一個 InstallConstraint。多項限制遭拒。

installPriority

integer

選用設定。在應用程式的 installType 設為:

這會控制安裝的相對優先順序。如果值為 0 (預設),表示這個應用程式不高於其他應用程式。如果值介於 1 到 10,000 之間,值越小代表優先順序越高。系統會拒絕介於 0 到 10,000 (含) 之間的值。

userControlSettings

enum (UserControlSettings)

選用設定。指定是否允許應用程式取得使用者控制權。使用者控制項包括使用者動作,例如強制停止及清除應用程式資料。支援 Android 11 以上版本。

InstallType

要為應用程式執行的安裝類型。如果 setupAction 參照應用程式,則必須將 installType 設為 REQUIRED_FOR_SETUP,否則設定將會失敗。

列舉
INSTALL_TYPE_UNSPECIFIED 未指定。預設為 AVAILABLE。
PREINSTALLED 應用程式會自動安裝,使用者可自行移除。
FORCE_INSTALLED 無論維護期間為何,應用程式都會自動安裝,且使用者無法移除。
BLOCKED 系統已封鎖應用程式,因此無法安裝。如果應用程式是依據先前的政策安裝,便會解除安裝。這樣做也會封鎖其免安裝應用程式功能。
AVAILABLE 您可以安裝這個應用程式。
REQUIRED_FOR_SETUP 應用程式會自動安裝,而且使用者無法移除。在安裝完成前,應用程式將無法完成設定。
KIOSK 應用程式會自動以 Kiosk 模式安裝:系統會將應用程式設為偏好的主畫面意圖,並列入鎖定任務模式的許可清單。請先安裝應用程式,裝置才能設定完成。安裝完成後,使用者將無法移除這個應用程式。每項政策只能為一個應用程式設定此 installType。在政策中顯示此元素時,狀態列會自動停用。

PermissionPolicy

這項政策適用於將權限要求授予應用程式。

列舉
PERMISSION_POLICY_UNSPECIFIED 未指定政策。如未針對任何層級的權限指定政策,系統會預設使用 PROMPT 行為。
PROMPT 提示使用者授予權限。
GRANT

自動授予權限。

在 Android 12 以上版本中,Manifest.permission.READ_SMS 和下列感應器相關權限只能在全代管裝置上取得:

DENY 自動拒絕權限。

PermissionGrant

Android 權限的設定及其授權狀態。

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

string

Android 權限或群組,例如android.permission.READ_CALENDARandroid.permission_group.CALENDAR

policy

enum (PermissionPolicy)

授予權限的政策。

DelegatedScope

其他套件可從 Android Device Policy 取得的委派範圍。這麼做可為套用這些角色的應用程式提供額外權限,

範圍可套用至多個應用程式,但 SECURITY_LOGS 和 NETWORK_ACTIVITY_LOGS 除外,兩者一次只能委派給一個應用程式。

列舉
DELEGATED_SCOPE_UNSPECIFIED 未指定委派範圍。
CERT_INSTALL 可授予憑證安裝和管理的權限。
MANAGED_CONFIGURATIONS 可授予受管理設定管理的權限。
BLOCK_UNINSTALL 可封鎖解除安裝作業的權限。
PERMISSION_GRANT 可授予權限政策和權限授予狀態。
PACKAGE_ACCESS 授予套件存取狀態的權限,
ENABLE_SYSTEM_APP 可授予啟用系統應用程式的權限,
NETWORK_ACTIVITY_LOGS 授予網路活動記錄的存取權。允許委派的應用程式呼叫 setNetworkLoggingEnabledisNetworkLoggingEnabledretrieveNetworkLogs 方法。這個範圍最多只能委派一個應用程式。支援搭載 Android 10 以上版本的全代管裝置。支援 Android 12 以上版本的工作資料夾。如果支援委派功能且已設定委派,則系統會忽略 NETWORK_ACTIVITY_LOGS
SECURITY_LOGS 授予安全性記錄的存取權。允許委派的應用程式呼叫 setSecurityLoggingEnabledisSecurityLoggingEnabledretrieveSecurityLogsretrievePreRebootSecurityLogs 方法。這個範圍最多只能委派一個應用程式。支援完全受管理的裝置,以及設有工作資料夾的公司裝置 (須搭載 Android 12 以上版本)。如果支援委派功能且已設定委派,則系統會忽略 SECURITY_LOGS
CERT_SELECTION 可代表提出要求的應用程式,授予選取 KeyChain 憑證的權限。授予後,委派的應用程式就會開始接收 DelegatedAdminReceiver#onChoosePrivateKeyAlias。允許委派的應用程式呼叫 grantKeyPairToApprevokeKeyPairFromApp 方法。最多只能有一個具備此委派功能的應用程式。如果將憑證選取委派給應用程式,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 13 以上版本中,擴充功能應用程式不受電池限制規範,因此不會列入受限制的應用程式待命值區。此外,擴充功能應用程式也能防止使用者清除資料或強制關閉應用程式,但如果管理員需要 Android 13 以上版本,管理員仍可繼續在擴充功能應用程式上使用 clear app data command

JSON 表示法
{
  "signingKeyFingerprintsSha256": [
    string
  ],
  "notificationReceiver": string
}
欄位
signingKeyFingerprintsSha256[]

string

擴充功能應用程式的簽署憑證的十六進位編碼 SHA-256 雜湊。只有 64 個字元的十六進位字串才有效。

如未指定,則會從 Play 商店取得相應套件名稱的簽名。

如果這份清單沒有任何內容,裝置上的擴充功能應用程式簽名必須與從 Play 商店取得的簽章相同,應用程式才能與 Android Device Policy 通訊。

如果這份清單並非空白,裝置上的擴充功能應用程式簽名必須與這份清單中的任一項目相符,應用程式才能與 Android Device Policy 通訊。

在實際工作環境中,建議將這個欄位留空。

notificationReceiver

string

Android Device Policy 接收器服務類別的完整類別名稱,用於通知擴充功能應用程式任何本機指令狀態更新。

AlwaysOnVpnLockdownExemption

控制應用程式是否不受 alwaysOnVpnPackage.lockdownEnabled 設定限制。

列舉
ALWAYS_ON_VPN_LOCKDOWN_EXEMPTION_UNSPECIFIED 未指定。預設值為 VPN_LOCKDOWN_ENFORCED
VPN_LOCKDOWN_ENFORCED 應用程式會遵循永久連線 VPN 鎖定設定。
VPN_LOCKDOWN_EXEMPTION 應用程式不受永久連線 VPN 鎖定設定的限制。

WorkProfileWidgets

控管是否允許工作資料夾應用程式將小工具新增至主畫面。

列舉
WORK_PROFILE_WIDGETS_UNSPECIFIED 未指定。預設為 workProfileWidgetsDefault
WORK_PROFILE_WIDGETS_ALLOWED 允許工作資料夾小工具。這表示應用程式可以在主畫面中新增小工具。
WORK_PROFILE_WIDGETS_DISALLOWED 禁止使用工作資料夾小工具。這表示應用程式無法將小工具新增至主畫面。

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 任何使用中的網路 (Wi-Fi、行動網路等)。
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

指定是否允許特定應用程式取得使用者控制權。使用者控制項包括使用者動作,例如強制停止及清除應用程式資料。支援 Android 11 以上版本。如果已為應用程式設定 extensionConfig,無論設定值為何,系統都不允許使用者控制項。資訊站應用程式可以使用 USER_CONTROL_ALLOWED 讓使用者進行控制。

列舉
USER_CONTROL_SETTINGS_UNSPECIFIED 使用應用程式的預設行為,判斷是否允許或禁止使用者控制項。大多數應用程式預設都允許使用者控制項,但某些重要應用程式 (例如隨附應用程式 (extensionConfig 設為 true)、資訊站應用程式和其他重要系統應用程式) 不允許使用者控制項。
USER_CONTROL_ALLOWED 允許應用程式的使用者控制項。資訊站應用程式可以使用這項功能讓使用者進行控制。
USER_CONTROL_DISALLOWED 不允許這個應用程式的使用者控制項。如果 Android 版本低於 11,系統會回報 API_LEVEL

KeyguardDisabledFeature

可停用的鍵盤鎖 (螢幕鎖定) 功能。

列舉
KEYGUARD_DISABLED_FEATURE_UNSPECIFIED 系統會忽略這個值。
CAMERA 在安全鍵盤鎖螢幕 (例如 PIN 碼) 上停用攝影機。
NOTIFICATIONS 停止在安全鍵盤保護畫面上顯示所有通知。
UNREDACTED_NOTIFICATIONS 停用安全鍵盤保護畫面上未遮蓋的通知。
TRUST_AGENTS 在安全鍵盤防護畫面上忽略信任的代理程式狀態。
DISABLE_FINGERPRINT 在安全鍵盤鎖螢幕上停用指紋感應器。
DISABLE_REMOTE_INPUT 在搭載 Android 6 以下版本的裝置上,禁止在安全金鑰保護畫面上輸入文字。不會影響 Android 7 以上版本。
FACE 在安全鍵盤保護畫面上停用臉孔驗證功能。
IRIS 在安全鍵盤保護畫面上停用 iris 驗證。
BIOMETRICS 在安全鍵盤保護畫面上停用所有生物特徵辨識驗證。
SHORTCUTS 在 Android 14 以上版本中,停用安全鍵盤保護畫面的所有快速鍵。
ALL_FEATURES 停用目前和日後的所有鍵盤保護自訂功能。

PersistentPreferredActivity

處理符合特定意圖篩選器的意圖的預設活動。注意:如要設定資訊站,請將 InstallType 設為 KIOSK,而不要使用永久偏好活動。

JSON 表示法
{
  "receiverActivity": string,
  "actions": [
    string
  ],
  "categories": [
    string
  ]
}
欄位
receiverActivity

string

應為預設意圖處理常式的活動。應為 Android 元件名稱,例如com.android.enterprise.app/.MainActivity。或者,這個值可以是應用程式的套件名稱,讓 Android Device Policy 從應用程式中選擇合適的活動來處理意圖。

actions[]

string

在篩選器中要比對的意圖動作。如有任何動作包含在篩選器中,則意圖動作必須是上述其中一個值,系統才會比對意圖。如未納入任何動作,系統就會忽略意圖動作。

categories[]

string

在篩選器中要比對的意圖類別。意圖包含所需的類別;所有類別都必須加入篩選器中,系統才會比對出意圖。換句話說,除非在意圖中指定該類別,否則在篩選器中新增類別不會影響比對。

SystemUpdate

管理系統更新的管理設定

注意: Google Play 系統更新 (也稱為 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) 系統更新期間,會延後凍結裝置上執行的 OS 版本。為避免裝置無限期凍結,每個凍結期必須至少 60 天。

SystemUpdateType

系統更新設定的類型。

列舉
SYSTEM_UPDATE_TYPE_UNSPECIFIED 按照裝置的預設更新行為進行,一般會要求使用者接受系統更新。
AUTOMATIC 有更新時自動安裝。
WINDOWED

在每日維護期間自動安裝。這會同時將 Play 應用程式設為在視窗中更新。對於資訊站裝置,我們強烈建議採取這種做法,因為 Google 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)

凍結期間的開始日期 (含此日期)。注意:不得設定 year。例如 {"month": 1,"date": 30}

endDate

object (Date)

凍結期間的結束日期 (含此日期)。必須在開始日期後的 90 天內。如果結束日期早於開始日期,系統會將凍結期間視為結束年末。注意:不得設定 year。例如 {"month": 1,"date": 30}

日期

代表完整或部分的日曆日期,例如生日。您可以指明時段和時區,或者在其他地方指定時間或時區。日期以公曆為基準。可能代表下列其中一項:

  • 完整日期,具有非零的年、月和日值。
  • 日期為 0 的月份和日期,例如週年紀念日。
  • 有 1 年,第 0 個月卻為 0 天。
  • 年和月,但數字為零 (例如信用卡到期日)。

相關類型:

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)

應用程式報告設定。只有在 applicationReportingEnabled 為 true 時適用。

commonCriteriaModeEnabled

boolean

是否啟用Common Criteria Mode回報功能。這項功能僅適用於公司擁有的裝置。

ApplicationReportingSettings

控制應用程式報告行為的設定。

JSON 表示法
{
  "includeRemovedApps": boolean
}
欄位
includeRemovedApps

boolean

應用程式報告是否包含已移除的應用程式。

PackageNameList

套件名稱清單。

JSON 表示法
{
  "packageNames": [
    string
  ]
}
欄位
packageNames[]

string

套件名稱清單。

BatteryPluggedMode

電池接頭的模式。

列舉
BATTERY_PLUGGED_MODE_UNSPECIFIED 系統會忽略這個值。
AC 電源是 AC 充電器。
USB 電源有 USB 連接埠。
WIRELESS 電源為無線。

ProxyInfo

HTTP Proxy 的設定資訊。如果是直接 Proxy,請設定 hostportexcludedHosts 欄位。如果是 PAC 指令碼 Proxy,請設定 pacUri 欄位。

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

string

直接 Proxy 的主機。

port

integer

直接 Proxy 的通訊埠。

excludedHosts[]

string

如果是直接 Proxy,則系統會略過該 Proxy 的主機。主機名稱可以包含萬用字元,例如 *.example.com。

pacUri

string

用來設定 Proxy 的 PAC 指令碼 URI。

ChoosePrivateKeyRule

控管應用程式存取私密金鑰這項規則會決定 Android Device Policy 向指定應用程式的私密金鑰 (如有)。當應用程式呼叫 KeyChain.choosePrivateKeyAlias (或任何超載) 要求特定網址的私密金鑰別名,或是在 Android 11 以上版本中直接呼叫非特定網址的規則 (亦即未設定 urlPattern,或是設為空白字串或 .*),系統會直接授予存取權,讓應用程式可以直接呼叫 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 或任何超載 (但不呼叫 KeyChain.choosePrivateKeyAlias) 的所有應用程式提供別名 (即使在 Android 11 以上版本中也是如此)。凡是與此處指定的套件具有相同 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,規則會執行降低應用程式的停用動作,以便有效地停用裝置,但會保留應用程式資料。如果裝置在鎖定的工作模式下執行應用程式,該應用程式就會關閉,並顯示違規原因的 UI。

packageNamesToDisable[]

string

如果設定這項政策,規則會包含停用清單中指定的應用程式的緩解動作,但會保留應用程式資料。

聯集欄位 condition。條件滿足時,就會觸發規則中定義的緩解動作。必須明確設定其中一項條件。condition 只能是下列其中一項:
nonComplianceDetailCondition

object (NonComplianceDetailCondition)

如果裝置有「任何」相符的 NonComplianceDetail,則滿足的條件。

apiLevelCondition

object (ApiLevelCondition)

如果裝置上的 Android Framework 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 Framework API 級別未達到最低要求,所滿足的法規遵循規則條件。每項政策只能有一個設有這類條件的規則。

JSON 表示法
{
  "minApiLevel": integer
}
欄位
minApiLevel

integer

所需的最低 Android Framework API 級別。如果裝置未達基本要求,則可滿足這項條件。必須大於零。

AppAutoUpdatePolicy

建議的替代方案:autoUpdateMode,此為個別應用程式設定,可讓您更靈活地調整更新頻率。

autoUpdateMode 設為 AUTO_UPDATE_POSTPONEDAUTO_UPDATE_HIGH_PRIORITY 時,這個欄位不會有任何作用。

應用程式自動更新政策,可控管可套用自動更新應用程式的時間。

列舉
APP_AUTO_UPDATE_POLICY_UNSPECIFIED 未設定自動更新政策。等同於 CHOICE_TO_THE_USER
CHOICE_TO_THE_USER 使用者可以控制自動更新。
NEVER 應用程式一律不會自動更新。
WIFI_ONLY 應用程式只會透過 Wi-Fi 自動更新。
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)

啟動應用程式的動作。此應用程式將啟動,其中包含一個意圖,其中的額外項目 (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

要強制執行的頂層政策。例如 applicationspasswordPolicies

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

這些設定可控管裝置在 Kiosk 模式的行為。如要啟用 Kiosk 模式,請將 kioskCustomLauncherEnabled 設為 true,或在政策中使用 installType KIOSK 指定應用程式。

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

enum (PowerButtonActions)

設定使用者按住 (長按) 電源鍵時,在 Kiosk 模式中的行為。

systemErrorWarnings

enum (SystemErrorWarnings)

指出在 Kiosk 模式中,系統是否針對當機或無回應的應用程式封鎖系統錯誤對話方塊。封鎖後,系統會像使用者選擇「關閉應用程式」一樣,強制停止應用程式選項。

systemNavigation

enum (SystemNavigation)

指定要在 Kiosk 模式下啟用的導覽功能 (例如首頁、總覽按鈕)。

statusBar

enum (StatusBar)

指定在 Kiosk 模式下是否停用系統資訊和通知。

deviceSettings

enum (DeviceSettings)

指定是否允許在 Kiosk 模式下使用「設定」應用程式。

PowerButtonActions

設定使用者按住 (長按) 電源鍵時,在 Kiosk 模式中的行為。

列舉
POWER_BUTTON_ACTIONS_UNSPECIFIED 未指定,預設為 POWER_BUTTON_AVAILABLE
POWER_BUTTON_AVAILABLE 使用者在 Kiosk 模式中長按裝置的電源按鈕時,畫面上會顯示電源按鈕選單 (例如「關機」、「重新啟動」)。
POWER_BUTTON_BLOCKED 使用者在 Kiosk 模式中長按裝置的電源按鈕時,系統不會顯示電源鍵選單 (例如關機、重新啟動)。注意:這可能導致使用者無法關閉裝置。

SystemErrorWarnings

指出在 Kiosk 模式中,系統是否針對當機或無回應的應用程式封鎖系統錯誤對話方塊。

列舉
SYSTEM_ERROR_WARNINGS_UNSPECIFIED 未指定,預設為 ERROR_AND_WARNINGS_MUTED
ERROR_AND_WARNINGS_ENABLED 所有系統錯誤對話方塊都會顯示,例如當機和應用程式無回應 (ANR)。
ERROR_AND_WARNINGS_MUTED 所有系統錯誤對話方塊 (例如當機和應用程式無回應 (ANR)) 都會遭到封鎖。封鎖後,系統會像使用者從 UI 關閉應用程式一樣,強制停止應用程式。

SystemNavigation

指定要在 Kiosk 模式下啟用的導覽功能 (例如首頁、總覽按鈕)。

列舉
SYSTEM_NAVIGATION_UNSPECIFIED 未指定,預設為 NAVIGATION_DISABLED
NAVIGATION_ENABLED 「首頁」和「總覽」按鈕已啟用。
NAVIGATION_DISABLED 無法使用「首頁」和「總覽」按鈕。
HOME_BUTTON_ONLY 只有首頁按鈕處於啟用狀態。

StatusBar

指定在 Kiosk 模式下是否停用系統資訊和通知。

列舉
STATUS_BAR_UNSPECIFIED 未指定,預設為 INFO_AND_NOTIFICATIONS_DISABLED
NOTIFICATIONS_AND_SYSTEM_INFO_ENABLED

系統資訊和通知會顯示在 Kiosk 模式的狀態列上。

注意:如要讓這項政策生效,必須使用 kioskCustomization.systemNavigation 啟用裝置的主畫面按鈕。

NOTIFICATIONS_AND_SYSTEM_INFO_DISABLED Kiosk 模式會停用系統資訊和通知。
SYSTEM_INFO_ONLY 狀態列只會顯示系統資訊。

DeviceSettings

指定使用者是否可在 Kiosk 模式下存取裝置的「設定」應用程式。

列舉
DEVICE_SETTINGS_UNSPECIFIED 未指定,預設為 SETTINGS_ACCESS_ALLOWED
SETTINGS_ACCESS_ALLOWED 使用者可在 Kiosk 模式下存取「設定」應用程式。
SETTINGS_ACCESS_BLOCKED 無法在 Kiosk 模式下存取「設定」應用程式。

AdvancedSecurityOverrides

進階安全性設定。在大多數情況下,您不需要進行這些設定。

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

enum (UntrustedAppsPolicy)

系統會在裝置上強制執行不受信任的應用程式 (來源不明應用程式) 的政策。取代 installUnknownSourcesAllowed (deprecated).

googlePlayProtectVerifyApps

enum (GooglePlayProtectVerifyApps)

是否強制執行 Google Play 安全防護驗證。取代 ensureVerifyAppsEnabled (已淘汰)。

developerSettings

enum (DeveloperSettings)

控管開發人員設定的存取權:開發人員選項和安全啟動。取代 safeBootDisabled (已淘汰) 和 debuggingFeaturesAllowed (已淘汰)。

commonCriteriaMode

enum (CommonCriteriaMode)

控管共同準則模式:資訊科技安全評估共同準則 (CC) 中定義的安全標準。啟用共通條件模式會增加裝置上的特定安全性元件,包括藍牙長期金鑰的 AES-GCM 加密,以及 Wi-Fi 設定存放區。

只有搭載 Android 11 以上版本的公司裝置才支援共同條件模式。

警告:一般而言,只有國家安全系統和其他高度敏感組織中使用的 IT 產品才需要使用高強度的安全性模型。標準裝置使用可能會受到影響。只有在必要時啟用。

personalAppsThatCanReadWorkNotifications[]

string

可使用 NotificationListenerService 讀取工作資料夾通知的個人應用程式。根據預設,除了系統應用程式以外,任何個人應用程式都無法讀取工作通知。清單中的每個值都必須是套件名稱。

mtePolicy

enum (MtePolicy)

選用設定。控制裝置上的 Memory Tagging Extension (MTE)。裝置需要重新啟動,才能套用 MTE 政策的變更。

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

控管共同準則模式:資訊科技安全評估共同準則 (CC) 中定義的安全標準。啟用共通條件模式會增加裝置上的特定安全性元件,包括藍牙長期金鑰的 AES-GCM 加密,以及 Wi-Fi 設定存放區。

只有搭載 Android 11 以上版本的公司裝置才支援共同條件模式。

警告:一般而言,只有國家安全系統和其他高度敏感組織中使用的 IT 產品才需要使用高強度的安全性模型。標準裝置使用可能會受到影響。只有在必要時啟用。如果先前啟用「共同條件模式」後即關閉,則所有使用者設定的 Wi-Fi 網路可能會遺失,而且企業設定的 Wi-Fi 網路需要使用者輸入內容才能運作。

列舉
COMMON_CRITERIA_MODE_UNSPECIFIED 未指定。預設值為 Common_CRITERIA_MODE_DISABLED。
COMMON_CRITERIA_MODE_DISABLED 預設。停用共通準則模式。
COMMON_CRITERIA_MODE_ENABLED 啟用共同準則模式。

MtePolicy

控制裝置上的 Memory Tagging Extension (MTE)

列舉
MTE_POLICY_UNSPECIFIED 未指定。預設值為 MTE_USER_CHOICE
MTE_USER_CHOICE 如果裝置支援 MTE,使用者可以選擇在裝置上啟用或停用 MTE。
MTE_ENFORCED

裝置已啟用 MTE,且使用者無法變更這項設定。您可以針對公司擁有的全代管裝置和工作資料夾設定這項功能。針對其他管理模式,系統會回報具有 MANAGEMENT_MODEnonComplianceDetail。如果裝置不支援 MTE,系統會回報具備 DEVICE_INCOMPATIBLEnonComplianceDetail

支援 Android 14 以上版本。如果 Android 版本低於 14,系統會回報含有 API_LEVELnonComplianceDetail

MTE_DISABLED

該裝置已停用 MTE,且使用者無法變更這項設定。這項設定僅適用於全代管裝置。其他情況下,系統會回報包含 MANAGEMENT_MODEnonComplianceDetail。如果裝置不支援 MTE,系統會回報具備 DEVICE_INCOMPATIBLEnonComplianceDetail

支援 Android 14 以上版本。如果 Android 版本低於 14,系統會回報含有 API_LEVELnonComplianceDetail

PersonalUsagePolicies

這類政策可控管公司裝置上與工作資料夾的個人使用行為。

JSON 表示法
{
  "cameraDisabled": boolean,
  "screenCaptureDisabled": boolean,
  "accountTypesWithManagementDisabled": [
    string
  ],
  "maxDaysWithWorkOff": integer,
  "personalPlayStoreMode": enum (PlayStoreMode),
  "personalApplications": [
    {
      object (PersonalApplicationPolicy)
    }
  ]
}
欄位
cameraDisabled

boolean

如果為 true,則個人資料夾的相機會停用。

screenCaptureDisabled

boolean

如為 true,所有使用者的螢幕畫面擷取功能都會停用。

accountTypesWithManagementDisabled[]

string

使用者無法管理的帳戶類型。

maxDaysWithWorkOff

integer

控管工作資料夾保持關閉的時間。時間長度下限必須至少為 3 天。其他詳細資料如下:

  • 如果時間長度設為 0,功能就會關閉。
  • 如果時間長度設定的值小於最短持續時間,功能會傳回錯誤。
注意:如要避免個人資料夾在長期關閉期間遭到停權,可以暫時為這個參數設定較大的值。

personalPlayStoreMode

enum (PlayStoreMode)

personalApplications 搭配使用,即可控管個人資料夾中應用程式的允許或封鎖方式。

personalApplications[]

object (PersonalApplicationPolicy)

這項政策會套用至個人資料夾中的應用程式。

PlayStoreMode

personalApplications 搭配使用,即可控管個人資料夾中應用程式的允許或封鎖方式。

列舉
PLAY_STORE_MODE_UNSPECIFIED 未指定。預設值為 BLOCKLIST
BLACKLIST

所有的 Play 商店應用程式都可以在個人資料夾中安裝,但 installTypepersonalApplicationsBLOCKED 的應用程式除外。

BLOCKLIST 所有的 Play 商店應用程式都可以在個人資料夾中安裝,但 installTypepersonalApplicationsBLOCKED 的應用程式除外。
ALLOWLIST 只有在 personalApplications 中明確指定 installType 設為 AVAILABLE 的應用程式,才能在個人資料夾中安裝。

PersonalApplicationPolicy

針對設有工作資料夾的公司裝置個人資料夾中的應用程式適用的政策。

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

string

應用程式的套件名稱。

installType

enum (InstallType)

要執行的安裝類型。

InstallType

個人資料夾應用程式所具備的安裝行為類型。

列舉
INSTALL_TYPE_UNSPECIFIED 未指定。預設值為 AVAILABLE
BLOCKED 應用程式遭到封鎖,無法安裝在個人資料夾中。如果該應用程式先前已安裝在裝置上,系統會解除安裝。
AVAILABLE 應用程式可在個人資料夾中安裝。

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_MODEnonComplianceDetail

JSON 表示法
{
  "showWorkContactsInPersonalProfile": enum (ShowWorkContactsInPersonalProfile),
  "crossProfileCopyPaste": enum (CrossProfileCopyPaste),
  "crossProfileDataSharing": enum (CrossProfileDataSharing),
  "workProfileWidgetsDefault": enum (WorkProfileWidgetsDefault),
  "exemptionsToShowWorkContactsInPersonalProfile": {
    object (PackageNameList)
  }
}
欄位
showWorkContactsInPersonalProfile

enum (ShowWorkContactsInPersonalProfile)

個人應用程式是否可以存取工作資料夾中儲存的聯絡人。

另請參閱 exemptionsToShowWorkContactsInPersonalProfile

crossProfileCopyPaste

enum (CrossProfileCopyPaste)

是否可將從某個設定檔 (個人或工作) 複製的文字貼到另一個設定檔。

crossProfileDataSharing

enum (CrossProfileDataSharing)

將某個設定檔的資料 (個人或工作資料) 能否與另一個設定檔中的應用程式共用。特別控管透過意圖共用資料的方式。管理其他跨個人資料通訊管道,例如聯絡人搜尋、複製/貼上或已連結的工作與是個別應用程式的設定

workProfileWidgetsDefault

enum (WorkProfileWidgetsDefault)

指定工作資料夾小工具的預設行為。如果政策未指定特定應用程式的 workProfileWidgets,則系統會根據此處指定的值執行作業。

exemptionsToShowWorkContactsInPersonalProfile

object (PackageNameList)

ShowWorkContactsInPersonalProfile 設定中排除的應用程式清單。如要設置這項設定,必須將 ShowWorkContactsInPersonalProfile 設為下列其中一個值:

支援 Android 14 以上版本。如果 Android 版本低於 14,系統會回報含有 API_LEVELnonComplianceDetail

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,系統會回報具有 API_LEVELnonComplianceDetail

SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_ALLOWED

預設。允許應用程式存取工作資料夾中的聯絡人,包括聯絡人搜尋結果和來電。

設定這項設定後,「exemptionsToShowWorkContactsInPersonalProfile」中指定的個人應用程式就會加入封鎖清單,因此無法直接存取工作資料夾聯絡人。

支援 Android 7.0 以上版本。如果 Android 版本低於 7.0,系統會回報具有 API_LEVELnonComplianceDetail

SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED_EXCEPT_SYSTEM

禁止大多數個人應用程式存取工作資料夾中的聯絡人,包括聯絡人搜尋及來電 (原始設備製造商 (OEM) 預設撥號、「訊息」和「聯絡人」應用程式除外)。無論是使用者設定的「撥號」、「訊息」和「聯絡人」應用程式,或任何其他系統或播放已安裝的應用程式,都無法直接查詢工作聯絡人。

這項設定後,系統會將「exemptionsToShowWorkContactsInPersonalProfile」中指定的個人應用程式加入許可清單,允許該應用程式存取工作資料夾聯絡人。

支援 Android 14 以上版本。在搭載 Android 14 以下版本的裝置上設定這項設定後,行為會變回 SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED,並回報具有 API_LEVELnonComplianceDetail

CrossProfileCopyPaste

是否可將從某個設定檔 (個人或工作) 複製的文字貼到另一個設定檔。

列舉
CROSS_PROFILE_COPY_PASTE_UNSPECIFIED 未指定。預設為 COPY_FROM_WORK_TO_PERSONAL_DISALLOWED
COPY_FROM_WORK_TO_PERSONAL_DISALLOWED 預設。禁止使用者貼到從工作資料夾複製的個人資料夾文字。從個人資料夾複製的文字可以貼到工作資料夾中,然後將複製的文字貼到工作資料夾中。
CROSS_PROFILE_COPY_PASTE_ALLOWED 您可以將複製的文字貼到另一個設定檔中。

CrossProfileDataSharing

將某個設定檔的資料 (個人或工作資料) 能否與另一個設定檔中的應用程式共用。特別控管透過意圖共用資料的方式。管理其他跨個人資料通訊管道,例如聯絡人搜尋、複製/貼上或已連結的工作與是個別應用程式的設定

列舉
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

控管是否允許工作資料夾應用程式將小工具新增至主畫面 (未定義任何應用程式專屬政策)。否則,應用程式專屬政策將優先於此。

列舉
WORK_PROFILE_WIDGETS_DEFAULT_UNSPECIFIED 未指定。預設為 WORK_PROFILE_LABELS_DEFAULT_DISALLOWED。
WORK_PROFILE_WIDGETS_DEFAULT_ALLOWED 系統預設會啟用工作資料夾小工具。也就是說,如果這項政策未針對應用程式將 workProfileWidgets 指定為 WORK_PROFILE_WIDGETS_DISALLOWED,應用程式就能在主畫面中新增小工具。
WORK_PROFILE_WIDGETS_DEFAULT_DISALLOWED 系統預設為不允許使用工作資料夾小工具。也就是說,如果這項政策未針對應用程式將 workProfileWidgets 指定為 WORK_PROFILE_WIDGETS_ALLOWED,使用者就無法在主畫面中新增小工具。

PreferentialNetworkService

控管是否在工作資料夾中啟用偏好的網路服務。如需詳細資訊,請參閱 preferentialNetworkService

列舉
PREFERENTIAL_NETWORK_SERVICE_UNSPECIFIED 未指定。預設值為 PREFERENTIAL_NETWORK_SERVICES_DISABLED
PREFERENTIAL_NETWORK_SERVICE_DISABLED 工作資料夾中的偏好網路服務已停用。
PREFERENTIAL_NETWORK_SERVICE_ENABLED 工作資料夾已啟用偏好網路服務。

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)
  }
}
欄位
usbDataAccess

enum (UsbDataAccess)

控制哪些檔案和/或資料可透過 USB 傳輸。僅支援公司擁有的裝置。

configureWifi

enum (ConfigureWifi)

控管 Wi-Fi 設定權限,視相關選項而定,使用者可在設定 Wi-Fi 網路時擁有完整控制權或完全無法控管。

wifiDirectSettings

enum (WifiDirectSettings)

控管設定及使用 Wi-Fi 直接設定。支援搭載 Android 13 以上版本的公司裝置。

tetheringSettings

enum (TetheringSettings)

控管網路共用設定。視設定的值而定,使用者可能會部分或完全禁止使用不同形式的網路共用功能。

wifiSsidPolicy

object (WifiSsidPolicy)

裝置可連線至 Wi-Fi SSID 的限制。請注意,這不會影響裝置上可設定的網路。支援搭載 Android 13 以上版本的公司裝置。

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_LEVELnonComplianceDetail。如果裝置沒有 USB HAL 1.3 以上版本,系統會回報包含 DEVICE_INCOMPATIBLEnonComplianceDetail。已忽略 usbFileTransferDisabled

ConfigureWifi

控管 Wi-Fi 設定權限,視使用者設定的選項而定,使用者在設定 Wi-Fi 網路時將擁有完整或部分控制權,或是完全無法控制。

列舉
CONFIGURE_WIFI_UNSPECIFIED 未指定。預設為 ALLOW_CONFIGURING_WIFI,除非 wifiConfigDisabled 設為 true。如果將 wifiConfigDisabled 設為 True,就等同於 DISALLOW_CONFIGURING_WIFI
ALLOW_CONFIGURING_WIFI 允許使用者設定 Wi-Fi。已忽略 wifiConfigDisabled
DISALLOW_ADD_WIFI_CONFIG 不允許新增 Wi-Fi 設定。使用者只能切換已設定的網路。支援 Android 13 以上版本,支援全代管裝置和公司裝置的工作資料夾。如果系統不支援這項設定,則會設定 ALLOW_CONFIGURING_WIFI。如果 Android 版本低於 13,系統會回報含有 API_LEVELnonComplianceDetail。已忽略 wifiConfigDisabled
DISALLOW_CONFIGURING_WIFI 不允許設定 Wi-Fi 網路。設有這個值時,系統會忽略 wifiConfigDisabled 設定。支援全代管裝置和工作資料夾 (適用於公司擁有的裝置),且支援所有支援的 API 級別。如果是全代管裝置,這項設定會移除所有已設定的網路,並僅保留使用 openNetworkConfiguration 政策設定的網路。針對公司擁有裝置上的工作資料夾,現有設定的網路不會受到影響,使用者也無法新增、移除或修改 Wi-Fi 網路。注意:如果無法在開機時連上網路,也無法設定 Wi-Fi 的 Wi-Fi 功能,系統會顯示網路跳轉網路,以便重新整理裝置政策 (請參閱 networkEscapeHatchEnabled)。

WifiDirectSettings

控管 Wi-Fi Direct 設定。支援搭載 Android 13 以上版本的公司裝置。

列舉
WIFI_DIRECT_SETTINGS_UNSPECIFIED 未指定。預設為 ALLOW_WIFI_DIRECT
ALLOW_WIFI_DIRECT 使用者可以使用 Wi-Fi Direct。
DISALLOW_WIFI_DIRECT 使用者不得使用 Wi-Fi Direct。如果 Android 版本低於 13,系統會回報含有 API_LEVELnonComplianceDetail

TetheringSettings

控制使用者可使用不同形式的網路共用範圍,例如 Wi-Fi 網路共用、藍牙網路共用等。

列舉
TETHERING_SETTINGS_UNSPECIFIED 未指定。預設為 ALLOW_ALL_TETHERING,除非 tetheringConfigDisabled 設為 true。如果將 tetheringConfigDisabled 設為 True,就等同於 DISALLOW_ALL_TETHERING
ALLOW_ALL_TETHERING 允許設定和使用任何形式的網路共用功能。已忽略 tetheringConfigDisabled
DISALLOW_WIFI_TETHERING 不允許使用者使用 Wi-Fi 數據連線。支援公司擁有的裝置,且搭載 Android 13 以上版本。如果系統不支援這項設定,則會設定 ALLOW_ALL_TETHERING。如果 Android 版本低於 13,系統會回報含有 API_LEVELnonComplianceDetail。已忽略 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,且非公司擁有的裝置回報為 MANAGEMENT_MODEnonComplianceDetail,則會回報包含 API_LEVELnonComplianceDetail 詳細資料。

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 進行 Wi-Fi 連線。wifiSsids不得留空。裝置將無法連上任何其他 Wi-Fi 網路。

WifiSsid

代表 Wi-Fi SSID。

JSON 表示法
{
  "wifiSsid": string
}
欄位
wifiSsid

string

必要欄位。Wi-Fi SSID 以字串表示。

DeviceRadioState

裝置無線電設定的控制選項。

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

enum (WifiState)

控制 Wi-Fi 的目前狀態,以及使用者是否可以變更 Wi-Fi 狀態。

airplaneModeState

enum (AirplaneModeState)

控制使用者能否切換飛航模式。

ultraWidebandState

enum (UltraWidebandState)

控制超寬頻設定的狀態,以及使用者能否切換為開啟或關閉。

cellularTwoGState

enum (CellularTwoGState)

控制使用者能否切換行動網路 2G 設定。

minimumWifiSecurityLevel

enum (MinimumWifiSecurityLevel)

裝置可連線的 Wi-Fi 網路最低安全等級。

WifiState

控制是否以狀態的形式開啟 Wi-Fi,以及使用者是否能夠變更 Wi-Fi 狀態。支援搭載 Android 13 以上版本的公司裝置。

列舉
WIFI_STATE_UNSPECIFIED 未指定。預設為 WIFI_STATE_USER_CHOICE
WIFI_STATE_USER_CHOICE 使用者可以啟用/停用 Wi-Fi。
WIFI_ENABLED Wi-Fi 已開啟,且使用者無法關閉。如果 Android 版本低於 13,系統會回報含有 API_LEVELnonComplianceDetail
WIFI_DISABLED Wi-Fi 已關閉,且使用者無法自行開啟。如果 Android 版本低於 13,系統會回報含有 API_LEVELnonComplianceDetail

AirplaneModeState

控制飛航模式的狀態,以及使用者是否可以將其切換為開啟或關閉。支援 Android 9 以上版本。支援全代管裝置和公司裝置上的工作資料夾。

列舉
AIRPLANE_MODE_STATE_UNSPECIFIED 未指定。預設值為 AIRPLANE_MODE_USER_CHOICE
AIRPLANE_MODE_USER_CHOICE 使用者可以開啟或關閉飛航模式。
AIRPLANE_MODE_DISABLED 飛航模式已停用。使用者不允許開啟飛航模式。如果 Android 版本低於 9,系統會回報含有 API_LEVELnonComplianceDetail

UltraWidebandState

控制超寬頻設定的狀態,以及使用者能否切換為開啟或關閉。支援 Android 14 以上版本。支援全代管裝置和公司裝置上的工作資料夾。

列舉
ULTRA_WIDEBAND_STATE_UNSPECIFIED 未指定。預設值為 ULTRA_WIDEBAND_USER_CHOICE
ULTRA_WIDEBAND_USER_CHOICE 使用者可以開啟或關閉超寬頻功能。
ULTRA_WIDEBAND_DISABLED 超寬頻已停用。使用者無法透過設定開啟超寬頻。如果 Android 版本低於 14,系統會回報含有 API_LEVELnonComplianceDetail

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_LEVELnonComplianceDetail

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_LEVELnonComplianceDetail
ENTERPRISE_NETWORK_SECURITY 企業 EAP 網路是最低所需的安全性等級,裝置將無法連線至這個安全性等級以下的 Wi-Fi 網路。這比 PERSONAL_NETWORK_SECURITY嚴格。如果 Android 版本低於 13,系統會回報含有 API_LEVELnonComplianceDetail
ENTERPRISE_BIT192_NETWORK_SECURITY 192 位元企業網路是最低所需的安全性等級,裝置將無法連線至這個安全性等級以下的 Wi-Fi 網路。這比 ENTERPRISE_NETWORK_SECURITY嚴格。如果 Android 版本低於 13,系統會回報含有 API_LEVELnonComplianceDetail

CredentialProviderPolicyDefault

控管哪些應用程式可在 Android 14 以上版本中做為憑證提供者使用。這些應用程式會儲存憑證,詳情請參閱這個網頁這個網頁。另請參閱 credentialProviderPolicy

列舉
CREDENTIAL_PROVIDER_POLICY_DEFAULT_UNSPECIFIED 未指定。預設為 CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED。
CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED 未指定 credentialProviderPolicy 的應用程式無法做為憑證提供者。
CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED_EXCEPT_SYSTEM 未指定 credentialProviderPolicy 的應用程式不得做為憑證提供者,除非原始設備製造商 (OEM) 的預設憑證提供者。原始設備製造商 (OEM) 的預設憑證提供者一律允許做為憑證提供者。

PrintingPolicy

控管是否允許列印。這項功能適用於搭載 Android 9 以上版本的裝置。

列舉
PRINTING_POLICY_UNSPECIFIED 未指定。預設值為 PRINTING_ALLOWED
PRINTING_DISALLOWED 不允許列印。如果 Android 版本低於 9,系統會回報含有 API_LEVELnonComplianceDetail
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_AUTOMATICBRIGHTNESS_FIXED,才能設定此屬性。支援 Android 9 以上版本的全代管裝置。如果 Android 版本低於 9,系統會回報含有 API_LEVELNonComplianceDetail

ScreenBrightnessMode

控制螢幕亮度模式。

列舉
SCREEN_BRIGHTNESS_MODE_UNSPECIFIED 未指定。預設值為 BRIGHTNESS_USER_CHOICE
BRIGHTNESS_USER_CHOICE 使用者可設定螢幕亮度。無法設定「screenBrightness」。
BRIGHTNESS_AUTOMATIC 螢幕亮度模式會自動調整,此模式會自動調整亮度,且使用者無法設定螢幕亮度。你仍可設定「screenBrightness」。這項功能會在自動調整亮度時納入考量。支援 Android 9 以上版本的全代管裝置。如果 Android 版本低於 9,系統會回報含有 API_LEVELNonComplianceDetail
BRIGHTNESS_FIXED 螢幕亮度模式固定設為 screenBrightness,且使用者無法設定螢幕亮度。必須設定「screenBrightness」。支援 Android 9 以上版本的全代管裝置。如果 Android 版本低於 9,系統會回報含有 API_LEVELNonComplianceDetail

ScreenTimeoutSettings

控管螢幕自動關閉時間設定。

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

enum (ScreenTimeoutMode)

選用設定。控管是否允許使用者設定螢幕自動關閉功能。

screenTimeout

string (Duration format)

選用設定。控管螢幕自動關閉時間。螢幕自動關閉時間必須大於 0,否則會遭到拒絕。此外,該值不應大於 maximumTimeToLock,否則螢幕自動關閉時間會設為 maximumTimeToLockNonComplianceDetail 則指出 INVALID_VALUE 原因和 SCREEN_TIMEOUT_GREATER_THAN_MAXIMUM_TIME_TO_LOCK 具體原因已回報。如果螢幕自動關閉時間少於特定下限,則會設為下限。下限值可能因裝置而異。如果設定此屬性,screenTimeoutMode 必須為 SCREEN_TIMEOUT_ENFORCED。支援 Android 9 以上版本的全代管裝置。如果 Android 版本低於 9,系統會回報含有 API_LEVELNonComplianceDetail

持續時間以秒為單位,最多 9 個小數位數,結尾為「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_LEVELNonComplianceDetail

AssistContentPolicy

控制是否允許將 AssistContent 傳送至具有特殊權限的應用程式 (例如助理應用程式)。AssistContent 包含應用程式的螢幕截圖及相關資訊,例如套件名稱。這項功能適用於 Android 15 以上版本。

列舉
ASSIST_CONTENT_POLICY_UNSPECIFIED 未指定。預設值為 ASSIST_CONTENT_ALLOWED
ASSIST_CONTENT_DISALLOWED

系統無法將輔助內容傳送至具有特殊權限的應用程式。

支援 Android 15 以上版本。如果 Android 版本低於 15,系統會回報含有 API_LEVELnonComplianceDetail

ASSIST_CONTENT_ALLOWED

允許將輔助內容傳送至具有特殊權限的應用程式。

支援 Android 15 以上版本。

方法

delete

刪除政策。

get

取得政策。

list

列出指定企業的政策。

patch

更新或建立政策。