- 資源:裝置
- 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
- PolicySignatureVerificationStatus
- DpcMigrationInfo
- 方法
資源:裝置
企業擁有的裝置。除非另有說明,否則所有欄位皆為唯讀,無法由 enterprises.devices.patch
修改。
JSON 表示法 |
---|
{ "name": string, "userName": string, "managementMode": enum ( |
欄位 | |
---|---|
name |
裝置名稱,格式為 |
user |
擁有此裝置的使用者資源名稱,格式為 |
management |
Android Device Policy 在裝置上採用的管理模式類型。這項政策會影響系統支援的政策設定。 |
state |
要套用至裝置的狀態。這個欄位可透過修補要求進行修改。請注意,呼叫 |
applied |
目前套用至裝置的狀態。 |
policy |
裝置是否符合政策規定。 |
non |
裝置不符合的政策設定詳細資料。 |
enrollment |
裝置註冊時間。 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 |
last |
裝置上次傳送狀態報告的時間。 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 |
lastPolicyComplianceReportTime |
已淘汰。 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 |
last |
裝置上次擷取政策的時間。 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 |
policy |
套用至裝置的政策名稱,格式為 |
applied |
目前套用至裝置的政策名稱。 |
applied |
目前套用至裝置的政策版本。 |
api |
裝置上執行的 Android 平台版本 API 級別。 |
enrollment |
如果裝置是使用含有額外資料的註冊憑證註冊,這個欄位就會包含該資料。 |
enrollment |
如果裝置是透過註冊權杖註冊,這個欄位會包含權杖名稱。 |
disabled |
如果裝置狀態為 |
software |
裝置軟體的詳細資訊。只有在裝置政策中的 |
hardware |
裝置硬體的詳細資訊。 |
displays[] |
裝置螢幕的詳細資訊。只有在裝置政策中的 |
application |
針對裝置上安裝的應用程式回報。只有在裝置政策中的 |
previous |
如果同一部實體裝置已多次註冊,這個欄位會包含舊裝置名稱。序號可做為專屬 ID,用於判斷是否有相同的實體裝置先前已註冊。名稱會依時間順序排列。 |
network |
裝置網路資訊。只有當裝置政策中的 |
memory |
記憶體資訊:包含裝置記憶體和儲存空間的相關資訊。 |
memory |
與記憶體和儲存空間測量相關的事件,按時間順序排列。只有在裝置政策中的 事件會保留一段時間,舊事件則會刪除。 |
power |
裝置上的電源管理事件 (依時間順序排列)。只有在裝置政策中的 |
hardware |
硬體狀態樣本依時間順序排列。只有在裝置政策中的 |
device |
裝置設定資訊。只有在裝置政策中的 |
user |
裝置擁有者。 |
system |
與裝置相關的所選系統屬性名稱和值對應。只有在裝置政策中的 這個物件中包含 |
security |
裝置的安全狀態值,反映裝置的安全性。 |
ownership |
受管理裝置的擁有權。 |
common |
共同準則模式的相關資訊:資訊技術安全評估共同準則 (CC) 中定義的安全標準。 只有在裝置獲派的政策中的 |
applied |
目前套用至裝置的密碼規定。
|
dpc |
僅供輸出。這部裝置是否已從由其他裝置政策控制器 (DPC) 管理的裝置遷移。 |
DeviceState
可套用至裝置的狀態。
列舉 | |
---|---|
DEVICE_STATE_UNSPECIFIED |
系統不允許使用這個值。 |
ACTIVE |
裝置已啟用。 |
DISABLED |
裝置已停用。 |
DELETED |
已刪除裝置。API 呼叫一律不會傳回這個狀態,但裝置確認刪除時,會在最終狀態報告中使用。如果裝置是透過 API 呼叫刪除,系統就會將這項狀態發布至 Pub/Sub。如果使用者刪除工作資料夾或重設裝置,伺服器仍無法取得裝置狀態。 |
PROVISIONING |
系統正在佈建裝置。新註冊的裝置會處於這個狀態,直到套用政策為止。 |
LOST |
裝置遺失。這項狀態僅適用於機構擁有的裝置。 |
PREPARING_FOR_MIGRATION |
裝置正在準備遷移至 Android Management API。您無須採取進一步行動,遷移作業就會繼續進行。 |
DEACTIVATED_BY_DEVICE_FINANCE |
這是經融資服務專員「鎖定」的分期付款裝置。這表示已套用特定政策設定,限制裝置功能,直到融資代理商「解鎖」裝置為止。裝置會繼續套用政策設定,但會排除分期付款代理程式覆寫的設定。當裝置「鎖定」時,appliedState 會將狀態回報為 DEACTIVATED_BY_DEVICE_FINANCE 。 |
NonComplianceDetail
提供政策設定不符的詳細資料。
JSON 表示法 |
---|
{ "settingName": string, "nonComplianceReason": enum ( |
欄位 | |
---|---|
setting |
政策設定的名稱。這是頂層 |
non |
裝置不符合設定的原因。 |
package |
指明哪一個應用程式不符合規定的套件名稱 (如適用)。 |
field |
如果設定包含巢狀欄位,且特定巢狀欄位不符合規定,則會指定違規欄位的完整路徑。路徑的格式與 JavaScript 政策 JSON 欄位的參照方式相同,即:1) 如果是物件類型的欄位,欄位名稱後面會有一個點,後面接著子欄位名稱。2) 陣列型欄位的欄位名稱後面會加上陣列索引,並以括號括住。舉例來說,如要指出第 3 應用程式中 |
current |
如果無法套用政策設定,表示裝置上目前設定的值。 |
installation |
如果已設定 |
specific |
裝置未遵守設定的政策特定原因。 |
specific |
|
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 ( |
欄位 | |
---|---|
onc |
其他不符合 Wi-Fi 設定規範的背景資訊。請參閱《 |
password |
與密碼政策相關的違規額外背景資訊。請參閱 |
OncWifiContext
與 Wi-Fi 設定相關的違規額外背景資訊。
JSON 表示法 |
---|
{ "wifiGuid": string } |
欄位 | |
---|---|
wifi |
不符規定的 Wi-Fi 設定 GUID。 |
PasswordPoliciesContext
與密碼政策相關的違規額外背景資訊。
JSON 表示法 |
---|
{
"passwordPolicyScope": enum ( |
欄位 | |
---|---|
password |
不符合規定的密碼範圍。 |
SoftwareInfo
裝置軟體相關資訊。
JSON 表示法 |
---|
{
"androidVersion": string,
"androidDevicePolicyVersionCode": integer,
"androidDevicePolicyVersionName": string,
"androidBuildNumber": string,
"deviceKernelVersion": string,
"bootloaderVersion": string,
"androidBuildTime": string,
"securityPatchLevel": string,
"primaryLanguageCode": string,
"deviceBuildSignature": string,
"systemUpdateInfo": {
object ( |
欄位 | |
---|---|
android |
使用者看到的 Android 版本字串。例如 |
android |
Android Device Policy 應用程式版本代碼。 |
android |
向使用者顯示的 Android Device Policy 應用程式版本。 |
android |
供向使用者顯示的 Android 版本 ID 字串。例如 |
device |
核心版本,例如 |
bootloader |
系統啟動載入程式版本號碼,例如 |
android |
建構時間。 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 |
security |
安全性修補程式等級,例如 |
primary |
裝置上主要語言代碼的 IETF BCP 47 語言代碼。 |
device |
與系統套件相關聯的 |
system |
關於可能待處理的系統更新資訊。 |
SystemUpdateInfo
關於可能待處理的系統更新資訊。
JSON 表示法 |
---|
{
"updateStatus": enum ( |
欄位 | |
---|---|
update |
更新的狀態:是否有更新,以及更新類型。 |
update |
首次發布更新的時間。如果值為零,表示未設定這個欄位。只有在有可用的更新時,系統才會設定這個欄位 (也就是 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。範例: |
UpdateStatus
更新狀態:是否有更新,以及更新類型。
列舉 | |
---|---|
UPDATE_STATUS_UNKNOWN |
無法得知是否有待處理的系統更新。例如,如果裝置 API 級別低於 26,或是 Android 裝置政策版本過舊,就會發生這種情況。 |
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 |
硬體名稱。例如 |
device |
基頻版本。例如 |
manufacturer |
製造商。例如 |
serial |
裝置序號。 |
model |
裝置型號。例如 |
battery |
裝置上每個電池的電池關閉溫度門檻,以攝氏為單位。 |
battery |
裝置上每個電池的電池節流溫度門檻,以攝氏溫度為單位。 |
cpu |
裝置上每個 CPU 的 CPU 關閉溫度門檻 (以攝氏為單位)。 |
cpu |
裝置上每個 CPU 的 CPU 節流溫度門檻 (以攝氏為單位)。 |
gpu |
裝置上每個 GPU 的 GPU 關閉溫度閾值 (攝氏溫度)。 |
gpu |
裝置上每個 GPU 的 GPU 節流溫度門檻 (攝氏溫度)。 |
skin |
裝置皮膚關閉溫度門檻 (攝氏)。 |
skin |
裝置外殼降速溫度門檻,以攝氏為單位。 |
enterprise |
僅供輸出。專門用於辨識特定機構中個人裝置的 ID。在同一實體裝置上,如果註冊相同的機構,這個 ID 會在設定和恢復原廠設定後持續存在。這項 ID 適用於個人擁有的裝置 (搭載 Android 12 以上版本),且裝置上必須設有工作資料夾。 |
多媒體
裝置顯示資訊。
JSON 表示法 |
---|
{
"name": string,
"displayId": integer,
"refreshRate": integer,
"state": enum ( |
欄位 | |
---|---|
name |
螢幕的名稱。 |
display |
不重複的顯示 ID。 |
refresh |
畫面的刷新率 (以每秒影格數為單位)。 |
state |
螢幕的狀態。 |
width |
顯示寬度 (以像素為單位)。 |
height |
螢幕高度 (以像素為單位)。 |
density |
以每英寸像素數表示的顯示密度。 |
DisplayState
螢幕的狀態。
列舉 | |
---|---|
DISPLAY_STATE_UNSPECIFIED |
系統不允許使用這個值。 |
OFF |
螢幕關閉。 |
ON |
螢幕已開啟。 |
DOZE |
螢幕處於低耗電狀態 |
SUSPENDED |
螢幕處於低耗電狀態的休眠狀態。 |
ApplicationReport
已安裝應用程式的回報資訊。
JSON 表示法 |
---|
{ "packageName": string, "versionName": string, "versionCode": integer, "events": [ { object ( |
欄位 | |
---|---|
package |
應用程式的套件名稱。 |
version |
向使用者顯示的應用程式版本。 |
version |
應用程式版本代碼,可用來判斷某版本是否比其他版本新。 |
events[] |
過去 30 小時內發生的應用程式事件清單。 |
display |
應用程式的顯示名稱。 |
package |
應用程式 APK 檔案的 SHA-256 雜湊值,可用於驗證應用程式未經修改。雜湊值的每個位元組都會以兩位十六進位數字表示。 |
signing |
與應用程式套件相關聯的每個 |
installer |
安裝這個應用程式的應用程式套件名稱。 |
application |
套件的來源。 |
state |
應用程式狀態。 |
keyed |
應用程式回報的已編碼應用程式狀態清單。 |
user |
應用程式是否面向使用者。 |
ApplicationEvent
應用程式相關事件。
JSON 表示法 |
---|
{
"eventType": enum ( |
欄位 | |
---|---|
event |
應用程式事件類型。 |
create |
事件的建立時間。 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,請通知我」)。 |
create |
裝置上應用程式狀態的建立時間。 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。範例: |
last |
上次更新應用程式狀態的時間。 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 號碼。例如 |
wifi |
裝置的 Wi-Fi MAC 位址。例如 |
networkOperatorName |
目前註冊運算子名稱的字母。例如 Vodafone。 |
telephony |
提供與裝置上每張 SIM 卡相關聯的電話資訊。僅支援 Android API 級別 23 以上的全受控裝置。 |
TelephonyInfo
與裝置上特定 SIM 卡相關聯的電話通訊資訊。僅支援 Android API 級別 23 以上的全管理裝置。
JSON 表示法 |
---|
{ "phoneNumber": string, "carrierName": string, "iccId": string } |
欄位 | |
---|---|
phone |
與此 SIM 卡相關聯的電話號碼。 |
carrier |
與這張 SIM 卡相關聯的電信業者名稱。 |
icc |
僅供輸出。與此 SIM 卡相關聯的 ICCID。 |
MemoryInfo
裝置記憶體和儲存空間的相關資訊。
JSON 表示法 |
---|
{ "totalRam": string, "totalInternalStorage": string } |
欄位 | |
---|---|
total |
裝置上的 RAM 總量,以位元組為單位。 |
total |
裝置上的內部儲存空間總量,以位元組為單位。 |
MemoryEvent
與記憶體和儲存空間評估相關的事件。
如要區分新事件和舊事件,建議使用
欄位。createTime
JSON 表示法 |
---|
{
"eventType": enum ( |
欄位 | |
---|---|
event |
這是指活動類型。 |
create |
事件的建立時間。 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 |
byte |
媒體中的可用位元組數,或 |
MemoryEventType
事件類型。
列舉 | |
---|---|
MEMORY_EVENT_TYPE_UNSPECIFIED |
不明。沒有任何事件屬於這個類型。 |
RAM_MEASURED |
測量 RAM 中的可用空間。 |
INTERNAL_STORAGE_MEASURED |
測量內部儲存空間的剩餘空間。 |
EXTERNAL_STORAGE_DETECTED |
系統偵測到新的外部儲存媒體。回報的位元組數量是儲存媒體的總容量。 |
EXTERNAL_STORAGE_REMOVED |
已移除外部儲存媒體。回報的位元組數為零。 |
EXTERNAL_STORAGE_MEASURED |
測量外部儲存媒體中的可用空間。 |
PowerManagementEvent
電源管理事件。
JSON 表示法 |
---|
{
"eventType": enum ( |
欄位 | |
---|---|
event |
這是指活動類型。 |
create |
事件的建立時間。 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 |
battery |
對於 |
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 ] } |
欄位 | |
---|---|
create |
測量時間。 RFC3339 世界標準時間「Zulu」格式的時間戳記,精確度達奈秒單位,最多九個小數位數。例如 |
battery |
裝置上每個電池目前的電池溫度 (攝氏)。 |
cpu |
裝置上每個 CPU 的目前 CPU 溫度 (攝氏)。 |
gpu |
裝置上每個 GPU 目前的 GPU 溫度 (攝氏)。 |
skin |
目前裝置的皮膚溫度 (攝氏)。 |
fan |
裝置上每個風扇的風扇速度 (以 RPM 為單位)。空陣列表示系統上沒有風扇或不支援風扇速度。 |
cpu |
裝置上可用的每個核心的 CPU 用量百分比。每個未插電的核心的用量為 0。空陣列表示系統不支援 CPU 使用量。 |
DeviceSettings
裝置上安全性相關裝置設定的資訊。
JSON 表示法 |
---|
{
"isDeviceSecure": boolean,
"unknownSourcesEnabled": boolean,
"developmentSettingsEnabled": boolean,
"adbEnabled": boolean,
"isEncrypted": boolean,
"encryptionStatus": enum ( |
欄位 | |
---|---|
is |
裝置是否受到 PIN 碼/密碼保護。 |
unknown |
是否啟用從不明來源安裝應用程式的功能。 |
development |
裝置是否已啟用開發人員模式。 |
adb |
是否在裝置上啟用 ADB。 |
is |
是否啟用儲存空間加密。 |
encryption |
DevicePolicyManager 的加密狀態。 |
verify |
裝置是否強制執行 Google Play 安全防護驗證。 |
EncryptionStatus
裝置的加密狀態。
列舉 | |
---|---|
ENCRYPTION_STATUS_UNSPECIFIED |
不明。任何裝置都不應使用這類型別。 |
UNSUPPORTED |
裝置不支援加密功能。 |
INACTIVE |
裝置支援加密功能,但目前未啟用。 |
ACTIVATING |
加密功能目前未啟用,但正在啟用中。 |
ACTIVE |
已啟用加密功能。 |
ACTIVE_DEFAULT_KEY |
已啟用加密功能,但使用者未設定加密金鑰。 |
ACTIVE_PER_USER |
加密功能已啟用,且加密金鑰已連結至使用者個人資料。 |
SecurityPosture
裝置的安全防護狀態,取決於目前的裝置狀態和套用的政策。
JSON 表示法 |
---|
{ "devicePosture": enum ( |
欄位 | |
---|---|
device |
裝置的安全性狀態值。 |
posture |
裝置安全防護機制的其他詳細資料。 |
DevicePosture
受管理裝置的可能安全狀態值。
列舉 | |
---|---|
POSTURE_UNSPECIFIED |
不明。這個姿勢值沒有姿勢詳細資料。 |
SECURE |
這部裝置安全無虞。 |
AT_RISK |
相較於建議與公司資料搭配使用,這部裝置可能更易遭受惡意攻擊。 |
POTENTIALLY_COMPROMISED |
這部裝置可能遭到入侵,未經授權的人士可能會存取公司資料。 |
PostureDetail
裝置安全防護機制的其他詳細資料。
JSON 表示法 |
---|
{ "securityRisk": enum ( |
欄位 | |
---|---|
security |
特定安全風險,會對裝置的安全狀態造成負面影響。 |
advice[] |
針對管理員提供的對應建議,可降低這項安全性風險,並改善裝置安全性。 |
SecurityRisk
導致裝置處於不安全狀態的風險。
列舉 | |
---|---|
SECURITY_RISK_UNSPECIFIED |
未指明 |
UNKNOWN_OS |
Play Integrity API 偵測到裝置執行不明的作業系統 (basicIntegrity 檢查成功,但 ctsProfileMatch 失敗)。 |
COMPROMISED_OS |
Play Integrity API 偵測到裝置正在執行遭到入侵的作業系統 (基本完整性檢查失敗)。 |
HARDWARE_BACKED_EVALUATION_FAILED |
如果 裝置完整性欄位未顯示 MEETS_STRONG_INTEGRITY 標籤,Play Integrity API 會偵測到裝置無法確保系統完整性。 |
CommonCriteriaModeInfo
共同準則模式的相關資訊:資訊技術安全評估共同準則 (CC) 中定義的安全標準。
只有在裝置政策中 statusReportingSettings.commonCriteriaModeEnabled
為 true
時,才能取得這項資訊。
JSON 表示法 |
---|
{ "commonCriteriaModeStatus": enum ( |
欄位 | |
---|---|
common |
是否已啟用共同準則模式。 |
policy |
僅供輸出。政策簽名驗證狀態。 |
CommonCriteriaModeStatus
是否已啟用共同準則模式。
列舉 | |
---|---|
COMMON_CRITERIA_MODE_STATUS_UNKNOWN |
狀態不明。 |
COMMON_CRITERIA_MODE_DISABLED |
目前已停用共同準則模式。 |
COMMON_CRITERIA_MODE_ENABLED |
目前已啟用共同準則模式。 |
PolicySignatureVerificationStatus
政策簽名驗證狀態。
列舉 | |
---|---|
POLICY_SIGNATURE_VERIFICATION_STATUS_UNSPECIFIED |
不明。未回報驗證狀態。只有在 為 false 時才會設定。 |
POLICY_SIGNATURE_VERIFICATION_DISABLED |
設為 False,因此裝置上會停用政策簽章驗證功能。 |
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED |
已成功驗證政策簽章。 |
POLICY_SIGNATURE_VERIFICATION_NOT_SUPPORTED |
不支援政策簽章驗證,例如裝置已註冊使用不支援政策簽章驗證的 CloudDPC 版本。 |
POLICY_SIGNATURE_VERIFICATION_FAILED |
政策簽章驗證失敗。未套用這項政策。 |
DpcMigrationInfo
與這部裝置是否由其他裝置政策控制器 (DPC) 管理的相關資訊有關。
JSON 表示法 |
---|
{ "previousDpc": string, "additionalData": string } |
欄位 | |
---|---|
previous |
僅供輸出。如果這部裝置是從其他 DPC 遷移而來,則此為其套件名稱。否則不會填入。 |
additional |
僅供輸出。如果這部裝置是從其他 DPC 遷移而來,遷移憑證的 |
方法 |
|
---|---|
|
刪除裝置。 |
|
取得裝置。 |
|
向裝置發出指令。 |
|
列出特定企業的裝置。 |
|
更新裝置。 |