- 資源:裝置
- DeviceState
- NonComplianceDetail
- InstallationFailureReason
- SpecificNonComplianceReason
- SpecificNonComplianceContext
- OncWifiContext
- PasswordPoliciesContext
- SoftwareInfo
- SystemUpdateInfo
- UpdateStatus
- HardwareInfo
- 多媒體廣告聯播網
- DisplayState
- ApplicationReport
- ApplicationEvent
- ApplicationEventType
- ApplicationSource
- ApplicationState
- KeyedAppState
- 嚴重性
- UserFacingType
- NetworkInfo
- TelephonyInfo
- MemoryInfo
- MemoryEvent
- MemoryEventType
- PowerManagementEvent
- PowerManagementEventType
- HardwareStatus
- DeviceSettings
- EncryptionStatus
- SecurityPosture
- DevicePosture
- PostureDetail
- SecurityRisk
- CommonCriteriaModeInfo
- CommonCriteriaModeStatus
- DpcMigrationInfo
- 方法
資源:裝置
公司擁有的裝置。除非另有註明,否則所有欄位皆為唯讀,且無法由 enterprises.devices.patch
修改。
JSON 表示法 |
---|
{ "name": string, "userName": string, "managementMode": enum ( |
欄位 | |
---|---|
name |
格式為 |
userName |
擁有這部裝置的使用者資源名稱,格式為 |
managementMode |
裝置採用的管理模式 Android Device Policy 類型。這會影響系統支援的政策設定。 |
state |
要套用至裝置的狀態。這個欄位可透過修補要求修改。請注意,呼叫 |
appliedState |
裝置目前套用的狀態。 |
policyCompliant |
裝置是否符合政策規定。 |
nonComplianceDetails[] |
裝置違反的政策設定詳細資料。 |
enrollmentTime |
裝置註冊的時間。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
lastStatusReportTime |
裝置上次傳送狀態報告的時間。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
lastPolicyComplianceReportTime |
已淘汰。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
lastPolicySyncTime |
裝置上次擷取政策的時間。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
policyName |
套用至裝置的政策名稱,格式為 |
appliedPolicyName |
目前套用至裝置的政策名稱。 |
appliedPolicyVersion |
裝置目前套用的政策版本。 |
apiLevel |
裝置上執行的 Android 平台版本 API 級別。 |
enrollmentTokenData |
如果裝置已註冊註冊權杖並提供額外資料,這個欄位會包含這些資料。 |
enrollmentTokenName |
如果裝置已使用註冊權杖註冊,這個欄位會包含權杖名稱。 |
disabledReason |
如果裝置狀態為 |
softwareInfo |
裝置軟體的詳細資訊。只有在裝置的政策為 |
hardwareInfo |
裝置硬體的詳細資訊。 |
displays[] |
裝置顯示畫面的詳細資訊。只有在裝置的政策為 |
applicationReports[] |
裝置上已安裝應用程式的報告。只有在 |
previousDeviceNames[] |
如果相同的實體裝置註冊多次,這個欄位會包含先前的裝置名稱。序號做為專屬 ID,用於判斷同一實體裝置先前是否已註冊。名稱會按照時間順序排列, |
networkInfo |
裝置網路資訊。只有在裝置的政策為 |
memoryInfo |
記憶體資訊:包含裝置記憶體和儲存空間的相關資訊。 |
memoryEvents[] |
與記憶體和儲存空間測量相關的事件,依時間順序排序。只有在裝置的政策為 事件會保留一段時間,舊活動也會遭到刪除。 |
powerManagementEvents[] |
裝置上的電源管理事件 (依時間順序排列)。只有在裝置的政策為 |
hardwareStatusSamples[] |
硬體狀態範例 (依時間順序排列)。只有在裝置的政策為 |
deviceSettings |
裝置設定資訊。只有在裝置的政策為 |
user |
擁有該裝置的使用者。 |
systemProperties |
對應於裝置相關的系統屬性名稱和值。只有在裝置的政策為 這個物件中包含 |
securityPosture |
裝置的安全防護機制值,反映裝置的安全性。 |
ownership |
受管理裝置的擁有權。 |
commonCriteriaModeInfo |
共同準則模式相關資訊 - 請參閱資訊技術安全性評估共同準則 (CC) 中定義的安全性標準。 只有在 |
appliedPasswordPolicies[] |
裝置目前套用的密碼規定。
|
dpcMigrationInfo |
僅供輸出。與這部裝置是否從其他裝置政策控制器 (DPC) 遷移的相關資訊有關的資訊。 |
DeviceState
裝置上適用的狀態。
列舉 | |
---|---|
DEVICE_STATE_UNSPECIFIED |
不允許此值。 |
ACTIVE |
裝置處於啟用狀態。 |
DISABLED |
裝置已停用。 |
DELETED |
裝置已刪除。此狀態一律不會由 API 呼叫傳回,但裝置確認刪除時,最終狀態報告會使用此狀態。如果透過 API 呼叫刪除裝置,此狀態會發布至 Pub/Sub。即便使用者刪除工作資料夾或重設裝置,伺服器仍可查看裝置狀態。 |
PROVISIONING |
系統正在佈建裝置。新註冊的裝置在套用政策前會處於此狀態。 |
LOST |
裝置遺失。這個狀態只能在機構擁有的裝置上運作。 |
PREPARING_FOR_MIGRATION |
裝置正在準備遷移至 Android Management API。如要繼續遷移,您不需要採取進一步行動。 |
NonComplianceDetail
詳細說明未遵循政策設定的情況。
JSON 表示法 |
---|
{ "settingName": string, "nonComplianceReason": enum ( |
欄位 | |
---|---|
settingName |
政策設定的名稱。這是頂層 |
nonComplianceReason |
裝置不符合設定的原因。 |
packageName |
用來指出哪個應用程式違反規定的套件名稱。 |
fieldPath |
對於內含巢狀欄位的設定,如果特定巢狀欄位不符合規定,此欄位會指定違規欄位的完整路徑。路徑的格式與在 JavaScript 中參照的政策 JSON 欄位格式相同,即:1) 如果是物件類型的欄位,欄位名稱後方會加上一個點,再接一個子欄位名稱。2) 針對陣列類型欄位,欄位名稱後面緊接在方括號內的陣列索引。舉例來說,如要指出第 3 個應用程式的 |
currentValue |
如果無法套用這項政策設定,代表裝置目前設定的值。 |
installationFailureReason |
如果已設定 |
specificNonComplianceReason |
裝置與設定不符的具體原因。 |
specificNonComplianceContext |
|
InstallationFailureReason
應用程式安裝失敗的原因。
列舉 | |
---|---|
INSTALLATION_FAILURE_REASON_UNSPECIFIED |
不允許此值。 |
INSTALLATION_FAILURE_REASON_UNKNOWN |
不明條件導致使用者無法安裝應用程式。一些可能的原因包括裝置儲存空間不足、裝置網路連線不穩定,或是安裝時間超出預期。系統將自動重新安裝。 |
IN_PROGRESS |
安裝作業仍在進行中, |
NOT_FOUND |
在 Google Play 中找不到這個應用程式。 |
NOT_COMPATIBLE_WITH_DEVICE |
這個應用程式與裝置不相容。 |
NOT_APPROVED |
管理員尚未核准應用程式。 |
PERMISSIONS_NOT_ACCEPTED |
應用程式擁有管理員尚未接受的新權限。 |
NOT_AVAILABLE_IN_COUNTRY |
該應用程式並未在使用者所在的國家/地區上架。 |
NO_LICENSES_REMAINING |
沒有可指派給該使用者的授權。 |
NOT_ENROLLED |
企業已停止註冊 Google Play 管理版,或是管理員尚未接受最新的《Google Play 管理版服務條款》。 |
USER_INVALID |
使用者已失效。該使用者可能已遭刪除或停用。 |
NETWORK_ERROR_UNRELIABLE_CONNECTION |
使用者的裝置發生網路錯誤,導致安裝失敗。這通常是因為裝置的網際網路連線中斷、無法使用或網路設定問題。請確認裝置可在符合「 |
INSUFFICIENT_STORAGE |
使用者裝置的儲存空間不足,無法安裝應用程式。如要解決這個問題,請釋出裝置的儲存空間。裝置的儲存空間足夠後,系統會自動繼續安裝或更新應用程式。 |
SpecificNonComplianceReason
以下詳細說明裝置為何違反政策設定。您日後可以將新值加入列舉中。
列舉 | |
---|---|
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED |
未指定特定的違規原因。未設定 中的欄位。 |
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED |
使用者必須輸入螢幕鎖定才能確認憑證。未設定 中的欄位。 已設為 。 |
PASSWORD_POLICIES_PASSWORD_EXPIRED |
裝置或設定檔密碼已過期。已設定「 」。 已設為 。 |
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT |
裝置密碼不符合密碼規定。已設定「 」。 已設為 。 |
ONC_WIFI_INVALID_VALUE |
ONC Wi-Fi 設定中的值不正確。 指定哪個欄位值不正確。已設定「 」。 已設為 。 |
ONC_WIFI_API_LEVEL |
裝置搭載的 Android 版本 API 級別不支援 ONC Wi-Fi 設定。 指定不支援的欄位值。已設定「 」。 已設為 。 |
ONC_WIFI_INVALID_ENTERPRISE_CONFIG |
企業 Wi-Fi 網路缺少根 CA 或網域名稱。 設為 。 |
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK |
使用者必須手動移除已設定的 Wi-Fi 網路。這項設定僅適用於個人擁有裝置的工作資料夾。 設為 。 |
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY |
在 中透過 ClientCertKeyPairAlias 欄位指定的金鑰組別名,與裝置上安裝的現有金鑰未對應。 已設為 。 |
SpecificNonComplianceContext
的其他背景資訊。SpecificNonComplianceReason
JSON 表示法 |
---|
{ "oncWifiContext": { object ( |
欄位 | |
---|---|
oncWifiContext |
與 Wi-Fi 設定相關的違規詳情。查看《 |
passwordPoliciesContext |
其他與密碼政策相關的違規背景資訊。請參閱《 |
OncWifiContext
與 Wi-Fi 設定相關的違規詳情。
JSON 表示法 |
---|
{ "wifiGuid": string } |
欄位 | |
---|---|
wifiGuid |
不符規定的 Wi-Fi 設定的 GUID。 |
PasswordPoliciesContext
其他與密碼政策相關的違規背景資訊。
JSON 表示法 |
---|
{
"passwordPolicyScope": enum ( |
欄位 | |
---|---|
passwordPolicyScope |
不符規定的密碼範圍。 |
SoftwareInfo
裝置軟體相關資訊。
JSON 表示法 |
---|
{
"androidVersion": string,
"androidDevicePolicyVersionCode": integer,
"androidDevicePolicyVersionName": string,
"androidBuildNumber": string,
"deviceKernelVersion": string,
"bootloaderVersion": string,
"androidBuildTime": string,
"securityPatchLevel": string,
"primaryLanguageCode": string,
"deviceBuildSignature": string,
"systemUpdateInfo": {
object ( |
欄位 | |
---|---|
androidVersion |
使用者看到的 Android 版本字串。例如 |
androidDevicePolicyVersionCode |
Android Device Policy 應用程式版本代碼。 |
androidDevicePolicyVersionName |
向使用者顯示的 Android Device Policy 應用程式版本。 |
androidBuildNumber |
要向使用者顯示的 Android 建構 ID 字串。例如 |
deviceKernelVersion |
核心版本,例如 |
bootloaderVersion |
系統系統啟動載入程式版本號碼,例如 |
androidBuildTime |
建構時間。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
securityPatchLevel |
安全性修補程式等級,例如 |
primaryLanguageCode |
裝置上主要語言代碼的 IETF BCP 47 語言代碼。 |
deviceBuildSignature |
與系統套件相關聯的 |
systemUpdateInfo |
可能的系統更新相關資訊。 |
SystemUpdateInfo
可能的系統更新相關資訊。
JSON 表示法 |
---|
{
"updateStatus": enum ( |
欄位 | |
---|---|
updateStatus |
更新狀態:是否有更新,以及是否有更新。 |
updateReceivedTime |
首次發布更新的時間。如果值為零,代表未設定這個欄位。只有在有可用的更新時 (也就是 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
UpdateStatus
更新狀態:是否有更新,以及是否有更新。
列舉 | |
---|---|
UPDATE_STATUS_UNKNOWN |
不明,不確定是否有待處理的系統更新。舉例來說,如果裝置 API 級別低於 26,或是 Android Device Policy 版本過舊,就會發生這種情況。 |
UP_TO_DATE |
裝置上沒有待處理的系統更新。 |
UNKNOWN_UPDATE_AVAILABLE |
有可用的系統更新,但類型不明。 |
SECURITY_UPDATE_AVAILABLE |
目前有可用的安全性更新。 |
OS_UPDATE_AVAILABLE |
有可用的 OS 更新。 |
HardwareInfo
裝置硬體相關資訊。只有在裝置政策為「hardwareStatusEnabled
」設為 true 時,系統才會提供與溫度門檻相關的欄位。
JSON 表示法 |
---|
{ "brand": string, "hardware": string, "deviceBasebandVersion": string, "manufacturer": string, "serialNumber": string, "model": string, "batteryShutdownTemperatures": [ number ], "batteryThrottlingTemperatures": [ number ], "cpuShutdownTemperatures": [ number ], "cpuThrottlingTemperatures": [ number ], "gpuShutdownTemperatures": [ number ], "gpuThrottlingTemperatures": [ number ], "skinShutdownTemperatures": [ number ], "skinThrottlingTemperatures": [ number ], "enterpriseSpecificId": string } |
欄位 | |
---|---|
brand |
裝置品牌。例如 |
hardware |
硬體名稱。例如 |
deviceBasebandVersion |
基頻版本。例如 |
manufacturer |
製造商。例如 |
serialNumber |
裝置序號。 |
model |
裝置的型號。例如 |
batteryShutdownTemperatures[] |
裝置上每個電池的攝氏溫度門檻。 |
batteryThrottlingTemperatures[] |
裝置每個電池在攝氏溫度下的節流溫度門檻。 |
cpuShutdownTemperatures[] |
裝置上每個 CPU 的 CPU 關閉溫度門檻 (攝氏)。 |
cpuThrottlingTemperatures[] |
裝置上每個 CPU 的 CPU 節流溫度門檻 (以攝氏為單位)。 |
gpuShutdownTemperatures[] |
裝置上每個 GPU 的 GPU 關閉溫度門檻 (攝氏)。 |
gpuThrottlingTemperatures[] |
裝置上每個 GPU 的 GPU 節流溫度門檻 (以攝氏為單位)。 |
skinShutdownTemperatures[] |
裝置皮膚關閉溫度門檻 (攝氏)。 |
skinThrottlingTemperatures[] |
裝置皮膚節流溫度 (攝氏)。 |
enterpriseSpecificId |
僅供輸出。可明確識別特定機構中個人擁有裝置的 ID。在註冊於同一機構的實體裝置上,這個 ID 會在設定期間維持不變,甚至恢復原廠設定。這個 ID 適用於搭載工作資料夾的個人裝置,而且裝置必須搭載 Android 12 以上版本。 |
螢幕
裝置顯示資訊。
JSON 表示法 |
---|
{
"name": string,
"displayId": integer,
"refreshRate": integer,
"state": enum ( |
欄位 | |
---|---|
name |
顯示名稱。 |
displayId |
專屬螢幕 ID。 |
refreshRate |
螢幕的刷新率,以每秒影格數為單位。 |
state |
顯示狀態。 |
width |
螢幕寬度 (以像素為單位)。 |
height |
顯示高度 (以像素為單位)。 |
density |
顯示密度,以點每英寸像素數表示。 |
DisplayState
螢幕的狀態,
列舉 | |
---|---|
DISPLAY_STATE_UNSPECIFIED |
不允許此值。 |
OFF |
螢幕已關閉。 |
ON |
螢幕已開啟。 |
DOZE |
螢幕處於低耗電狀態 |
SUSPENDED |
螢幕處於暫停的低耗電狀態。 |
ApplicationReport
回報已安裝應用程式的相關資訊。
JSON 表示法 |
---|
{ "packageName": string, "versionName": string, "versionCode": integer, "events": [ { object ( |
欄位 | |
---|---|
packageName |
應用程式的套件名稱。 |
versionName |
向使用者顯示的應用程式版本。 |
versionCode |
應用程式版本代碼,可用於判斷某個版本是否比另一個版本。 |
events[] |
過去 30 小時內發生的應用程式事件清單。 |
displayName |
應用程式的顯示名稱。 |
packageSha256Hash |
應用程式 APK 檔案的 SHA-256 雜湊,可用於驗證應用程式是否遭到修改。雜湊值的每一個位元組都會以兩位數的十六進位數字表示。 |
signingKeyCertFingerprints[] |
與應用程式套件相關聯的每個 |
installerPackageName |
安裝這個應用程式的應用程式套件名稱。 |
applicationSource |
套件的來源。 |
state |
應用程式狀態。 |
keyedAppStates[] |
應用程式回報的金鑰應用程式狀態清單。 |
userFacingType |
應用程式是否向使用者顯示。 |
ApplicationEvent
應用程式相關事件。
JSON 表示法 |
---|
{
"eventType": enum ( |
欄位 | |
---|---|
eventType |
應用程式事件類型。 |
createTime |
活動的建立時間。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
ApplicationEventType
應用程式相關事件的類型。
列舉 | |
---|---|
APPLICATION_EVENT_TYPE_UNSPECIFIED |
不允許此值。 |
INSTALLED |
已安裝應用程式。 |
CHANGED |
應用程式有所變更,例如啟用或停用元件。 |
DATA_CLEARED |
已清除應用程式資料。 |
REMOVED |
應用程式已遭移除。 |
REPLACED |
已安裝新版應用程式,取代舊版本。 |
RESTARTED |
應用程式已重新啟動。 |
PINNED |
應用程式已固定在前景。 |
UNPINNED |
已取消固定應用程式。 |
ApplicationSource
提供應用程式的來源。
列舉 | |
---|---|
APPLICATION_SOURCE_UNSPECIFIED |
應用程式是從未指定的來源側載。 |
SYSTEM_APP_FACTORY_VERSION |
這是裝置原廠映像檔中的系統應用程式。 |
SYSTEM_APP_UPDATED_VERSION |
這是新版系統應用程式。 |
INSTALLED_FROM_PLAY_STORE |
應用程式是從 Google Play 商店安裝。 |
ApplicationState
目前的安裝狀態。
列舉 | |
---|---|
APPLICATION_STATE_UNSPECIFIED |
未指定應用程式狀態 |
REMOVED |
應用程式已從裝置中移除 |
INSTALLED |
應用程式已安裝在裝置上 |
KeyedAppState
應用程式回報的金鑰應用程式狀態。
JSON 表示法 |
---|
{
"key": string,
"severity": enum ( |
欄位 | |
---|---|
key |
應用程式狀態的鍵。可做為應用程式提供狀態的參考依據。舉例來說,提供受管理的設定意見回饋時,這組金鑰可能是受管理的設定金鑰。 |
severity |
應用程式狀態的嚴重性。 |
message |
選填,用來說明應用程式狀態的任意格式訊息字串。如果狀態是由特定值 (例如受管理的設定值) 所觸發,訊息中也應包含這項資訊。 |
data |
視需要指定可供 EMM 讀取的值。例如,設定管理員可在 EMM 控制台中查詢的值 (例如「如果 Battery_warning 資料小於 10」時請通知我)。 |
createTime |
裝置上應用程式狀態的建立時間。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
lastUpdateTime |
應用程式狀態最近一次更新的時間。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
嚴重程度
應用程式狀態的嚴重性。
列舉 | |
---|---|
SEVERITY_UNSPECIFIED |
未指定的嚴重性等級。 |
INFO |
資訊嚴重性等級。 |
ERROR |
錯誤嚴重性等級。建議您只在管理機構需要採取行動的真實錯誤情況下,才設定這個屬性。 |
UserFacingType
應用程式是否向使用者顯示。
列舉 | |
---|---|
USER_FACING_TYPE_UNSPECIFIED |
未指定應用程式使用者端類型。 |
NOT_USER_FACING |
應用程式未面向使用者。 |
USER_FACING |
應用程式面向使用者。 |
NetworkInfo
裝置網路資訊。
JSON 表示法 |
---|
{
"imei": string,
"meid": string,
"wifiMacAddress": string,
"networkOperatorName": string,
"telephonyInfos": [
{
object ( |
欄位 | |
---|---|
imei |
GSM 裝置的 IMEI 號碼。例如 |
meid |
CDMA 裝置的 MEID 號碼。例如 |
wifiMacAddress |
裝置的 Wi-Fi MAC 位址。例如 |
networkOperatorName |
目前註冊業者的字母名稱。例如 Vodafone。 |
telephonyInfos[] |
提供與裝置上每張 SIM 卡相關聯的電話資訊。僅支援 Android API 級別 23 以後的全代管裝置。 |
TelephonyInfo
與裝置上指定 SIM 卡相關聯的電話通訊資訊。僅支援 Android API 級別 23 以後的全代管裝置。
JSON 表示法 |
---|
{ "phoneNumber": string, "carrierName": string } |
欄位 | |
---|---|
phoneNumber |
與這張 SIM 卡相關聯的電話號碼。 |
carrierName |
與這張 SIM 卡相關聯的電信業者名稱。 |
MemoryInfo
裝置記憶體和儲存空間的相關資訊。
JSON 表示法 |
---|
{ "totalRam": string, "totalInternalStorage": string } |
欄位 | |
---|---|
totalRam |
裝置上的 RAM 總量 (以位元組為單位)。 |
totalInternalStorage |
裝置上的內部儲存空間總量 (以位元組為單位)。 |
MemoryEvent
與記憶體和儲存空間測量相關的事件。
為了區分新舊事件,建議使用
欄位。createTime
JSON 表示法 |
---|
{
"eventType": enum ( |
欄位 | |
---|---|
eventType |
這是指活動類型。 |
createTime |
活動的建立時間。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
byteCount |
中型或 |
MemoryEventType
事件的類型。
列舉 | |
---|---|
MEMORY_EVENT_TYPE_UNSPECIFIED |
未指定。沒有任何事件具有這個類型。 |
RAM_MEASURED |
已測量 RAM 的可用空間。 |
INTERNAL_STORAGE_MEASURED |
評估的是內部儲存空間的可用空間。 |
EXTERNAL_STORAGE_DETECTED |
偵測到新的外部儲存空間媒介。回報的位元組數為儲存空間中型的總容量。 |
EXTERNAL_STORAGE_REMOVED |
已移除外部儲存空間媒介。回報的位元組數為零。 |
EXTERNAL_STORAGE_MEASURED |
已測量外部儲存空間媒介中的可用空間。 |
PowerManagementEvent
電源管理事件。
JSON 表示法 |
---|
{
"eventType": enum ( |
欄位 | |
---|---|
eventType |
這是指活動類型。 |
createTime |
活動的建立時間。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
batteryLevel |
如果是 |
PowerManagementEventType
事件的類型。
列舉 | |
---|---|
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED |
未指定。沒有任何事件具有這個類型。 |
BATTERY_LEVEL_COLLECTED |
已測量電池電量。 |
POWER_CONNECTED |
裝置已開始充電。 |
POWER_DISCONNECTED |
裝置已停止充電。 |
BATTERY_LOW |
裝置已進入低耗電模式。 |
BATTERY_OKAY |
裝置已退出低耗電模式。 |
BOOT_COMPLETED |
裝置已啟動。 |
SHUTDOWN |
裝置已關閉。 |
HardwareStatus
硬體狀態。我們可能會將溫度與 hardwareInfo
提供的溫度門檻做比較,判斷硬體健康。
JSON 表示法 |
---|
{ "createTime": string, "batteryTemperatures": [ number ], "cpuTemperatures": [ number ], "gpuTemperatures": [ number ], "skinTemperatures": [ number ], "fanSpeeds": [ number ], "cpuUsages": [ number ] } |
欄位 | |
---|---|
createTime |
測量結果的時間。 採用 RFC3339 世界標準時間「Zulu」格式的時間戳記,採用奈秒解析度和最多九個小數位數。範例: |
batteryTemperatures[] |
裝置電池目前的電池溫度 (以攝氏為單位)。 |
cpuTemperatures[] |
裝置上每個 CPU 目前的 CPU 溫度 (以攝氏為單位)。 |
gpuTemperatures[] |
裝置上每個 GPU 的當前 GPU 溫度 (以攝氏為單位)。 |
skinTemperatures[] |
目前裝置皮膚溫度 (攝氏)。 |
fanSpeeds[] |
裝置上每個風扇的風扇速度 (RPM)。空白陣列表示系統不支援風扇或風扇速度。 |
cpuUsages[] |
裝置上每個可用核心的 CPU 用量百分比。每個未插上核心的用量為 0。空白陣列表示系統不支援 CPU 用量。 |
DeviceSettings
裝置與安全性相關的裝置設定資訊。
JSON 表示法 |
---|
{
"isDeviceSecure": boolean,
"unknownSourcesEnabled": boolean,
"developmentSettingsEnabled": boolean,
"adbEnabled": boolean,
"isEncrypted": boolean,
"encryptionStatus": enum ( |
欄位 | |
---|---|
isDeviceSecure |
裝置是否使用 PIN 碼/密碼確保安全。 |
unknownSourcesEnabled |
是否已啟用從不明來源安裝應用程式的功能。 |
developmentSettingsEnabled |
裝置是否已啟用開發人員模式。 |
adbEnabled |
指出裝置是否已啟用 ADB。 |
isEncrypted |
是否啟用儲存空間加密。 |
encryptionStatus |
DevicePolicyManager 的加密狀態。 |
verifyAppsEnabled |
是否要在裝置上強制執行 Google Play 安全防護驗證。 |
EncryptionStatus
裝置的加密狀態。
列舉 | |
---|---|
ENCRYPTION_STATUS_UNSPECIFIED |
未指定。所有裝置不應使用這類類型。 |
UNSUPPORTED |
裝置不支援加密。 |
INACTIVE |
裝置支援加密功能,但目前未啟用。 |
ACTIVATING |
目前未啟用加密功能,但目前已啟用。 |
ACTIVE |
已啟用加密功能。 |
ACTIVE_DEFAULT_KEY |
加密功能已啟用,但使用者未設定加密金鑰。 |
ACTIVE_PER_USER |
加密功能已啟用,且加密金鑰已連結至使用者個人資料。 |
SecurityPosture
裝置的安全防護機制 (取決於目前裝置狀態和套用的政策)。
JSON 表示法 |
---|
{ "devicePosture": enum ( |
欄位 | |
---|---|
devicePosture |
裝置的安全防護機制值。 |
postureDetails[] |
裝置安全防護機制的其他詳細資料。 |
DevicePosture
管理的裝置可能的安全防護機制值。
列舉 | |
---|---|
POSTURE_UNSPECIFIED |
未指定。這個型態值沒有型態詳細資料。 |
SECURE |
這是安全的裝置。 |
AT_RISK |
與公司資料搭配使用時,這部裝置可能較容易遭受惡意人士攻擊。 |
POTENTIALLY_COMPROMISED |
這部裝置可能會遭駭,且未經授權的行為人或許可以存取公司資料。 |
PostureDetail
裝置安全防護機制的其他詳細資料。
JSON 表示法 |
---|
{ "securityRisk": enum ( |
欄位 | |
---|---|
securityRisk |
對裝置安全防護機製造成負面影響的特定安全性風險。 |
advice[] |
對應的管理員建議,有助於降低這項安全性風險並改善裝置安全防護機制。 |
SecurityRisk
導致裝置未處於最佳安全狀態的風險。
列舉 | |
---|---|
SECURITY_RISK_UNSPECIFIED |
未指明 |
UNKNOWN_OS |
Play Integrity API 偵測到裝置正在執行未知的 OS (基本完整性檢查成功,但 ctsProfileMatch 失敗)。 |
COMPROMISED_OS |
Play Integrity API 偵測到裝置正在執行遭入侵的 OS (基本完整性檢查失敗)。 |
HARDWARE_BACKED_EVALUATION_FAILED |
如果裝置完整性欄位未顯示 MEETS_STRONG_INTEGRITY 標籤,Play Integrity API 會偵測裝置並未充分保證系統完整性。 |
CommonCriteriaModeInfo
共同準則模式相關資訊 - 請參閱資訊技術安全性評估共同準則 (CC) 中定義的安全性標準。
只有在裝置政策中的「statusReportingSettings.commonCriteriaModeEnabled
」是「true
」時,系統才會提供這項資訊。
JSON 表示法 |
---|
{
"commonCriteriaModeStatus": enum ( |
欄位 | |
---|---|
commonCriteriaModeStatus |
是否啟用共通條件模式。 |
CommonCriteriaModeStatus
是否啟用共通條件模式。
列舉 | |
---|---|
COMMON_CRITERIA_MODE_STATUS_UNKNOWN |
狀態不明。 |
COMMON_CRITERIA_MODE_DISABLED |
共同準則模式目前已停用。 |
COMMON_CRITERIA_MODE_ENABLED |
共同準則模式目前已啟用。 |
DpcMigrationInfo
與這部裝置是否從其他裝置政策控制器 (DPC) 遷移的相關資訊有關的資訊。
JSON 表示法 |
---|
{ "previousDpc": string, "additionalData": string } |
欄位 | |
---|---|
previousDpc |
僅供輸出。如果這部裝置是從其他 DPC 遷移而來,這會是裝置的套件名稱。否則不會填入。 |
additionalData |
僅供輸出。如果這部裝置是從其他 DPC 遷移而來,系統會在這裡填入遷移權杖的 |
方法 |
|
---|---|
|
刪除裝置。 |
|
取得裝置。 |
|
向裝置發出指令。 |
|
列出特定企業的裝置。 |
|
更新裝置。 |