- 資源:政策
- ApplicationPolicy
- InstallType
- PermissionPolicy
- PermissionGrant
- DelegatedScope
- ManagedConfigurationTemplate
- ConnectedWorkAndPersonalApp
- AutoUpdateMode
- ExtensionConfig
- AlwaysOnVpnLockdownExemption
- WorkProfileWidgets
- CredentialProviderPolicy
- InstallConstraint
- NetworkTypeConstraint
- ChargingConstraint
- DeviceIdleConstraint
- UserControlSettings
- KeyguardDisabledFeature
- PersistentPreferredActivity
- SystemUpdate
- SystemUpdateType
- FreezePeriod
- 日期
- StatusReportingSettings
- ApplicationReportingSettings
- PackageNameList
- BatteryPluggedMode
- ProxyInfo
- ChoosePrivateKeyRule
- AlwaysOnVpnPackage
- LocationMode
- ComplianceRule
- NonComplianceDetailCondition
- ApiLevelCondition
- AppAutoUpdatePolicy
- AppTrack
- EncryptionPolicy
- PlayStoreMode
- SetupAction
- LaunchAppAction
- PolicyEnforcementRule
- BlockAction
- BlockScope
- WipeAction
- KioskCustomization
- PowerButtonActions
- SystemErrorWarnings
- SystemNavigation
- StatusBar
- DeviceSettings
- AdvancedSecurityOverrides
- UntrustedAppsPolicy
- GooglePlayProtectVerifyApps
- DeveloperSettings
- CommonCriteriaMode
- MtePolicy
- PersonalUsagePolicies
- PlayStoreMode
- PersonalApplicationPolicy
- InstallType
- AutoDateAndTimeZone
- OncCertificateProvider
- ContentProviderEndpoint
- CrossProfilePolicies
- ShowWorkContactsInPersonalProfile
- CrossProfileCopyPaste
- CrossProfileDataSharing
- WorkProfileWidgetsDefault
- PreferentialNetworkService
- UsageLog
- LogType
- CameraAccess
- MicrophoneAccess
- DeviceConnectivityManagement
- UsbDataAccess
- ConfigureWifi
- WifiDirectSettings
- TetheringSettings
- WifiSsidPolicy
- WifiSsidPolicyType
- WifiSsid
- DeviceRadioState
- WifiState
- AirplaneModeState
- UltraWidebandState
- CellularTwoGState
- MinimumWifiSecurityLevel
- CredentialProviderPolicyDefault
- PrintingPolicy
- DisplaySettings
- ScreenBrightnessSettings
- ScreenBrightnessMode
- ScreenTimeoutSettings
- ScreenTimeoutMode
- 方法
資源:政策
政策資源代表一組設定,可控管受管理裝置行為,以及裝置上安裝的應用程式。
JSON 表示法 |
---|
{ "name": string, "version": string, "applications": [ { object ( |
欄位 | |
---|---|
name |
政策名稱,格式為 |
version |
政策版本。此為唯讀欄位。每次更新政策時,版本就會遞增。 |
applications[] |
政策已套用至應用程式。最多只能有 3,000 個元素。 |
maximumTimeToLock |
使用者活動最久的時間 (以毫秒為單位),直到裝置鎖定為止。如果值為 0,表示沒有限制。 |
screenCaptureDisabled |
是否停用螢幕畫面擷取功能。 |
cameraDisabled |
如果將 |
keyguardDisabledFeatures[] |
停用鍵盤鎖自訂功能,例如小工具。 |
defaultPermissionPolicy |
執行階段權限要求的預設權限政策。 |
persistentPreferredActivities[] |
預設意圖處理常式活動。 |
openNetworkConfiguration |
裝置的網路設定。詳情請參閱設定網路。 |
systemUpdate |
系統更新政策,用於控管 OS 更新的套用方式。如果更新類型為 注意: Google Play 系統更新 (也稱為 Mainline 更新) 會自動下載,且需要重新啟動裝置才能安裝。詳情請參閱「管理系統更新」中的主要部分。 |
accountTypesWithManagementDisabled[] |
使用者無法管理的帳戶類型。 |
addUserDisabled |
是否無法新增使用者和個人資料。 |
adjustVolumeDisabled |
是否停用調整主磁碟區功能。同時將裝置設為靜音。 |
factoryResetDisabled |
是否停用透過設定恢復原廠設定的功能。 |
installAppsDisabled |
是否停用使用者安裝應用程式的功能。 |
mountPhysicalMediaDisabled |
使用者是否停用掛接實體外部媒體。 |
modifyAccountsDisabled |
新增或移除帳戶的功能已停用。 |
safeBootDisabled |
「重新啟動裝置」是否安全啟動功能已停用。 |
uninstallAppsDisabled |
是否停用使用者解除安裝應用程式功能。這可以防止使用者解除安裝應用程式,即使是透過 |
statusBarDisabled |
是否停用狀態列。這會停用通知、快速設定以及其他允許從全螢幕模式跳脫的螢幕重疊顯示。已淘汰。如要停用資訊站裝置上的狀態列,請使用 InstallType |
keyguardDisabled |
如果為 true,則會停用主要和/或次要顯示器的螢幕鎖定功能。 |
minimumApiLevel |
允許的最低 Android API 級別。 |
statusReportingSettings |
狀態回報設定 |
bluetoothContactSharingDisabled |
是否停用藍牙聯絡人共用功能。 |
shortSupportMessage |
如果管理員已停用這項功能,系統會在設定畫面中向使用者顯示訊息。如果訊息超過 200 個字元,可能會遭到截斷。 |
longSupportMessage |
裝置管理員設定畫面中向使用者顯示的訊息。 |
passwordRequirements |
密碼規定。不得設定「 注意:
|
wifiConfigsLockdownEnabled |
已淘汰 - 使用 wifiConfigDisabled。 |
bluetoothConfigDisabled |
是否停用藍牙設定。 |
cellBroadcastsConfigDisabled |
設定區域廣播是否已停用。 |
credentialsConfigDisabled |
設定使用者憑證是否已停用。 |
mobileNetworksConfigDisabled |
是否停用行動網路設定功能。 |
tetheringConfigDisabled |
設定網路共用和可攜式無線基地台設定是否已停用。如果將 |
vpnConfigDisabled |
設定 VPN 是否已停用。 |
wifiConfigDisabled |
設定 Wi-Fi 網路是否已停用。支援全代管裝置和公司裝置上的工作資料夾。如果是全代管裝置,將這項設定設為 True 會移除所有已設定的網路,並只保留使用 |
createWindowsDisabled |
停用為應用程式視窗以外建立視窗的功能是否已停用。 |
networkResetDisabled |
是否已停用重設網路設定。 |
outgoingBeamDisabled |
是否已停用使用 NFC 傳輸應用程式資料的功能。 |
outgoingCallsDisabled |
是否停用撥出電話。 |
removeUserDisabled |
已停用移除其他使用者的功能。 |
shareLocationDisabled |
是否停用位置資訊分享功能。全代管裝置和個人擁有的工作資料夾皆可使用 |
smsDisabled |
是否停用收發簡訊的功能。 |
unmuteMicrophoneDisabled |
如果將 |
usbFileTransferDisabled |
是否已停用透過 USB 傳輸檔案。這項功能僅適用於公司擁有的裝置。 |
ensureVerifyAppsEnabled |
是否強制啟用應用程式驗證功能。 |
permittedInputMethods |
如有這類項目,系統只會允許這份清單中的套件提供的輸入法。如果有這個欄位,但清單為空白,表示僅允許使用系統輸入法。 |
stayOnPluggedModes[] |
裝置處於開機狀態的電池已接上電源。使用這項設定時,建議您清除 |
recommendedGlobalProxy |
獨立於網路的全域 HTTP Proxy。一般來說, |
setUserIconDisabled |
是否停用變更使用者圖示。 |
setWallpaperDisabled |
是否停用變更桌布的功能。 |
choosePrivateKeyRules[] |
應用程式決定規則存取私密金鑰詳情請參閱 |
alwaysOnVpnPackage |
設定永久連線 VPN 連線。與 |
frpAdminEmails[] |
用於恢復原廠設定保護機制的裝置管理員電子郵件地址。將裝置恢復原廠設定後,使用者必須其中一位管理員使用 Google 帳戶電子郵件地址和密碼登入,才能解鎖裝置。如果未指定管理員,裝置將不提供恢復原廠設定保護機制。 |
deviceOwnerLockScreenInfo |
鎖定畫面上顯示的裝置擁有者資訊。 |
dataRoamingDisabled |
是否停用漫遊數據服務。 |
locationMode |
位置偵測功能的啟用程度。 |
networkEscapeHatchEnabled |
是否啟用網路逸出網路。如果無法在開機時建立網路連線,逸出模式會提示使用者暫時連線至網路,以便重新整理裝置政策。套用政策後,系統會清除臨時網路,裝置將繼續啟動。這樣一來,如果目前政策中沒有合適的網路,且裝置以鎖定任務模式啟動應用程式,或是使用者無法前往裝置設定,那麼使用者就無法連線到網路。 注意:將 |
bluetoothDisabled |
是否停用藍牙。建議優先使用這項設定,而非 |
complianceRules[] |
此規則用於宣告裝置不符合政策時,應採取哪些動作。符合多項規則的條件時,系統會套用該規則的所有緩解動作。規則數量上限為 100 個。請改用政策強制執行規則。 |
blockApplicationsEnabled |
系統是否會封鎖非透過 |
installUnknownSourcesAllowed |
此欄位無效。 |
debuggingFeaturesAllowed |
使用者是否獲準啟用偵錯功能。 |
funDisabled |
使用者是否可以享受樂趣。控制是否在「設定」中停用復活節彩蛋遊戲。 |
autoTimeRequired |
是否必須使用自動時間,以防止使用者手動設定日期和時間。如果設定了 |
permittedAccessibilityServices |
指定允許的無障礙服務。如果不設定這個欄位,可使用任何無障礙服務。如果設定這個欄位,就只能使用這份清單中的無障礙服務和系統內建的無障礙服務。特別是,如果這個欄位設為空白,就只能使用系統內建的無障礙服務。這項設定可在全代管裝置上和工作資料夾中設定。如果套用至工作資料夾,則個人資料夾和工作資料夾都會受到影響。 |
appAutoUpdatePolicy |
建議的替代方案: 當 應用程式自動更新政策,可控管可套用自動更新應用程式的時間。 |
kioskCustomLauncherEnabled |
是否已啟用資訊站自訂啟動器。這會將主畫面替換為啟動器,可用於鎖定透過 |
androidDevicePolicyTracks[] |
不支援這項設定。系統會忽略所有值。 |
skipFirstUseHintsEnabled |
初次使用時略過提示的旗標。企業管理員可以啟用系統建議,讓應用程式在首次啟動時略過使用者教學課程和其他入門提示。 |
privateKeySelectionEnabled |
允許在 ChoosePrivateKeyRules 中沒有相符的規則時,在裝置上顯示 UI,讓使用者選擇私密金鑰別名。如果是搭載 Android P 以下版本的裝置,這項設定可能會導致企業金鑰出現安全漏洞。如果任何應用程式具有 |
encryptionPolicy |
是否已啟用加密功能 |
usbMassStorageEnabled |
是否已啟用 USB 儲存裝置。已淘汰。 |
permissionGrants[] |
所有應用程式的明確權限或群組授予或拒絕權限。這些值會覆寫 |
playStoreMode |
這個模式可控管使用者能在 Play 商店中存取哪些應用程式,以及應用程式從政策中移除後的行為。 |
setupActions[] |
設定過程中要採取的動作。最多只能指定一個動作。 |
passwordPolicies[] |
密碼要求政策。您可以設定政策中的 |
policyEnforcementRules[] |
定義無法在裝置上套用特定政策行為的規則 |
kioskCustomization |
這些設定可控管裝置在 Kiosk 模式的行為。如要啟用 Kiosk 模式,請將 |
advancedSecurityOverrides |
進階安全性設定。在大多數情況下,您不需要進行這些設定。 |
personalUsagePolicies |
管理公司裝置個人使用行為的政策。 |
autoDateAndTimeZone |
公司裝置是否啟用自動日期、時間和時區。如果設定此屬性,系統會忽略 |
oncCertificateProviders[] |
這項功能尚未正式發布。 |
crossProfilePolicies |
在裝置上套用的跨設定檔政策。 |
preferentialNetworkService |
控管是否在工作資料夾中啟用偏好的網路服務。舉例來說,特定機構可能與電信業者簽訂協議,列出所有員工的工作資料裝置會透過企業專用網路服務傳送。使用 5G 網路的企業配量便是支援首選網路服務的例子。這不會對完全受管理的裝置造成影響。 |
usageLog |
裝置活動記錄設定。 |
cameraAccess |
控管攝影機的使用情況,以及使用者能否存取相機存取權切換鈕。 |
microphoneAccess |
控管麥克風使用情形,以及使用者能否存取麥克風存取權切換鈕。這項設定僅適用於全代管裝置。 |
deviceConnectivityManagement |
包含裝置連線的控制項,例如 Wi-Fi、USB 數據連線、鍵盤/滑鼠連線等。 |
deviceRadioState |
涵蓋無線電狀態的控制項,例如 Wi-Fi、藍牙等。 |
credentialProviderPolicyDefault |
控管哪些應用程式可在 Android 14 以上版本中做為憑證提供者使用。這些應用程式會儲存憑證,詳情請參閱這個網頁和這個網頁。另請參閱 |
printingPolicy |
選用設定。控管是否允許列印。這項功能適用於搭載 Android 9 以上版本的裝置。。 |
displaySettings |
選用設定。顯示設定的控制項。 |
ApplicationPolicy
個別應用程式的政策。注意:如果啟用
,則無法透過這項政策變更指定裝置上的應用程式供應情形。每個政策可以指定的應用程式數量上限為 3,000 個。installAppsDisabled
JSON 表示法 |
---|
{ "packageName": string, "installType": enum ( |
欄位 | |||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
packageName |
應用程式的套件名稱。例如 |
||||||||||||||||
installType |
要執行的安裝類型。 |
||||||||||||||||
lockTaskAllowed |
是否允許應用程式自行以全螢幕模式鎖定。已淘汰。使用 InstallType |
||||||||||||||||
defaultPermissionPolicy |
應用程式要求所有權限的預設政策。若指定,系統會覆寫適用於所有應用程式的政策層級 |
||||||||||||||||
permissionGrants[] |
授予或拒絕應用程式的明確權限。這些值會覆寫所有應用程式的 |
||||||||||||||||
managedConfiguration |
已將受管理設定套用至應用程式。設定格式取決於應用程式支援的
|
||||||||||||||||
disabled |
應用程式是否已停用。停用後,系統仍會保留應用程式資料。 |
||||||||||||||||
minimumVersionCode |
裝置上執行的應用程式最低版本。如果已設定,裝置會嘗試將應用程式更新至至少這個版本代碼。如果應用程式不是最新版本,裝置會包含 |
||||||||||||||||
delegatedScopes[] |
透過 Android Device Policy 委派給應用程式的範圍。這麼做可為套用這些角色的應用程式提供額外權限, |
||||||||||||||||
managedConfigurationTemplate |
應用程式的受管理設定範本 (從受管理的設定 iframe 儲存)。如果已設定 managedConfiguration,系統將忽略這個欄位。 |
||||||||||||||||
accessibleTrackIds[] |
企業裝置可存取的應用程式追蹤 ID 清單。如果清單包含多個測試群組 ID,裝置會在所有可存取的測試群組中接收最新版本。如果清單中沒有測試群組 ID,表示裝置只能存取應用程式的正式版群組。AppTrackInfo 是各測試群組的詳細資訊。 |
||||||||||||||||
connectedWorkAndPersonalApp |
控制應用程式能否透過裝置的工作資料夾和個人資料夾本身通訊,但仍取得使用者同意。 |
||||||||||||||||
autoUpdateMode |
控管應用程式的自動更新模式。 |
||||||||||||||||
extensionConfig |
這項設定會將此應用程式設為擴充功能應用程式,以便離線與 Android Device Policy 互動。 最多可以為一個應用程式設定這個欄位。 |
||||||||||||||||
alwaysOnVpnLockdownExemption |
指定在未連線 VPN 且啟用 |
||||||||||||||||
workProfileWidgets |
指定是否能在工作資料夾中安裝的應用程式在主畫面中新增小工具。 |
||||||||||||||||
credentialProviderPolicy |
選用設定。是否允許應用程式在 Android 14 以上版本中做為憑證提供者。 |
||||||||||||||||
installConstraint[] |
選用設定。安裝應用程式的限制。您最多可以指定一個 |
||||||||||||||||
installPriority |
選用設定。在應用程式的 這會控制安裝的相對優先順序。如果值為 0 (預設),表示這個應用程式不高於其他應用程式。如果值介於 1 到 10,000 之間,值越小代表優先順序越高。系統會拒絕介於 0 到 10,000 (含) 之間的值。 |
||||||||||||||||
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 以上版本中, |
DENY |
自動拒絕權限。 |
PermissionGrant
Android 權限的設定及其授權狀態。
JSON 表示法 |
---|
{
"permission": string,
"policy": enum ( |
欄位 | |
---|---|
permission |
Android 權限或群組,例如 |
policy |
授予權限的政策。 |
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 |
授予網路活動記錄的存取權。允許委派的應用程式呼叫 setNetworkLoggingEnabled 、isNetworkLoggingEnabled 和 retrieveNetworkLogs 方法。這個範圍最多只能委派一個應用程式。支援搭載 Android 10 以上版本的全代管裝置。支援 Android 12 以上版本的工作資料夾。如果支援委派功能且已設定委派,則系統會忽略 。 |
SECURITY_LOGS |
授予安全性記錄的存取權。允許委派的應用程式呼叫 setSecurityLoggingEnabled 、isSecurityLoggingEnabled 、retrieveSecurityLogs 和 retrievePreRebootSecurityLogs 方法。這個範圍最多只能委派一個應用程式。支援完全受管理的裝置,以及設有工作資料夾的公司裝置 (須搭載 Android 12 以上版本)。如果支援委派功能且已設定委派,則系統會忽略 。 |
CERT_SELECTION |
可代表提出要求的應用程式,授予選取 KeyChain 憑證的權限。授予後,委派的應用程式就會開始接收 DelegatedAdminReceiver#onChoosePrivateKeyAlias 。允許委派的應用程式呼叫 grantKeyPairToApp 和 revokeKeyPairFromApp 方法。最多只能有一個具備此委派功能的應用程式。如果將憑證選取委派給應用程式, 必須空白, 不會產生任何作用。 |
ManagedConfigurationTemplate
應用程式的受管理設定範本 (從受管理的設定 iframe 儲存)。
JSON 表示法 |
---|
{ "templateId": string, "configurationVariables": { string: string, ... } } |
欄位 | |
---|---|
templateId |
受管理設定範本的 ID。 |
configurationVariables |
選用,地圖包含 <鍵, 值>個別設定變數的配置變數 這個物件中包含 |
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 |
預設的更新模式。 應用程式會自動更新為低優先順序,盡可能降低對使用者的影響。 符合下列所有限制時,應用程式就會更新:
開發人員發布更新後,裝置會在 24 小時內收到通知,之後應用程式會在下次符合上述限制條件時進行更新。 |
AUTO_UPDATE_POSTPONED |
應用程式版本過舊後,最多不超過 90 天未自動更新。 應用程式過時 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[] |
擴充功能應用程式的簽署憑證的十六進位編碼 SHA-256 雜湊。只有 64 個字元的十六進位字串才有效。 如未指定,則會從 Play 商店取得相應套件名稱的簽名。 如果這份清單沒有任何內容,裝置上的擴充功能應用程式簽名必須與從 Play 商店取得的簽章相同,應用程式才能與 Android Device Policy 通訊。 如果這份清單並非空白,裝置上的擴充功能應用程式簽名必須與這份清單中的任一項目相符,應用程式才能與 Android Device Policy 通訊。 在實際工作環境中,建議將這個欄位留空。 |
notificationReceiver |
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 |
未指定。預設為
|
WORK_PROFILE_WIDGETS_ALLOWED |
允許工作資料夾小工具。這表示應用程式可以在主畫面中新增小工具。 |
WORK_PROFILE_WIDGETS_DISALLOWED |
禁止使用工作資料夾小工具。這表示應用程式無法將小工具新增至主畫面。 |
CredentialProviderPolicy
是否允許應用程式在 Android 14 以上版本中做為憑證提供者。
列舉 | |
---|---|
CREDENTIAL_PROVIDER_POLICY_UNSPECIFIED |
未指定。行為受 規範。 |
CREDENTIAL_PROVIDER_ALLOWED |
允許應用程式做為憑證提供者。 |
InstallConstraint
在應用程式的
設為:InstallType
定義一組應用程式安裝限制。至少要設定其中一個欄位。如果設定多個欄位,則必須滿足所有條件,才能安裝應用程式。
JSON 表示法 |
---|
{ "networkTypeConstraint": enum ( |
欄位 | |
---|---|
networkTypeConstraint |
選用設定。網路類型限制。 |
chargingConstraint |
選用設定。充電限制。 |
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 |
使用應用程式的預設行為,判斷是否允許或禁止使用者控制項。大多數應用程式預設都允許使用者控制項,但某些重要應用程式 (例如隨附應用程式 ( 設為 true)、資訊站應用程式和其他重要系統應用程式) 不允許使用者控制項。 |
USER_CONTROL_ALLOWED |
允許應用程式的使用者控制項。資訊站應用程式可以使用這項功能讓使用者進行控制。 |
USER_CONTROL_DISALLOWED |
不允許這個應用程式的使用者控制項。如果 Android 版本低於 11,系統會回報 。 |
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 |
應為預設意圖處理常式的活動。應為 Android 元件名稱,例如 |
actions[] |
在篩選器中要比對的意圖動作。如有任何動作包含在篩選器中,則意圖動作必須是上述其中一個值,系統才會比對意圖。如未納入任何動作,系統就會忽略意圖動作。 |
categories[] |
在篩選器中要比對的意圖類別。意圖包含所需的類別;所有類別都必須加入篩選器中,系統才會比對出意圖。換句話說,除非在意圖中指定該類別,否則在篩選器中新增類別不會影響比對。 |
SystemUpdate
管理系統更新的管理設定
注意: Google Play 系統更新 (也稱為 Mainline 更新) 會自動下載,但需要重新啟動裝置才能安裝。詳情請參閱「管理系統更新」中的主要部分。
JSON 表示法 |
---|
{ "type": enum ( |
欄位 | |
---|---|
type |
要設定的系統更新類型。 |
startMinutes |
如果類型為 |
endMinutes |
如果類型為 |
freezePeriods[] |
每年重複的無線更新 (OTA) 系統更新期間,會延後凍結裝置上執行的 OS 版本。為避免裝置無限期凍結,每個凍結期必須至少 60 天。 |
SystemUpdateType
系統更新設定的類型。
列舉 | |
---|---|
SYSTEM_UPDATE_TYPE_UNSPECIFIED |
按照裝置的預設更新行為進行,一般會要求使用者接受系統更新。 |
AUTOMATIC |
有更新時自動安裝。 |
WINDOWED |
在每日維護期間自動安裝。這會同時將 Play 應用程式設為在視窗中更新。對於資訊站裝置,我們強烈建議採取這種做法,因為 Google Play 只能更新持續固定至前景的應用程式。 如果將應用程式的 |
POSTPONE |
延後自動安裝最長 30 天。這項政策不會影響安全性更新 (例如每月安全性修補程式)。 |
FreezePeriod
系統凍結期間。如果裝置的時鐘處於凍結期間,所有收到的系統更新 (包括安全性修補程式) 都會遭到封鎖,不會安裝。
裝置未處於任何設定的凍結期間時,會套用一般政策行為 (自動、維護期間或延期)。
凍結期間計算作業會忽略閏年,尤其是:
- 如果將 2. 29 號設為凍結期間的開始或結束日期,凍結期將從 2 月 28 日開始或結束。
- 如果裝置的系統時鐘讀到 2 月 29 日,則視為 2 月 28 日。
- 如果是計算凍結期間或兩個凍結期間之間的天數,系統將忽略 2 月 29 日,而非一天。
注意:凍結期間須指定政策,因此無法將
指定為 SystemUpdateType
。SYSTEM_UPDATE_TYPE_UNSPECIFIED
JSON 表示法 |
---|
{ "startDate": { object ( |
欄位 | |
---|---|
startDate |
凍結期間的開始日期 (含此日期)。注意:不得設定 |
endDate |
凍結期間的結束日期 (含此日期)。必須在開始日期後的 90 天內。如果結束日期早於開始日期,系統會將凍結期間視為結束年末。注意:不得設定 |
日期
代表完整或部分的日曆日期,例如生日。您可以指明時段和時區,或者在其他地方指定時間或時區。日期以公曆為基準。可能代表下列其中一項:
- 完整日期,具有非零的年、月和日值。
- 日期為 0 的月份和日期,例如週年紀念日。
- 有 1 年,第 0 個月卻為 0 天。
- 年和月,但數字為零 (例如信用卡到期日)。
相關類型:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON 表示法 |
---|
{ "year": integer, "month": integer, "day": integer } |
欄位 | |
---|---|
year |
日期的年份。這個值必須介於 1 至 9999,或 0 之間可指定不含年份的日期。 |
month |
一年中的月份。必須介於 1 到 12 之間,或 0 可以指定不含月份和日期的年份。 |
day |
一個月中的第幾天。這個值必須介於 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 ( |
欄位 | |
---|---|
applicationReportsEnabled |
是否啟用應用程式報告。 |
deviceSettingsEnabled |
是否啟用裝置設定回報功能。 |
softwareInfoEnabled |
是否啟用軟體資訊回報功能。 |
memoryInfoEnabled |
是否啟用記憶體事件報告。 |
networkInfoEnabled |
是否啟用網路資訊回報功能。 |
displayInfoEnabled |
是否啟用多媒體廣告報表。針對設有工作資料夾的個人擁有裝置,系統無法提供回報資料。 |
powerManagementEventsEnabled |
是否啟用電源管理事件報告。針對設有工作資料夾的個人擁有裝置,系統無法提供回報資料。 |
hardwareStatusEnabled |
是否啟用硬體狀態回報功能。針對設有工作資料夾的個人擁有裝置,系統無法提供回報資料。 |
systemPropertiesEnabled |
是否啟用系統資源報告功能。 |
applicationReportingSettings |
應用程式報告設定。只有在 applicationReportingEnabled 為 true 時適用。 |
commonCriteriaModeEnabled |
是否啟用 |
ApplicationReportingSettings
控制應用程式報告行為的設定。
JSON 表示法 |
---|
{ "includeRemovedApps": boolean } |
欄位 | |
---|---|
includeRemovedApps |
應用程式報告是否包含已移除的應用程式。 |
PackageNameList
套件名稱清單。
JSON 表示法 |
---|
{ "packageNames": [ string ] } |
欄位 | |
---|---|
packageNames[] |
套件名稱清單。 |
BatteryPluggedMode
電池接頭的模式。
列舉 | |
---|---|
BATTERY_PLUGGED_MODE_UNSPECIFIED |
系統會忽略這個值。 |
AC |
電源是 AC 充電器。 |
USB |
電源有 USB 連接埠。 |
WIRELESS |
電源為無線。 |
ProxyInfo
HTTP Proxy 的設定資訊。如果是直接 Proxy,請設定 host
、port
和 excludedHosts
欄位。如果是 PAC 指令碼 Proxy,請設定 pacUri
欄位。
JSON 表示法 |
---|
{ "host": string, "port": integer, "excludedHosts": [ string ], "pacUri": string } |
欄位 | |
---|---|
host |
直接 Proxy 的主機。 |
port |
直接 Proxy 的通訊埠。 |
excludedHosts[] |
如果是直接 Proxy,則系統會略過該 Proxy 的主機。主機名稱可以包含萬用字元,例如 *.example.com。 |
pacUri |
用來設定 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 |
要比對要求網址的網址格式。如未設定或留空,系統會比對所有網址。這會使用 |
packageNames[] |
要套用這項規則的套件名稱。系統會根據 Play 提供的雜湊,驗證每個應用程式的簽署憑證雜湊。如果未指定套件名稱,系統會為呼叫 |
privateKeyAlias |
要使用的私密金鑰的別名。 |
AlwaysOnVpnPackage
設定永久連線 VPN 連線。
JSON 表示法 |
---|
{ "packageName": string, "lockdownEnabled": boolean } |
欄位 | |
---|---|
packageName |
VPN 應用程式的套件名稱。 |
lockdownEnabled |
不允許在未連線 VPN 的情況下網路。 |
LocationMode
在工作資料夾和完全受管理的裝置中啟用位置偵測功能的程度。
列舉 | |
---|---|
LOCATION_MODE_UNSPECIFIED |
預設值為 LOCATION_USER_CHOICE 。 |
HIGH_ACCURACY |
如果是 Android 8 以下版本,已啟用所有位置偵測方法,包括 GPS、網路和其他感應器。在 Android 9 以上版本中,這相當於 |
SENSORS_ONLY |
如果是 Android 8 以下版本,系統只會啟用 GPS 和其他感應器。在 Android 9 以上版本中,這相當於 |
BATTERY_SAVING |
在 Android 8 以下版本中,系統只會啟用網路位置供應商。在 Android 9 以上版本中,這相當於 |
OFF |
Android 8 以下版本已停用位置資訊設定和精確度。在 Android 9 以上版本中,這相當於 |
LOCATION_USER_CHOICE |
裝置上的位置資訊設定未受限制。我們並未設定或強制執行特定行為。 |
LOCATION_ENFORCED |
在裝置上啟用位置資訊設定。 |
LOCATION_DISABLED |
停用裝置的位置資訊設定。 |
ComplianceRule
一項規則,用來宣告裝置不符合政策時,應採取哪些動作。每項規則都有隱含將 Device
資源的 policyCompliant
設為 false,並在裝置上顯示訊息,指出裝置不符合政策。視規則中的欄位值而定,您或許也可以採取其他緩解動作。
JSON 表示法 |
---|
{ "disableApps": boolean, "packageNamesToDisable": [ string ], // Union field |
欄位 | |
---|---|
disableApps |
如果設為 true,規則會執行降低應用程式的停用動作,以便有效地停用裝置,但會保留應用程式資料。如果裝置在鎖定的工作模式下執行應用程式,該應用程式就會關閉,並顯示違規原因的 UI。 |
packageNamesToDisable[] |
如果設定這項政策,規則會包含停用清單中指定的應用程式的緩解動作,但會保留應用程式資料。 |
聯集欄位 condition 。條件滿足時,就會觸發規則中定義的緩解動作。必須明確設定其中一項條件。condition 只能是下列其中一項: |
|
nonComplianceDetailCondition |
如果裝置有「任何」相符的 |
apiLevelCondition |
如果裝置上的 Android Framework API 級別未達到最低要求,所滿足的條件。 |
NonComplianceDetailCondition
裝置只要有「任何」相符的 NonComplianceDetail
,就會滿足以下規範規則條件。如果 NonComplianceDetailCondition
中設定的欄位「所有」都與對應的 NonComplianceDetail
欄位相符,NonComplianceDetail
就會與 NonComplianceDetailCondition
相符。
JSON 表示法 |
---|
{
"settingName": string,
"nonComplianceReason": enum ( |
欄位 | |
---|---|
settingName |
政策設定的名稱。這是頂層 |
nonComplianceReason |
裝置不符合設定的原因。如未設定,則與任何原因相符。 |
packageName |
不符合規定的應用程式套件名稱。如未設定,則條件符合任何套件名稱。 |
ApiLevelCondition
如果裝置的 Android Framework API 級別未達到最低要求,所滿足的法規遵循規則條件。每項政策只能有一個設有這類條件的規則。
JSON 表示法 |
---|
{ "minApiLevel": integer } |
欄位 | |
---|---|
minApiLevel |
所需的最低 Android Framework 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 |
應用程式只能透過 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 ( |
欄位 | |
---|---|
title |
這個動作的標題。 |
description |
此動作的說明。 |
聯集欄位 action 。設定期間要執行的動作。action 只能是下列其中一項: |
|
launchApp |
啟動應用程式的動作。此應用程式將啟動,其中包含一個意圖,其中的額外項目 ( |
LaunchAppAction
啟動應用程式的動作。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 launch 。要執行的啟動動作說明 launch 只能採用下列其中一項: |
|
packageName |
要啟動的應用程式套件名稱 |
PolicyEnforcementRule
定義在裝置或工作資料夾不符合 settingName
中指定的政策時要採取的動作。如果有多個相符規則或已觸發多項強制執行規則,系統會合併,並以最嚴重的動作執行合併作業。不過,系統仍會追蹤所有已觸發的規則,包括初始觸發時間,以及所有相關的違規詳情。如果符合最嚴重的違規處置規則,系統會接著套用最合適的後續步驟。
JSON 表示法 |
---|
{ "blockAction": { object ( |
欄位 | |
---|---|
blockAction |
這個動作會禁止公司擁有的裝置或工作資料夾中的應用程式和資料的存取權。並在可行情況下觸發面向使用者的通知,說明如何修正法規遵循問題。注意:必須一併指定 |
wipeAction |
重設公司擁有的裝置或刪除工作資料夾的動作。注意:必須一併指定 |
聯集欄位 trigger 。觸發這項規則的條件。trigger 只能是下列其中一項: |
|
settingName |
要強制執行的頂層政策。例如 |
BlockAction
這個動作會禁止在全代管裝置或工作資料夾中存取應用程式和資料。這項操作會觸發裝置或工作資料夾,向使用者顯示通知時,其中會盡可能提供修正法規遵循問題的相關資訊 (如果可以的話)。注意:必須一併指定 wipeAction
。
JSON 表示法 |
---|
{
"blockAfterDays": integer,
"blockScope": enum ( |
欄位 | |
---|---|
blockAfterDays |
不符合這項政策規定的天數,否則裝置或工作資料夾遭到封鎖。如要立即封鎖存取權,請設為 0。 |
blockScope |
指定這個 |
BlockScope
指定 BlockAction
的範圍。僅適用於公司擁有的裝置。
列舉 | |
---|---|
BLOCK_SCOPE_UNSPECIFIED |
未指定。預設值為 BLOCK_SCOPE_WORK_PROFILE 。 |
BLOCK_SCOPE_WORK_PROFILE |
封鎖動作只會套用到工作資料夾中的應用程式。個人資料夾中的應用程式不會受到影響。 |
BLOCK_SCOPE_DEVICE |
封鎖動作會套用至整個裝置,包括個人資料夾中的應用程式。 |
WipeAction
重設公司擁有的裝置或刪除工作資料夾的動作。注意:必須一併指定 blockAction
。
JSON 表示法 |
---|
{ "wipeAfterDays": integer, "preserveFrp": boolean } |
欄位 | |
---|---|
wipeAfterDays |
不符合這項政策規定的天數,系統會抹除裝置或工作資料夾的資料。 |
preserveFrp |
是否要將恢復原廠設定保護機制資料保留在裝置上。這項設定不適用於工作資料夾。 |
KioskCustomization
這些設定可控管裝置在 Kiosk 模式的行為。如要啟用 Kiosk 模式,請將 kioskCustomLauncherEnabled
設為 true
,或在政策中使用 installType
KIOSK
指定應用程式。
JSON 表示法 |
---|
{ "powerButtonActions": enum ( |
欄位 | |
---|---|
powerButtonActions |
設定使用者按住 (長按) 電源鍵時,在 Kiosk 模式中的行為。 |
systemErrorWarnings |
指出在 Kiosk 模式中,系統是否針對當機或無回應的應用程式封鎖系統錯誤對話方塊。封鎖後,系統會像使用者選擇「關閉應用程式」一樣,強制停止應用程式選項。 |
systemNavigation |
指定要在 Kiosk 模式下啟用的導覽功能 (例如首頁、總覽按鈕)。 |
statusBar |
指定在 Kiosk 模式下是否停用系統資訊和通知。 |
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 關閉應用程式一樣,強制停止應用程式。 |
StatusBar
指定在 Kiosk 模式下是否停用系統資訊和通知。
列舉 | |
---|---|
STATUS_BAR_UNSPECIFIED |
未指定,預設為 INFO_AND_NOTIFICATIONS_DISABLED 。 |
NOTIFICATIONS_AND_SYSTEM_INFO_ENABLED |
系統資訊和通知會顯示在 Kiosk 模式的狀態列上。 注意:如要讓這項政策生效,必須使用 |
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 |
是否強制執行 Google Play 安全防護驗證。取代 |
developerSettings |
控管開發人員設定的存取權:開發人員選項和安全啟動。取代 |
commonCriteriaMode |
控管共同準則模式:資訊科技安全評估共同準則 (CC) 中定義的安全標準。啟用共通條件模式會增加裝置上的特定安全性元件,包括藍牙長期金鑰的 AES-GCM 加密,以及 Wi-Fi 設定存放區。 只有搭載 Android 11 以上版本的公司裝置才支援共同條件模式。 警告:一般而言,只有國家安全系統和其他高度敏感組織中使用的 IT 產品才需要使用高強度的安全性模型。標準裝置使用可能會受到影響。只有在必要時啟用。 |
personalAppsThatCanReadWorkNotifications[] |
可使用 NotificationListenerService 讀取工作資料夾通知的個人應用程式。根據預設,除了系統應用程式以外,任何個人應用程式都無法讀取工作通知。清單中的每個值都必須是套件名稱。 |
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,使用者可以選擇在裝置上啟用或停用 MTE。 |
MTE_ENFORCED |
裝置已啟用 MTE,且使用者無法變更這項設定。您可以針對公司擁有的全代管裝置和工作資料夾設定這項功能。針對其他管理模式,系統會回報具有 支援 Android 14 以上版本。如果 Android 版本低於 14,系統會回報含有 |
MTE_DISABLED |
該裝置已停用 MTE,且使用者無法變更這項設定。這項設定僅適用於全代管裝置。其他情況下,系統會回報包含 支援 Android 14 以上版本。如果 Android 版本低於 14,系統會回報含有 |
PersonalUsagePolicies
這類政策可控管公司裝置上與工作資料夾的個人使用行為。
JSON 表示法 |
---|
{ "cameraDisabled": boolean, "screenCaptureDisabled": boolean, "accountTypesWithManagementDisabled": [ string ], "maxDaysWithWorkOff": integer, "personalPlayStoreMode": enum ( |
欄位 | |
---|---|
cameraDisabled |
如果為 true,則個人資料夾的相機會停用。 |
screenCaptureDisabled |
如為 true,所有使用者的螢幕畫面擷取功能都會停用。 |
accountTypesWithManagementDisabled[] |
使用者無法管理的帳戶類型。 |
maxDaysWithWorkOff |
控管工作資料夾保持關閉的時間。時間長度下限必須至少為 3 天。其他詳細資料如下:
|
personalPlayStoreMode |
與 |
personalApplications[] |
這項政策會套用至個人資料夾中的應用程式。 |
PlayStoreMode
與 personalApplications
搭配使用,即可控管個人資料夾中應用程式的允許或封鎖方式。
列舉 | |
---|---|
PLAY_STORE_MODE_UNSPECIFIED |
未指定。預設值為 BLOCKLIST 。 |
BLACKLIST |
所有的 Play 商店應用程式都可以在個人資料夾中安裝,但 |
BLOCKLIST |
所有的 Play 商店應用程式都可以在個人資料夾中安裝,但 installType 為 personalApplications 中 BLOCKED 的應用程式除外。 |
ALLOWLIST |
只有在 personalApplications 中明確指定 installType 設為 AVAILABLE 的應用程式,才能在個人資料夾中安裝。 |
PersonalApplicationPolicy
針對設有工作資料夾的公司裝置個人資料夾中的應用程式適用的政策。
JSON 表示法 |
---|
{
"packageName": string,
"installType": enum ( |
欄位 | |
---|---|
packageName |
應用程式的套件名稱。 |
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 |
欄位 | |
---|---|
certificateReferences[] |
這項功能尚未正式發布。 |
聯集欄位 這項功能尚未正式發布。 |
|
contentProviderEndpoint |
這項功能尚未正式發布。 |
ContentProviderEndpoint
這項功能尚未正式發布。
JSON 表示法 |
---|
{ "uri": string, "packageName": string, "signingCertsSha256": [ string ] } |
欄位 | |
---|---|
uri |
這項功能尚未正式發布。 |
packageName |
這項功能尚未正式發布。 |
signingCertsSha256[] |
必要欄位。這項功能尚未正式發布。 |
CrossProfilePolicies
控管可透過個人資料夾存取的資料 (反之亦然)。如果裝置沒有工作資料夾,系統會回報搭載
的 MANAGEMENT_MODE
。nonComplianceDetail
JSON 表示法 |
---|
{ "showWorkContactsInPersonalProfile": enum ( |
欄位 | |
---|---|
showWorkContactsInPersonalProfile |
個人應用程式是否可以存取工作資料夾中儲存的聯絡人。 |
crossProfileCopyPaste |
是否可將從某個設定檔 (個人或工作) 複製的文字貼到另一個設定檔。 |
crossProfileDataSharing |
將某個設定檔的資料 (個人或工作資料) 能否與另一個設定檔中的應用程式共用。特別控管透過意圖共用資料的方式。管理其他跨個人資料通訊管道,例如聯絡人搜尋、複製/貼上或已連結的工作與是個別應用程式的設定 |
workProfileWidgetsDefault |
指定工作資料夾小工具的預設行為。如果政策未指定特定應用程式的 |
exemptionsToShowWorkContactsInPersonalProfile |
從
支援 Android 14 以上版本。如果 Android 版本低於 14,系統會回報含有 |
ShowWorkContactsInPersonalProfile
個人應用程式是否可以存取工作資料夾聯絡人,包括聯絡人搜尋和來電
注意:任何個人應用程式存取工作聯絡人後,無法保證能夠繼續使用相同的應用程式,因為視允許的應用程式行為而定,聯絡人可能會共用或轉移到任何其他應用程式。
列舉 | |
---|---|
SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_UNSPECIFIED |
未指定。預設值為 設定此屬性時,不得設定 |
SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED |
你可以禁止個人應用程式存取工作資料夾中的聯絡人及查詢工作聯絡人。 設定這項設定後,系統會將「 支援 Android 7.0 以上版本。如果 Android 版本低於 7.0,系統會回報具有 |
SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_ALLOWED |
預設。允許應用程式存取工作資料夾中的聯絡人,包括聯絡人搜尋結果和來電。 設定這項設定後,「 支援 Android 7.0 以上版本。如果 Android 版本低於 7.0,系統會回報具有 |
SHOW_WORK_CONTACTS_IN_PERSONAL_PROFILE_DISALLOWED_EXCEPT_SYSTEM |
禁止大多數個人應用程式存取工作資料夾中的聯絡人,包括聯絡人搜尋及來電 (原始設備製造商 (OEM) 預設撥號、「訊息」和「聯絡人」應用程式除外)。無論是使用者設定的「撥號」、「訊息」和「聯絡人」應用程式,或任何其他系統或播放已安裝的應用程式,都無法直接查詢工作聯絡人。 這項設定後,系統會將「 支援 Android 14 以上版本。在搭載 Android 14 以下版本的裝置上設定這項設定後,行為會變回 |
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 |
系統預設會啟用工作資料夾小工具。也就是說,如果這項政策未針對應用程式將 指定為 ,應用程式就能在主畫面中新增小工具。 |
WORK_PROFILE_WIDGETS_DEFAULT_DISALLOWED |
系統預設為不允許使用工作資料夾小工具。也就是說,如果這項政策未針對應用程式將 指定為 ,使用者就無法在主畫面中新增小工具。 |
PreferentialNetworkService
控管是否在工作資料夾中啟用偏好的網路服務。如需詳細資訊,請參閱
。preferentialNetworkService
列舉 | |
---|---|
PREFERENTIAL_NETWORK_SERVICE_UNSPECIFIED |
未指定。預設值為 PREFERENTIAL_NETWORK_SERVICES_DISABLED 。 |
PREFERENTIAL_NETWORK_SERVICE_DISABLED |
工作資料夾中的偏好網路服務已停用。 |
PREFERENTIAL_NETWORK_SERVICE_ENABLED |
工作資料夾已啟用偏好網路服務。 |
UsageLog
控制從裝置收集並透過 Pub/Sub 通知回報的裝置活動記錄類型。
JSON 表示法 |
---|
{ "enabledLogTypes": [ enum ( |
欄位 | |
---|---|
enabledLogTypes[] |
指定要啟用的記錄類型。請注意,啟用使用記錄功能後,使用者會收到裝置端的訊息。 |
uploadOnCellularAllowed[] |
指定可透過行動數據上傳哪些已啟用的記錄類型。根據預設,當裝置連上 Wi-Fi 時,記錄就會排入上傳佇列。 |
LogType
裝置回報的裝置活動記錄類型。
列舉 | |
---|---|
LOG_TYPE_UNSPECIFIED |
並未使用這個值。 |
SECURITY_LOGS |
啟用裝置端安全性事件記錄功能,例如輸入錯誤的裝置密碼,或已掛接卸除式儲存裝置。如需已記錄安全性事件的完整說明,請參閱 。支援搭載 Android 7 以上版本的全代管裝置。支援在搭載 Android 12 以上版本且設有工作資料夾的公司裝置時,系統只會記錄工作資料夾的安全性事件。可由應用程式委派的範圍 覆寫 |
NETWORK_ACTIVITY_LOGS |
啟用裝置端網路事件記錄功能,例如 DNS 查詢和 TCP 連線。如需所記錄網路事件的完整說明,請參閱 。支援搭載 Android 8 以上版本的全代管裝置。支援設有工作資料夾的公司裝置,且裝置必須搭載 Android 12 以上版本,系統只會記錄工作資料夾中的網路事件。可由應用程式委派的範圍 覆寫 |
CameraAccess
控管攝影機的使用情況,以及使用者能否存取相機存取權切換鈕。相機存取權切換按鈕適用於 Android 12 以上版本。一般來說,停用攝影機的可能性會套用至全代管裝置,且只適用於設有工作資料夾的裝置。停用相機存取權切換按鈕的可能性只適用於全代管裝置,因此會套用至整部裝置。詳情請參閱列舉值。
列舉 | |
---|---|
CAMERA_ACCESS_UNSPECIFIED |
如果 為 true,則等同於 。否則就等於 。 |
CAMERA_ACCESS_USER_CHOICE |
系統會忽略 欄位。這是預設的裝置行為,現在支援裝置上的所有相機。在 Android 12 以上版本中,使用者可以使用相機存取權切換按鈕。 |
CAMERA_ACCESS_DISABLED |
系統會忽略 Android 12 以上版本的相機存取權切換鈕沒有明確限制。在全代管裝置上,相機存取權切換按鈕不會有任何作用,因為所有相機都停用。在設有工作資料夾的裝置上,這個切換鈕不會影響工作資料夾中的應用程式,但會影響工作資料夾以外的應用程式。 |
CAMERA_ACCESS_ENFORCED |
系統會忽略 欄位。裝置中所有相機都能使用,在搭載 Android 12 以上版本的全代管裝置上,使用者無法使用相機存取權切換按鈕。如果是未全代管或搭載 Android 11 以下版本的裝置,則等同於 。 |
MicrophoneAccess
在完全受管理的裝置上,控管麥克風使用情形,以及使用者能否存取麥克風存取權切換鈕。這項設定不會影響非全代管裝置。麥克風存取權切換按鈕適用於 Android 12 以上版本。
列舉 | |
---|---|
MICROPHONE_ACCESS_UNSPECIFIED |
如果 為 true,則等同於 。否則就等於 。 |
MICROPHONE_ACCESS_USER_CHOICE |
系統會忽略 欄位。這是預設裝置行為,可使用裝置的麥克風。在 Android 12 以上版本中,使用者可以使用麥克風存取權切換鈕。 |
MICROPHONE_ACCESS_DISABLED |
系統會忽略 麥克風已停用,因此麥克風存取權切換按鈕不會產生任何作用。 |
MICROPHONE_ACCESS_ENFORCED |
系統會忽略 欄位。裝置的麥克風可以使用。在搭載 Android 12 以上版本的裝置上,使用者無法使用麥克風存取權切換按鈕。在搭載 Android 11 以下版本的裝置上,這相當於 。 |
DeviceConnectivityManagement
包含裝置連線的控制項,例如 Wi-Fi、USB 數據連線、鍵盤/滑鼠連線等。
JSON 表示法 |
---|
{ "usbDataAccess": enum ( |
欄位 | |
---|---|
usbDataAccess |
控制哪些檔案和/或資料可透過 USB 傳輸。僅支援公司擁有的裝置。 |
configureWifi |
控管 Wi-Fi 設定權限,視相關選項而定,使用者可在設定 Wi-Fi 網路時擁有完整控制權或完全無法控管。 |
wifiDirectSettings |
控管設定及使用 Wi-Fi 直接設定。支援搭載 Android 13 以上版本的公司裝置。 |
tetheringSettings |
控管網路共用設定。視設定的值而定,使用者可能會部分或完全禁止使用不同形式的網路共用功能。 |
wifiSsidPolicy |
裝置可連線至 Wi-Fi SSID 的限制。請注意,這不會影響裝置上可設定的網路。支援搭載 Android 13 以上版本的公司裝置。 |
UsbDataAccess
控制哪些檔案和/或資料可透過 USB 傳輸。這不會影響充電功能。僅支援公司擁有的裝置。
列舉 | |
---|---|
USB_DATA_ACCESS_UNSPECIFIED |
未指定。預設值為 。 |
ALLOW_USB_DATA_TRANSFER |
允許所有類型的 USB 資料傳輸作業。已忽略 。 |
DISALLOW_USB_FILE_TRANSFER |
不允許透過 USB 傳輸檔案。但可以使用其他類型的 USB 數據連線,例如滑鼠和鍵盤連線。已忽略 。 |
DISALLOW_USB_DATA_TRANSFER |
設定這項政策後,系統將禁止所有類型的 USB 資料傳輸作業。支援搭載 Android 12 以上版本的裝置,而且 USB HAL 1.3 以上版本。如果系統不支援這項設定,則會設定 。如果 Android 版本低於 12,系統會回報含有 的 。如果裝置沒有 USB HAL 1.3 以上版本,系統會回報包含 的 。已忽略 。 |
ConfigureWifi
控管 Wi-Fi 設定權限,視使用者設定的選項而定,使用者在設定 Wi-Fi 網路時將擁有完整或部分控制權,或是完全無法控制。
列舉 | |
---|---|
CONFIGURE_WIFI_UNSPECIFIED |
未指定。預設為 ,除非 設為 true。如果將 設為 True,就等同於 。 |
ALLOW_CONFIGURING_WIFI |
允許使用者設定 Wi-Fi。已忽略 。 |
DISALLOW_ADD_WIFI_CONFIG |
不允許新增 Wi-Fi 設定。使用者只能切換已設定的網路。支援 Android 13 以上版本,支援全代管裝置和公司裝置的工作資料夾。如果系統不支援這項設定,則會設定 。如果 Android 版本低於 13,系統會回報含有 的 。已忽略 。 |
DISALLOW_CONFIGURING_WIFI |
不允許設定 Wi-Fi 網路。設有這個值時,系統會忽略 設定。支援全代管裝置和工作資料夾 (適用於公司擁有的裝置),且支援所有支援的 API 級別。如果是全代管裝置,這項設定會移除所有已設定的網路,並僅保留使用 政策設定的網路。針對公司擁有裝置上的工作資料夾,現有設定的網路不會受到影響,使用者也無法新增、移除或修改 Wi-Fi 網路。注意:如果無法在開機時連上網路,也無法設定 Wi-Fi 的 Wi-Fi 功能,系統會顯示網路跳轉網路,以便重新整理裝置政策 (請參閱 )。 |
WifiDirectSettings
控管 Wi-Fi Direct 設定。支援搭載 Android 13 以上版本的公司裝置。
列舉 | |
---|---|
WIFI_DIRECT_SETTINGS_UNSPECIFIED |
未指定。預設為
|
ALLOW_WIFI_DIRECT |
使用者可以使用 Wi-Fi Direct。 |
DISALLOW_WIFI_DIRECT |
使用者不得使用 Wi-Fi Direct。如果 Android 版本低於 13,系統會回報含有 的 。 |
TetheringSettings
控制使用者可使用不同形式的網路共用範圍,例如 Wi-Fi 網路共用、藍牙網路共用等。
列舉 | |
---|---|
TETHERING_SETTINGS_UNSPECIFIED |
未指定。預設為 ,除非 設為 true。如果將 設為 True,就等同於 。 |
ALLOW_ALL_TETHERING |
允許設定和使用任何形式的網路共用功能。已忽略 。 |
DISALLOW_WIFI_TETHERING |
不允許使用者使用 Wi-Fi 數據連線。支援公司擁有的裝置,且搭載 Android 13 以上版本。如果系統不支援這項設定,則會設定 。如果 Android 版本低於 13,系統會回報含有 的 。已忽略 。 |
DISALLOW_ALL_TETHERING |
不允許任何形式的網路共用。支援全代管裝置和工作資料夾 (適用於公司擁有的裝置),且支援所有支援的 Android 版本。系統會忽略 設定。 |
WifiSsidPolicy
裝置可連線至 Wi-Fi SSID 的限制。請注意,這不會影響裝置上可設定的網路。支援搭載 Android 13 以上版本的公司裝置。
JSON 表示法 |
---|
{ "wifiSsidPolicyType": enum ( |
欄位 | |
---|---|
wifiSsidPolicyType |
要套用的 Wi-Fi SSID 政策類型。 |
wifiSsids[] |
選用設定。要套用至政策的 Wi-Fi SSID 清單。如果 WifiSsidPolicyType 設為「 |
WifiSsidPolicyType
可套用到裝置的 Wi-Fi SSID 政策類型。
列舉 | |
---|---|
WIFI_SSID_POLICY_TYPE_UNSPECIFIED |
預設為 。無法設定「 」。裝置可連線的 SSID 沒有任何限制。 |
WIFI_SSID_DENYLIST |
裝置無法連上 SSID 位於 的任何 Wi-Fi 網路,但可以連上其他網路。 |
WIFI_SSID_ALLOWLIST |
裝置只能向「 」中的 SSID 進行 Wi-Fi 連線。 不得留空。裝置將無法連上任何其他 Wi-Fi 網路。 |
WifiSsid
代表 Wi-Fi SSID。
JSON 表示法 |
---|
{ "wifiSsid": string } |
欄位 | |
---|---|
wifiSsid |
必要欄位。Wi-Fi SSID 以字串表示。 |
DeviceRadioState
裝置無線電設定的控制選項。
JSON 表示法 |
---|
{ "wifiState": enum ( |
欄位 | |
---|---|
wifiState |
控制 Wi-Fi 的目前狀態,以及使用者是否可以變更 Wi-Fi 狀態。 |
airplaneModeState |
控制使用者能否切換飛航模式。 |
ultraWidebandState |
控制超寬頻設定的狀態,以及使用者能否切換為開啟或關閉。 |
cellularTwoGState |
控制使用者能否切換行動網路 2G 設定。 |
minimumWifiSecurityLevel |
裝置可連線的 Wi-Fi 網路最低安全等級。 |
WifiState
控制是否以狀態的形式開啟 Wi-Fi,以及使用者是否能夠變更 Wi-Fi 狀態。支援搭載 Android 13 以上版本的公司裝置。
列舉 | |
---|---|
WIFI_STATE_UNSPECIFIED |
未指定。預設為
|
WIFI_STATE_USER_CHOICE |
使用者可以啟用/停用 Wi-Fi。 |
WIFI_ENABLED |
Wi-Fi 已開啟,且使用者無法關閉。如果 Android 版本低於 13,系統會回報含有 的 。 |
WIFI_DISABLED |
Wi-Fi 已關閉,且使用者無法自行開啟。如果 Android 版本低於 13,系統會回報含有 的 。 |
AirplaneModeState
控制飛航模式的狀態,以及使用者是否可以將其切換為開啟或關閉。支援 Android 9 以上版本。支援全代管裝置和公司裝置上的工作資料夾。
列舉 | |
---|---|
AIRPLANE_MODE_STATE_UNSPECIFIED |
未指定。預設值為 。 |
AIRPLANE_MODE_USER_CHOICE |
使用者可以開啟或關閉飛航模式。 |
AIRPLANE_MODE_DISABLED |
飛航模式已停用。使用者不允許開啟飛航模式。如果 Android 版本低於 9,系統會回報含有 的 。 |
UltraWidebandState
控制超寬頻設定的狀態,以及使用者能否切換為開啟或關閉。支援 Android 14 以上版本。支援全代管裝置和公司裝置上的工作資料夾。
列舉 | |
---|---|
ULTRA_WIDEBAND_STATE_UNSPECIFIED |
未指定。預設值為 。 |
ULTRA_WIDEBAND_USER_CHOICE |
使用者可以開啟或關閉超寬頻功能。 |
ULTRA_WIDEBAND_DISABLED |
超寬頻已停用。使用者無法透過設定開啟超寬頻。如果 Android 版本低於 14,系統會回報含有 的 。 |
CellularTwoGState
控管行動網路 2G 設定的狀態,以及使用者能否開啟或關閉這項功能。支援 Android 14 以上版本。支援全代管裝置和公司裝置上的工作資料夾。
列舉 | |
---|---|
CELLULAR_TWO_G_STATE_UNSPECIFIED |
未指定。預設值為 。 |
CELLULAR_TWO_G_USER_CHOICE |
使用者可以開啟或關閉行動網路 2G。 |
CELLULAR_TWO_G_DISABLED |
行動數據 2G 已停用,使用者無法透過設定切換行動網路 2G。如果 Android 版本低於 14,系統會回報含有 的 。 |
MinimumWifiSecurityLevel
定義連線至 Wi-Fi 網路所需的不同 Wi-Fi 最低安全等級。支援 Android 13 以上版本。支援全代管裝置和公司裝置上的工作資料夾。
列舉 | |
---|---|
MINIMUM_WIFI_SECURITY_LEVEL_UNSPECIFIED |
預設值為 ,表示裝置可連上所有類型的 Wi-Fi 網路。 |
OPEN_NETWORK_SECURITY |
裝置可連線至所有類型的 Wi-Fi 網路。 |
PERSONAL_NETWORK_SECURITY |
WEP、WPA2-PSK 等個人網路是最低安全性的要求。裝置將無法連上開放的 Wi-Fi 網路。這比 嚴格。如果 Android 版本低於 13,系統會回報含有 的 。 |
ENTERPRISE_NETWORK_SECURITY |
企業 EAP 網路是最低所需的安全性等級,裝置將無法連線至這個安全性等級以下的 Wi-Fi 網路。這比 嚴格。如果 Android 版本低於 13,系統會回報含有 的 。 |
ENTERPRISE_BIT192_NETWORK_SECURITY |
192 位元企業網路是最低所需的安全性等級,裝置將無法連線至這個安全性等級以下的 Wi-Fi 網路。這比 嚴格。如果 Android 版本低於 13,系統會回報含有 的 。 |
CredentialProviderPolicyDefault
控管哪些應用程式可在 Android 14 以上版本中做為憑證提供者使用。這些應用程式會儲存憑證,詳情請參閱這個網頁和這個網頁。另請參閱
。credentialProviderPolicy
列舉 | |
---|---|
CREDENTIAL_PROVIDER_POLICY_DEFAULT_UNSPECIFIED |
未指定。預設為 CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED。 |
CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED |
未指定 的應用程式無法做為憑證提供者。 |
CREDENTIAL_PROVIDER_DEFAULT_DISALLOWED_EXCEPT_SYSTEM |
未指定 的應用程式不得做為憑證提供者,除非原始設備製造商 (OEM) 的預設憑證提供者。原始設備製造商 (OEM) 的預設憑證提供者一律允許做為憑證提供者。 |
PrintingPolicy
控管是否允許列印。這項功能適用於搭載 Android 9 以上版本的裝置。
列舉 | |
---|---|
PRINTING_POLICY_UNSPECIFIED |
未指定。預設值為 。 |
PRINTING_DISALLOWED |
不允許列印。如果 Android 版本低於 9,系統會回報含有 的 。 |
PRINTING_ALLOWED |
允許列印。 |
DisplaySettings
顯示設定的控制項。
JSON 表示法 |
---|
{ "screenBrightnessSettings": { object ( |
欄位 | |
---|---|
screenBrightnessSettings |
選用設定。控制螢幕亮度設定。 |
screenTimeoutSettings |
選用設定。控管螢幕自動關閉時間設定。 |
ScreenBrightnessSettings
螢幕亮度設定控制項。
JSON 表示法 |
---|
{
"screenBrightnessMode": enum ( |
欄位 | |
---|---|
screenBrightnessMode |
選用設定。控制螢幕亮度模式。 |
screenBrightness |
選用設定。螢幕亮度介於 1 到 255 之間,其中 1 是最低亮度,255 是最高亮度。如果值為 0 (預設值),表示未設定螢幕亮度。所有其他值都會遭拒。 |
ScreenBrightnessMode
控制螢幕亮度模式。
列舉 | |
---|---|
SCREEN_BRIGHTNESS_MODE_UNSPECIFIED |
未指定。預設值為 。 |
BRIGHTNESS_USER_CHOICE |
使用者可設定螢幕亮度。無法設定「 」。 |
BRIGHTNESS_AUTOMATIC |
螢幕亮度模式會自動調整,此模式會自動調整亮度,且使用者無法設定螢幕亮度。你仍可設定「 」。這項功能會在自動調整亮度時納入考量。支援 Android 9 以上版本的全代管裝置。如果 Android 版本低於 9,系統會回報含有 的 。 |
BRIGHTNESS_FIXED |
螢幕亮度模式固定設為 ,且使用者無法設定螢幕亮度。必須設定「 」。支援 Android 9 以上版本的全代管裝置。如果 Android 版本低於 9,系統會回報含有 的 。 |
ScreenTimeoutSettings
控管螢幕自動關閉時間設定。
JSON 表示法 |
---|
{
"screenTimeoutMode": enum ( |
欄位 | |
---|---|
screenTimeoutMode |
選用設定。控管是否允許使用者設定螢幕自動關閉功能。 |
screenTimeout |
選用設定。控管螢幕自動關閉時間。螢幕自動關閉時間必須大於 0,否則會遭到拒絕。此外,該值不應大於 持續時間以秒為單位,最多 9 個小數位數,結尾為「 |
ScreenTimeoutMode
控管是否允許使用者設定螢幕自動關閉功能。
列舉 | |
---|---|
SCREEN_TIMEOUT_MODE_UNSPECIFIED |
未指定。預設值為 。 |
SCREEN_TIMEOUT_USER_CHOICE |
使用者可設定螢幕自動關閉功能。無法設定「 」。 |
SCREEN_TIMEOUT_ENFORCED |
螢幕自動關閉時間設為 ,且使用者無法設定逾時。必須設定「 」。支援 Android 9 以上版本的全代管裝置。如果 Android 版本低於 9,系統會回報含有 的 。 |
方法 |
|
---|---|
|
刪除政策。 |
|
取得政策。 |
|
列出指定企業的政策。 |
|
更新或建立政策。 |