MCP Tools Reference: Android Device Management MCP Server

เครื่องมือ: list_devices

แสดงรายการอุปกรณ์สำหรับองค์กรที่ระบุ ต้องระบุรหัสองค์กรในฟิลด์ระดับบน (เช่น enterprises/{enterpriseId})

ตัวอย่างต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ list_devices MCP

คำขอ Curl
curl --location 'https://androidmanagement.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "list_devices", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }'

สคีมาอินพุต

ขอแสดงอุปกรณ์สำหรับองค์กรที่ต้องการ

ListDevicesRequest

การแสดง JSON
{ "parent": string, "pageSize": integer, "pageToken": string }

ช่อง
parent	string ชื่อขององค์กรในรูปแบบ enterprises/{enterpriseId}
pageSize	integer ขนาดหน้าที่ขอ หากไม่ระบุ ระบบจะแสดงผลอุปกรณ์อย่างน้อย 10 เครื่อง ค่าสูงสุดคือ 100 และค่าที่สูงกว่า 100 จะถูกบังคับให้เป็น 100 ขีดจำกัดอาจมีการเปลี่ยนแปลงเมื่อเวลาผ่านไป
pageToken	string โทเค็นที่ระบุหน้าผลลัพธ์ที่เซิร์ฟเวอร์ส่งคืน

สคีมาเอาต์พุต

การตอบกลับคำขอแสดงรายการอุปกรณ์สำหรับองค์กรที่ระบุ

ListDevicesResponse

การแสดง JSON
{ "devices": [ { object (Device) } ], "nextPageToken": string }

ช่อง
devices[]	object (Device) รายการอุปกรณ์
nextPageToken	string หากมีผลลัพธ์เพิ่มเติม จะมีโทเค็นเพื่อดึงข้อมูลผลลัพธ์ในหน้าถัดไป

อุปกรณ์

การแสดง JSON

{ "name": string, "userName": string, "managementMode": enum (ManagementMode), "state": enum (DeviceState), "appliedState": enum (DeviceState), "policyCompliant": boolean, "nonComplianceDetails": [ { object (NonComplianceDetail) } ], "enrollmentTime": string, "lastStatusReportTime": string, "lastPolicyComplianceReportTime": string, "lastPolicySyncTime": string, "policyName": string, "appliedPolicyName": string, "appliedPolicyVersion": string, "apiLevel": integer, "enrollmentTokenData": string, "enrollmentTokenName": string, "disabledReason": { object (UserFacingMessage) }, "softwareInfo": { object (SoftwareInfo) }, "hardwareInfo": { object (HardwareInfo) }, "displays": [ { object (Display) } ], "applicationReports": [ { object (ApplicationReport) } ], "previousDeviceNames": [ string ], "networkInfo": { object (NetworkInfo) }, "memoryInfo": { object (MemoryInfo) }, "memoryEvents": [ { object (MemoryEvent) } ], "powerManagementEvents": [ { object (PowerManagementEvent) } ], "hardwareStatusSamples": [ { object (HardwareStatus) } ], "deviceSettings": { object (DeviceSettings) }, "user": { object (User) }, "systemProperties": { string: string, ... }, "securityPosture": { object (SecurityPosture) }, "ownership": enum (Ownership), "commonCriteriaModeInfo": { object (CommonCriteriaModeInfo) }, "appliedPasswordPolicies": [ { object (PasswordRequirements) } ], "dpcMigrationInfo": { object (DpcMigrationInfo) }, "defaultApplicationInfo": [ { object (DefaultApplicationInfo) } ] }

ช่อง
name	string ชื่อของอุปกรณ์ในรูปแบบ enterprises/{enterpriseId}/devices/{deviceId}
userName	string ชื่อทรัพยากรของผู้ใช้ที่เป็นเจ้าของอุปกรณ์นี้ในรูปแบบ enterprises/{enterpriseId}/users/{userId}
managementMode	enum (ManagementMode) ประเภทโหมดการจัดการที่ Android Device Policy ใช้ในอุปกรณ์ ซึ่งจะมีผลต่อการตั้งค่านโยบายที่รองรับ
state	enum (DeviceState) สถานะที่จะใช้กับอุปกรณ์ โดยแก้ไขฟิลด์นี้ได้ด้วยคำขอแพตช์ โปรดทราบว่าเมื่อเรียกใช้ enterprises.devices.patch, ACTIVE และ DISABLED ค่าที่อนุญาตจะมีเพียงค่าเหล่านี้เท่านั้น หากต้องการนำอุปกรณ์เข้าสู่สถานะ DELETED ให้โทรหา enterprises.devices.delete
appliedState	enum (DeviceState) สถานะที่ใช้กับอุปกรณ์ในปัจจุบัน
policyCompliant	boolean อุปกรณ์เป็นไปตามนโยบายหรือไม่
nonComplianceDetails[]	object (NonComplianceDetail) รายละเอียดเกี่ยวกับการตั้งค่านโยบายที่อุปกรณ์ไม่เป็นไปตามข้อกำหนด
enrollmentTime	string (Timestamp format) เวลาที่ลงทะเบียนอุปกรณ์ ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
lastStatusReportTime	string (Timestamp format) เวลาล่าสุดที่อุปกรณ์ส่งรายงานสถานะ ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
lastPolicyComplianceReportTime (deprecated)	string (Timestamp format) รายการนี้เลิกใช้งานแล้ว เลิกใช้งานแล้ว ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
lastPolicySyncTime	string (Timestamp format) เวลาล่าสุดที่อุปกรณ์เรียกดูนโยบาย ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
policyName	string ชื่อของนโยบายที่ใช้กับอุปกรณ์ในรูปแบบ enterprises/{enterpriseId}/policies/{policyId} หากไม่ได้ระบุ ระบบจะใช้ policy_name สำหรับผู้ใช้อุปกรณ์ โดยแก้ไขฟิลด์นี้ได้ด้วยคำขอแพตช์ คุณระบุได้เฉพาะ policyId เมื่อเรียกใช้ enterprises.devices.patch ตราบใดที่ policyId ไม่มีเครื่องหมายทับ ระบบจะอนุมานชื่อนโยบายส่วนที่เหลือ
appliedPolicyName	string ชื่อของนโยบายที่ใช้กับอุปกรณ์ในปัจจุบัน
appliedPolicyVersion	string (int64 format) เวอร์ชันของนโยบายที่ใช้กับอุปกรณ์ในปัจจุบัน
apiLevel	integer ระดับ API ของเวอร์ชันแพลตฟอร์ม Android ที่ทำงานในอุปกรณ์
enrollmentTokenData	string หากอุปกรณ์ลงทะเบียนด้วยโทเค็นการลงทะเบียนที่มีการระบุข้อมูลเพิ่มเติม ฟิลด์นี้จะมีข้อมูลดังกล่าว
enrollmentTokenName	string หากอุปกรณ์ลงทะเบียนด้วยโทเค็นการลงทะเบียน ฟิลด์นี้จะมีชื่อของโทเค็น
disabledReason	object (UserFacingMessage) หากสถานะอุปกรณ์เป็น DISABLED ข้อความที่ไม่บังคับซึ่งแสดงในอุปกรณ์เพื่อระบุเหตุผลที่ปิดใช้อุปกรณ์ โดยแก้ไขฟิลด์นี้ได้ด้วยคำขอแพตช์
softwareInfo	object (SoftwareInfo) ข้อมูลโดยละเอียดเกี่ยวกับซอฟต์แวร์ของอุปกรณ์ ข้อมูลนี้จะใช้ได้ก็ต่อเมื่อ softwareInfoEnabled เป็น "จริง" ในนโยบายของอุปกรณ์
hardwareInfo	object (HardwareInfo) ข้อมูลโดยละเอียดเกี่ยวกับฮาร์ดแวร์ของอุปกรณ์
displays[]	object (Display) ข้อมูลโดยละเอียดเกี่ยวกับจอแสดงผลในอุปกรณ์ ข้อมูลนี้จะใช้ได้ก็ต่อเมื่อ displayInfoEnabled เป็น "จริง" ในนโยบายของอุปกรณ์
applicationReports[]	object (ApplicationReport) รายงานสำหรับแอปที่ติดตั้งในอุปกรณ์ ข้อมูลนี้จะใช้ได้เมื่อ application_reports_enabled เป็น "จริง" ในนโยบายของอุปกรณ์เท่านั้น
previousDeviceNames[]	string หากมีการลงทะเบียนอุปกรณ์จริงเครื่องเดียวกันหลายครั้ง ฟิลด์นี้จะมีชื่ออุปกรณ์ก่อนหน้า ระบบจะใช้หมายเลขซีเรียลเป็นตัวระบุที่ไม่ซ้ำกันเพื่อพิจารณาว่าอุปกรณ์จริงเครื่องเดียวกันนี้เคยลงทะเบียนไว้ก่อนหน้านี้หรือไม่ โดยชื่อจะเรียงตามลำดับเวลา
networkInfo	object (NetworkInfo) ข้อมูลเครือข่ายของอุปกรณ์ ข้อมูลนี้จะใช้ได้ก็ต่อเมื่อ networkInfoEnabled เป็น "จริง" ในนโยบายของอุปกรณ์
memoryInfo	object (MemoryInfo) ข้อมูลหน่วยความจำ: มีข้อมูลเกี่ยวกับหน่วยความจำและพื้นที่เก็บข้อมูลของอุปกรณ์
memoryEvents[]	object (MemoryEvent) เหตุการณ์ที่เกี่ยวข้องกับการวัดหน่วยความจำและพื้นที่เก็บข้อมูลตามลำดับเวลา ข้อมูลนี้จะใช้ได้ก็ต่อเมื่อ memoryInfoEnabled เป็น "จริง" ในนโยบายของอุปกรณ์ ระบบจะเก็บกิจกรรมไว้เป็นระยะเวลาหนึ่งและลบกิจกรรมเก่า
powerManagementEvents[]	object (PowerManagementEvent) เหตุการณ์การจัดการพลังงานในอุปกรณ์ตามลำดับเวลา ข้อมูลนี้จะใช้ได้ก็ต่อเมื่อ powerManagementEventsEnabled เป็น "จริง" ในนโยบายของอุปกรณ์
hardwareStatusSamples[]	object (HardwareStatus) ตัวอย่างสถานะของฮาร์ดแวร์ตามลำดับเวลา ข้อมูลนี้จะใช้ได้ก็ต่อเมื่อ hardwareStatusEnabled เป็น "จริง" ในนโยบายของอุปกรณ์
deviceSettings	object (DeviceSettings) ข้อมูลการตั้งค่าอุปกรณ์ ข้อมูลนี้จะใช้ได้ก็ต่อเมื่อ deviceSettingsEnabled เป็น "จริง" ในนโยบายของอุปกรณ์
user	object (User) ผู้ใช้ที่เป็นเจ้าของอุปกรณ์
systemProperties	map (key: string, value: string) แผนที่ของชื่อและค่าพร็อพเพอร์ตี้ของระบบที่เลือกซึ่งเกี่ยวข้องกับอุปกรณ์ ข้อมูลนี้จะใช้ได้ก็ต่อเมื่อ systemPropertiesEnabled เป็น "จริง" ในนโยบายของอุปกรณ์ ออบเจ็กต์ที่มีรายการคู่ "key": value เช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
securityPosture	object (SecurityPosture) ค่าท่าทางด้านความปลอดภัยของอุปกรณ์ที่แสดงถึงระดับความปลอดภัยของอุปกรณ์
ownership	enum (Ownership) การเป็นเจ้าของอุปกรณ์ที่มีการจัดการ
commonCriteriaModeInfo	object (CommonCriteriaModeInfo) ข้อมูลเกี่ยวกับโหมด Common Criteria ซึ่งเป็นมาตรฐานความปลอดภัยที่กำหนดไว้ใน Common Criteria for Information Technology Security Evaluation (CC) ข้อมูลนี้จะใช้ได้ก็ต่อเมื่อ statusReportingSettings.commonCriteriaModeEnabled เป็น true ในนโยบายของอุปกรณ์ที่บริษัทเป็นเจ้าของ
appliedPasswordPolicies[]	object (PasswordRequirements) ข้อกำหนดของรหัสผ่านที่ใช้อยู่ในอุปกรณ์ ฟิลด์นี้มีอยู่เนื่องจากข้อกำหนดที่ใช้ในบางกรณีอาจแตกต่างจากข้อกำหนดที่ระบุไว้ใน passwordPolicies เล็กน้อย โปรดทราบว่าช่องนี้ไม่ได้ให้ข้อมูลเกี่ยวกับการปฏิบัติตามข้อกำหนดของรหัสผ่าน ดูข้อมูลเกี่ยวกับการไม่ปฏิบัติตามข้อกำหนดได้ที่ nonComplianceDetails NonComplianceDetail.fieldPath จะตั้งค่าตาม passwordPolicies ไม่ใช่ตามช่องนี้
dpcMigrationInfo	object (DpcMigrationInfo) เอาต์พุตเท่านั้น ข้อมูลที่เกี่ยวข้องกับว่าอุปกรณ์นี้ได้รับการย้ายข้อมูลจากการจัดการโดยเครื่องมือควบคุมนโยบายด้านอุปกรณ์ (DPC) อื่นหรือไม่
defaultApplicationInfo[]	object (DefaultApplicationInfo) เอาต์พุตเท่านั้น ข้อมูลแอปพลิเคชันเริ่มต้นสำหรับ DefaultApplicationType ข้อมูลนี้จะใช้ได้ก็ต่อเมื่อ defaultApplicationInfoReportingEnabled เป็น "จริง" ในนโยบายของอุปกรณ์ พร้อมใช้งานบน Android 16 ขึ้นไป ระบบจะรายงานแอปทุกประเภทในอุปกรณ์ที่มีการจัดการแบบครบวงจร ระบบจะรายงานประเภท DEFAULT_BROWSER, DEFAULT_CALL_REDIRECTION, DEFAULT_CALL_SCREENING และ DEFAULT_DIALER สำหรับโปรไฟล์งานในอุปกรณ์ของบริษัทที่มีโปรไฟล์งานและอุปกรณ์ส่วนตัว DEFAULT_WALLET จะรายงานสำหรับอุปกรณ์ของบริษัทที่มีโปรไฟล์งานด้วย แต่จะรวมเฉพาะข้อมูลโปรไฟล์งาน

NonComplianceDetail

การแสดง JSON
{ "settingName": string, "nonComplianceReason": enum (NonComplianceReason), "packageName": string, "fieldPath": string, "currentValue": value, "installationFailureReason": enum (InstallationFailureReason), "specificNonComplianceReason": enum (SpecificNonComplianceReason), "specificNonComplianceContext": { object (SpecificNonComplianceContext) } }

ช่อง
settingName	string ชื่อของการตั้งค่านโยบาย นี่คือชื่อฟิลด์ JSON ของฟิลด์ Policy ระดับบนสุด
nonComplianceReason	enum (NonComplianceReason) เหตุผลที่อุปกรณ์ไม่เป็นไปตามการตั้งค่า
packageName	string ชื่อแพ็กเกจที่ระบุว่าแอปใดไม่เป็นไปตามข้อกำหนด (หากมี)
fieldPath	string สำหรับการตั้งค่าที่มีฟิลด์ที่ซ้อนกัน หากฟิลด์ที่ซ้อนกันใดฟิลด์หนึ่งไม่เป็นไปตามข้อกำหนด การตั้งค่านี้จะระบุเส้นทางแบบเต็มไปยังฟิลด์ที่ไม่เป็นไปตามข้อกำหนด เส้นทางจะจัดรูปแบบในลักษณะเดียวกับที่ฟิลด์ JSON ของนโยบายจะอ้างอิงใน JavaScript นั่นคือ 1) สำหรับฟิลด์ประเภทออบเจ็กต์ ชื่อฟิลด์จะตามด้วยจุด แล้วตามด้วยชื่อฟิลด์ย่อย 2) สำหรับฟิลด์ประเภทอาร์เรย์ ชื่อฟิลด์จะตามด้วยดัชนีอาร์เรย์ที่อยู่ในวงเล็บ เช่น หากต้องการระบุปัญหาเกี่ยวกับฟิลด์ url ในฟิลด์ externalData ในแอปพลิเคชันที่ 3 เส้นทางจะเป็น applications[2].externalData.url
currentValue	value (Value format) หากใช้การตั้งค่านโยบายไม่ได้ ค่าปัจจุบันของการตั้งค่าในอุปกรณ์
installationFailureReason	enum (InstallationFailureReason) หากตั้งค่า package_name และเหตุผลที่แอปไม่เป็นไปตามนโยบายคือ APP_NOT_INSTALLED หรือ APP_NOT_UPDATED ระบบจะแสดงเหตุผลโดยละเอียดที่แอปติดตั้งหรืออัปเดตไม่ได้
specificNonComplianceReason	enum (SpecificNonComplianceReason) เหตุผลเฉพาะนโยบายที่อุปกรณ์ไม่เป็นไปตามการตั้งค่า
specificNonComplianceContext	object (SpecificNonComplianceContext) บริบทเพิ่มเติมสำหรับ specific_non_compliance_reason

ค่า

การแสดง JSON
{ // Union field kind can be only one of the following: "nullValue": null, "numberValue": number, "stringValue": string, "boolValue": boolean, "structValue": { object }, "listValue": array // End of list of possible types for union field kind. }

ช่อง
ฟิลด์ Union kind ประเภทของค่า kind ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
nullValue	null แสดงค่า Null
numberValue	number แสดงค่าแบบ Double
stringValue	string แสดงค่าสตริง
boolValue	boolean แสดงค่าบูลีน
structValue	object (Struct format) แสดงค่าที่มีโครงสร้าง
listValue	array (ListValue format) แสดงถึง Value ที่ทำซ้ำ

โครงสร้าง

การแสดง JSON
{ "fields": { string: value, ... } }

ช่อง
fields	map (key: string, value: value (Value format)) แมปของค่าที่พิมพ์แบบไดนามิกที่ไม่ได้เรียงลำดับ ออบเจ็กต์ที่มีรายการคู่ "key": value เช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }

FieldsEntry

การแสดง JSON
{ "key": string, "value": value }

ช่อง
key	string
value	value (Value format)

ListValue

การแสดง JSON
{ "values": [ value ] }

ช่อง
values[]	value (Value format) ฟิลด์ที่ซ้ำของค่าที่พิมพ์แบบไดนามิก

SpecificNonComplianceContext

การแสดง JSON
{ "oncWifiContext": { object (OncWifiContext) }, "passwordPoliciesContext": { object (PasswordPoliciesContext) }, "defaultApplicationContext": { object (DefaultApplicationContext) } }

ช่อง
oncWifiContext	object (OncWifiContext) บริบทเพิ่มเติมสำหรับการไม่ปฏิบัติตามข้อกำหนดที่เกี่ยวข้องกับการกำหนดค่า Wi-Fi ดู ONC_WIFI_INVALID_VALUE และ ONC_WIFI_API_LEVEL
passwordPoliciesContext	object (PasswordPoliciesContext) บริบทเพิ่มเติมสำหรับการไม่ปฏิบัติตามนโยบายรหัสผ่าน โปรดอ่านPASSWORD_POLICIES_PASSWORD_EXPIREDและPASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT
defaultApplicationContext	object (DefaultApplicationContext) เอาต์พุตเท่านั้น บริบทเพิ่มเติมสำหรับการไม่ปฏิบัติตามข้อกำหนดที่เกี่ยวข้องกับการตั้งค่าแอปพลิเคชันเริ่มต้น ดูDEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE

OncWifiContext

การแสดง JSON
{ "wifiGuid": string }

ช่อง
wifiGuid	string GUID ของการกำหนดค่า Wi-Fi ที่ไม่เป็นไปตามข้อกำหนด

PasswordPoliciesContext

การแสดง JSON
{ "passwordPolicyScope": enum (PasswordPolicyScope) }

ช่อง
passwordPolicyScope	enum (PasswordPolicyScope) ขอบเขตของรหัสผ่านที่ไม่เป็นไปตามข้อกำหนด

DefaultApplicationContext

การแสดง JSON
{ "defaultApplicationScope": enum (DefaultApplicationScope) }

ช่อง
defaultApplicationScope	enum (DefaultApplicationScope) เอาต์พุตเท่านั้น ขอบเขตของการตั้งค่าแอปพลิเคชันเริ่มต้นที่ไม่เป็นไปตามข้อกำหนด

การประทับเวลา

การแสดง JSON
{ "seconds": string, "nanos": integer }

ช่อง
seconds	string (int64 format) แสดงวินาทีของเวลา UTC ตั้งแต่ Epoch ของ Unix 1970-01-01T00:00:00Z ต้องอยู่ระหว่าง -62135596800 ถึง 253402300799 เท่านั้น (ซึ่งสอดคล้องกับ 0001-01-01T00:00:00Z ถึง 9999-12-31T23:59:59Z)
nanos	integer เศษส่วนของวินาทีที่ไม่เป็นค่าลบที่ความละเอียดระดับนาโนวินาที ฟิลด์นี้คือส่วนของระยะเวลาที่เป็นนาโนวินาที ไม่ใช่ทางเลือกแทนวินาที ค่าวินาทีที่เป็นลบซึ่งมีเศษส่วนยังคงต้องมีค่านาโนที่เป็นค่าบวกซึ่งนับไปข้างหน้าตามเวลา ต้องอยู่ระหว่าง 0 ถึง 999,999,999 เท่านั้น

UserFacingMessage

การแสดง JSON
{ "localizedMessages": { string: string, ... }, "defaultMessage": string }

ช่อง
localizedMessages	map (key: string, value: string) แผนที่ที่มีคู่ <locale, message> โดยที่ locale เป็นรหัสภาษา BCP 47 ที่มีรูปแบบถูกต้อง เช่น en-US, es-ES หรือ fr ออบเจ็กต์ที่มีรายการคู่ "key": value เช่น { "name": "wrench", "mass": "1.3kg", "count": "3" }
defaultMessage	string ข้อความเริ่มต้นที่จะแสดงหากไม่ได้ระบุข้อความที่แปลแล้วหรือสถานที่ของผู้ใช้ไม่ตรงกับข้อความที่แปลแล้ว ต้องระบุข้อความเริ่มต้นหากมีการระบุข้อความที่แปลแล้ว

LocalizedMessagesEntry

การแสดง JSON
{ "key": string, "value": string }

ช่อง
key	string
value	string

SoftwareInfo

การแสดง JSON
{ "androidVersion": string, "androidDevicePolicyVersionCode": integer, "androidDevicePolicyVersionName": string, "androidBuildNumber": string, "deviceKernelVersion": string, "bootloaderVersion": string, "androidBuildTime": string, "securityPatchLevel": string, "primaryLanguageCode": string, "deviceBuildSignature": string, "systemUpdateInfo": { object (SystemUpdateInfo) } }

ช่อง
androidVersion	string สตริงเวอร์ชัน Android ที่ผู้ใช้มองเห็นได้ เช่น 6.0.1
androidDevicePolicyVersionCode	integer รหัสเวอร์ชันของแอป Android Device Policy
androidDevicePolicyVersionName	string เวอร์ชันของแอป Android Device Policy ที่แสดงต่อผู้ใช้
androidBuildNumber	string สตริงรหัสบิลด์ของ Android ที่มีไว้สำหรับแสดงต่อผู้ใช้ เช่น shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys
deviceKernelVersion	string เวอร์ชันเคอร์เนล เช่น 2.6.32.9-g103d848
bootloaderVersion	string หมายเลขเวอร์ชันของ Bootloader ของระบบ เช่น 0.6.7
androidBuildTime	string (Timestamp format) เวลาบิลด์ ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
securityPatchLevel	string ระดับแพตช์ด้านความปลอดภัย เช่น 2016-05-01
primaryLanguageCode	string รหัสภาษา IETF BCP 47 สำหรับภาษาหลักในอุปกรณ์
deviceBuildSignature	string แฮช SHA-256 ของ android.content.pm.Signature ที่เชื่อมโยงกับแพ็กเกจระบบ ซึ่งใช้เพื่อยืนยันว่าไม่ได้มีการแก้ไขบิลด์ระบบ
systemUpdateInfo	object (SystemUpdateInfo) ข้อมูลเกี่ยวกับการอัปเดตระบบที่อาจรอดำเนินการ

SystemUpdateInfo

การแสดง JSON
{ "updateStatus": enum (UpdateStatus), "updateReceivedTime": string }

ช่อง
updateStatus	enum (UpdateStatus) สถานะของการอัปเดต: มีการอัปเดตหรือไม่และเป็นประเภทใด
updateReceivedTime	string (Timestamp format) เวลาที่การอัปเดตพร้อมใช้งานเป็นครั้งแรก ค่า 0 หมายความว่าไม่ได้ตั้งค่าช่องนี้ ช่องนี้จะตั้งค่าก็ต่อเมื่อมีการอัปเดต (กล่าวคือ updateStatus ไม่ใช่ UPDATE_STATUS_UNKNOWN หรือ UP_TO_DATE) ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

HardwareInfo

การแสดง 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, "euiccChipInfo": [ { object (EuiccChipInfo) } ] }

ช่อง
brand	string แบรนด์ของอุปกรณ์ เช่น Google
hardware	string ชื่อของฮาร์ดแวร์ เช่น Angler
deviceBasebandVersion	string เวอร์ชันเบสแบนด์ เช่น MDM9625_104662.22.05.34p
manufacturer	string ผู้ผลิต เช่น Motorola
serialNumber	string หมายเลขซีเรียลของอุปกรณ์ อย่างไรก็ตาม สำหรับอุปกรณ์ส่วนตัวที่ใช้ Android 12 ขึ้นไป การดำเนินการนี้จะเหมือนกับenterpriseSpecificId
model	string รุ่นของอุปกรณ์ เช่น Asus Nexus 7
batteryShutdownTemperatures[]	number เกณฑ์อุณหภูมิการปิดเครื่องเนื่องจากแบตเตอรี่หมดในหน่วยเซลเซียสสำหรับแบตเตอรี่แต่ละก้อนในอุปกรณ์
batteryThrottlingTemperatures[]	number เกณฑ์อุณหภูมิการควบคุมแบตเตอรี่เป็นองศาเซลเซียสสำหรับแบตเตอรี่แต่ละก้อนในอุปกรณ์
cpuShutdownTemperatures[]	number เกณฑ์อุณหภูมิการปิด CPU ในหน่วยเซลเซียสสำหรับ CPU แต่ละตัวในอุปกรณ์
cpuThrottlingTemperatures[]	number เกณฑ์อุณหภูมิการควบคุม CPU เป็นองศาเซลเซียสสำหรับ CPU แต่ละตัวในอุปกรณ์
gpuShutdownTemperatures[]	number เกณฑ์อุณหภูมิการปิด GPU เป็นองศาเซลเซียสสำหรับ GPU แต่ละตัวในอุปกรณ์
gpuThrottlingTemperatures[]	number เกณฑ์อุณหภูมิการควบคุม GPU ในหน่วยเซลเซียสสำหรับ GPU แต่ละตัวในอุปกรณ์
skinShutdownTemperatures[]	number เกณฑ์อุณหภูมิการปิดเครื่องเนื่องจากอุณหภูมิผิวหนังของอุปกรณ์ในหน่วยเซลเซียส
skinThrottlingTemperatures[]	number เกณฑ์อุณหภูมิการควบคุมความร้อนของผิวหนังของอุปกรณ์ในหน่วยเซลเซียส
enterpriseSpecificId	string เอาต์พุตเท่านั้น รหัสที่ระบุอุปกรณ์ส่วนตัวในองค์กรหนึ่งๆ โดยไม่ซ้ำกัน ในอุปกรณ์จริงเครื่องเดียวกันเมื่อลงทะเบียนกับองค์กรเดียวกัน รหัสนี้จะยังคงอยู่ในการตั้งค่าต่างๆ และแม้แต่การรีเซ็ตเป็นค่าเริ่มต้น รหัสนี้ใช้ได้ในอุปกรณ์ส่วนตัวที่มีโปรไฟล์งานในอุปกรณ์ที่ใช้ Android 12 ขึ้นไป
euiccChipInfo[]	object (EuiccChipInfo) เอาต์พุตเท่านั้น ข้อมูลที่เกี่ยวข้องกับชิป eUICC

EuiccChipInfo

การแสดง JSON
{ "eid": string }

ช่อง
eid	string เอาต์พุตเท่านั้น เอกสารระบุตัวตนแบบฝัง (EID) ที่ระบุชิป eUICC สำหรับชิป eUICC แต่ละชิปในอุปกรณ์ ฟีเจอร์นี้ใช้ได้ในอุปกรณ์ของบริษัทที่ใช้ Android 13 ขึ้นไป

ดิสเพลย์

การแสดง JSON
{ "name": string, "displayId": integer, "refreshRate": integer, "state": enum (DisplayState), "width": integer, "height": integer, "density": integer }

ช่อง
name	string ชื่อของจอแสดงผล
displayId	integer รหัสการแสดงผลที่ไม่ซ้ำกัน
refreshRate	integer อัตราการรีเฟรชของจอแสดงผลเป็นเฟรมต่อวินาที
state	enum (DisplayState) สถานะของจอแสดงผล
width	integer ความกว้างของการแสดงผลเป็นพิกเซล
height	integer ความสูงของการแสดงผลในหน่วยพิกเซล
density	integer ความหนาแน่นของการแสดงผลที่แสดงเป็นจุดต่อนิ้ว

ApplicationReport

การแสดง JSON

{ "packageName": string, "versionName": string, "versionCode": integer, "events": [ { object (ApplicationEvent) } ], "displayName": string, "packageSha256Hash": string, "signingKeyCertFingerprints": [ string ], "installerPackageName": string, "applicationSource": enum (ApplicationSource), "state": enum (ApplicationState), "keyedAppStates": [ { object (KeyedAppState) } ], "userFacingType": enum (UserFacingType) }

ช่อง
packageName	string ชื่อแพ็กเกจของแอป
versionName	string เวอร์ชันแอปที่แสดงต่อผู้ใช้
versionCode	integer รหัสเวอร์ชันของแอป ซึ่งใช้เพื่อพิจารณาว่าเวอร์ชันใดใหม่กว่าอีกเวอร์ชันหนึ่ง
events[]	object (ApplicationEvent) รายการเหตุการณ์ของแอปที่เกิดขึ้นในช่วง 30 ชั่วโมงที่ผ่านมา
displayName	string ชื่อที่แสดงของแอป
packageSha256Hash	string แฮช SHA-256 ของไฟล์ APK ของแอป ซึ่งใช้เพื่อยืนยันว่าแอปไม่ได้รับการแก้ไข แต่ละไบต์ของค่าแฮชจะแสดงเป็นตัวเลขฐาน 16 2 หลัก
signingKeyCertFingerprints[]	string แฮช SHA-1 ของ android.content.pm.Signature แต่ละรายการที่เชื่อมโยงกับแพ็กเกจแอป แต่ละไบต์ของค่าแฮชแต่ละค่าจะแสดงเป็นตัวเลขฐาน 16 2 หลัก
installerPackageName	string ชื่อแพ็กเกจของแอปที่ติดตั้งแอปนี้
applicationSource	enum (ApplicationSource) แหล่งที่มาของแพ็กเกจ
state	enum (ApplicationState) สถานะของแอปพลิเคชัน
keyedAppStates[]	object (KeyedAppState) รายการสถานะแอปที่ใช้คีย์ซึ่งแอปรายงาน
userFacingType	enum (UserFacingType) แอปเป็นแอปที่ผู้ใช้ใช้งานหรือไม่

ApplicationEvent

การแสดง JSON
{ "eventType": enum (ApplicationEventType), "createTime": string }

ช่อง
eventType	enum (ApplicationEventType) ประเภทเหตุการณ์ของแอป
createTime	string (Timestamp format) เวลาที่สร้างเหตุการณ์ ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

KeyedAppState

การแสดง JSON
{ "key": string, "severity": enum (Severity), "message": string, "data": string, "createTime": string, "lastUpdateTime": string }

ช่อง
key	string คีย์สำหรับสถานะแอป ทำหน้าที่เป็นจุดอ้างอิงสำหรับสิ่งที่แอปกำลังให้บริการสถานะ ตัวอย่างเช่น เมื่อให้ความคิดเห็นเกี่ยวกับการกำหนดค่าที่มีการจัดการ คีย์นี้อาจเป็นคีย์การกำหนดค่าที่มีการจัดการ
severity	enum (Severity) ความรุนแรงของสถานะแอป
message	string สตริงข้อความรูปแบบอิสระเพื่ออธิบายสถานะแอป (ไม่บังคับ) หากสถานะเกิดจากค่าใดค่าหนึ่ง (เช่น ค่าการกำหนดค่าที่มีการจัดการ) คุณควรรวมค่าดังกล่าวไว้ในข้อความ
data	string ค่าที่เครื่องอ่านได้ซึ่ง EMM จะอ่าน (ไม่บังคับ) เช่น การตั้งค่าที่ผู้ดูแลระบบเลือกเพื่อค้นหาในคอนโซล EMM ได้ (เช่น "แจ้งเตือนฉันหากข้อมูล battery_warning น้อยกว่า 10")
createTime	string (Timestamp format) เวลาที่สร้างสถานะแอปในอุปกรณ์ ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
lastUpdateTime	string (Timestamp format) เวลาที่อัปเดตสถานะแอปครั้งล่าสุด ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"

NetworkInfo

การแสดง JSON
{ "imei": string, "meid": string, "wifiMacAddress": string, "networkOperatorName": string, "telephonyInfos": [ { object (TelephonyInfo) } ] }

ช่อง
imei	string หมายเลข IMEI ของอุปกรณ์ GSM เช่น A1000031212
meid	string หมายเลข MEID ของอุปกรณ์ CDMA เช่น A00000292788E1
wifiMacAddress	string ที่อยู่ MAC ของ Wi-Fi ของอุปกรณ์ เช่น 7c:11:11:11:11:11
networkOperatorName (deprecated)	string networkOperatorName เลิกใช้งานแล้ว โปรดใช้ telephonyInfos แทน ชื่อตัวอักษรของผู้ให้บริการที่จดทะเบียนในปัจจุบัน เช่น Vodafone
telephonyInfos[]	object (TelephonyInfo) ให้ข้อมูลการโทรที่เชื่อมโยงกับซิมการ์ดแต่ละอันในอุปกรณ์ รองรับเฉพาะในอุปกรณ์ที่มีการจัดการเต็มรูปแบบตั้งแต่ Android API ระดับ 23 ขึ้นไป

TelephonyInfo

การแสดง JSON
{ "phoneNumber": string, "carrierName": string, "iccId": string, "activationState": enum (ActivationState), "configMode": enum (ConfigMode) }

ช่อง
phoneNumber	string หมายเลขโทรศัพท์ที่เชื่อมโยงกับซิมการ์ดนี้
carrierName	string ชื่อผู้ให้บริการที่เชื่อมโยงกับซิมการ์ดนี้
iccId	string เอาต์พุตเท่านั้น ICCID ที่เชื่อมโยงกับซิมการ์ดนี้
activationState	enum (ActivationState) เอาต์พุตเท่านั้น สถานะการเปิดใช้งานของซิมการ์ดในอุปกรณ์ โดยจะใช้ได้กับ eSIM เท่านั้น ฟีเจอร์นี้ใช้ได้ในอุปกรณ์ทั้งหมดสำหรับ API ระดับ 35 ขึ้นไป ซึ่งจะเป็น ACTIVATION_STATE_UNSPECIFIED เสมอสำหรับซิมจริงและอุปกรณ์ที่ต่ำกว่า API ระดับ 35
configMode	enum (ConfigMode) เอาต์พุตเท่านั้น โหมดการกำหนดค่าของซิมการ์ดในอุปกรณ์ โดยจะใช้ได้กับ eSIM เท่านั้น ฟีเจอร์นี้ใช้ได้ในอุปกรณ์ทั้งหมดสำหรับ API ระดับ 35 ขึ้นไป ซึ่งจะเป็น CONFIG_MODE_UNSPECIFIED เสมอสำหรับซิมจริงและอุปกรณ์ที่ต่ำกว่า API ระดับ 35

MemoryInfo

การแสดง JSON
{ "totalRam": string, "totalInternalStorage": string }

ช่อง
totalRam	string (int64 format) RAM ทั้งหมดในอุปกรณ์ในหน่วยไบต์
totalInternalStorage	string (int64 format) พื้นที่เก็บข้อมูลภายในทั้งหมดในอุปกรณ์เป็นไบต์

MemoryEvent

การแสดง JSON
{ "eventType": enum (MemoryEventType), "createTime": string, "byteCount": string }

ช่อง
eventType	enum (MemoryEventType) ประเภทของกิจกรรม
createTime	string (Timestamp format) เวลาที่สร้างเหตุการณ์ ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
byteCount	string (int64 format) จำนวนไบต์ที่ว่างในสื่อ หรือสำหรับ EXTERNAL_STORAGE_DETECTED ความจุทั้งหมดในหน่วยไบต์ของสื่อบันทึกข้อมูล

PowerManagementEvent

การแสดง JSON
{ "eventType": enum (PowerManagementEventType), "createTime": string, "batteryLevel": number }

ช่อง
eventType	enum (PowerManagementEventType) ประเภทของกิจกรรม
createTime	string (Timestamp format) เวลาที่สร้างเหตุการณ์ ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
batteryLevel	number สำหรับเหตุการณ์ BATTERY_LEVEL_COLLECTED ระดับแบตเตอรี่เป็นเปอร์เซ็นต์

HardwareStatus

การแสดง JSON
{ "createTime": string, "batteryTemperatures": [ number ], "cpuTemperatures": [ number ], "gpuTemperatures": [ number ], "skinTemperatures": [ number ], "fanSpeeds": [ number ], "cpuUsages": [ number ] }

ช่อง
createTime	string (Timestamp format) เวลาที่ทำการวัด ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
batteryTemperatures[]	number อุณหภูมิแบตเตอรี่ปัจจุบันในหน่วยเซลเซียสสำหรับแบตเตอรี่แต่ละก้อนในอุปกรณ์
cpuTemperatures[]	number อุณหภูมิ CPU ปัจจุบันในหน่วยเซลเซียสสำหรับ CPU แต่ละตัวในอุปกรณ์
gpuTemperatures[]	number อุณหภูมิ GPU ปัจจุบันในหน่วยเซลเซียสสำหรับ GPU แต่ละตัวในอุปกรณ์
skinTemperatures[]	number อุณหภูมิผิวหนังปัจจุบันของอุปกรณ์ในหน่วยเซลเซียส
fanSpeeds[]	number ความเร็วพัดลมในหน่วย RPM สำหรับพัดลมแต่ละตัวในอุปกรณ์ อาร์เรย์ว่างหมายความว่าไม่มีพัดลมหรือระบบไม่รองรับความเร็วพัดลม
cpuUsages[]	number การใช้งาน CPU เป็นเปอร์เซ็นต์สำหรับแต่ละแกนที่พร้อมใช้งานในอุปกรณ์ การใช้งานจะเป็น 0 สำหรับแต่ละคอร์ที่ไม่ได้เสียบปลั๊ก อาร์เรย์ว่างหมายความว่าระบบไม่รองรับการใช้งาน CPU

DeviceSettings

การแสดง JSON
{ "isDeviceSecure": boolean, "unknownSourcesEnabled": boolean, "developmentSettingsEnabled": boolean, "adbEnabled": boolean, "isEncrypted": boolean, "encryptionStatus": enum (EncryptionStatus), "verifyAppsEnabled": boolean }

ช่อง
isDeviceSecure	boolean อุปกรณ์รักษาความปลอดภัยด้วย PIN/รหัสผ่านหรือไม่
unknownSourcesEnabled	boolean เปิดใช้การติดตั้งแอปจากแหล่งที่มาที่ไม่รู้จักหรือไม่
developmentSettingsEnabled	boolean เปิดใช้โหมดนักพัฒนาซอฟต์แวร์ในอุปกรณ์หรือไม่
adbEnabled	boolean เปิดใช้ ADB ในอุปกรณ์หรือไม่
isEncrypted	boolean เปิดใช้การเข้ารหัสพื้นที่เก็บข้อมูลหรือไม่
encryptionStatus	enum (EncryptionStatus) สถานะการเข้ารหัสจาก DevicePolicyManager
verifyAppsEnabled	boolean มีการบังคับใช้การยืนยันของ Google Play Protect ในอุปกรณ์หรือไม่

ผู้ใช้

การแสดง JSON
{ "accountIdentifier": string }

ช่อง
accountIdentifier	string ตัวระบุที่ไม่ซ้ำกันที่คุณสร้างขึ้นสำหรับผู้ใช้รายนี้ เช่น user342 หรือ asset#44418 คุณต้องตั้งค่าช่องนี้เมื่อสร้างผู้ใช้และจะอัปเดตไม่ได้ ฟิลด์นี้ต้องไม่มีข้อมูลส่วนบุคคลที่ระบุตัวบุคคลนั้นได้ (PII) ตัวระบุนี้ต้องมีความยาวไม่เกิน 1, 024 อักขระ ไม่เช่นนั้นคำขออัปเดตนโยบายจะล้มเหลว

SystemPropertiesEntry

การแสดง JSON
{ "key": string, "value": string }

ช่อง
key	string
value	string

SecurityPosture

การแสดง JSON
{ "devicePosture": enum (DevicePosture), "postureDetails": [ { object (PostureDetail) } ] }

ช่อง
devicePosture	enum (DevicePosture) ค่าลักษณะการทำงานด้านความปลอดภัยของอุปกรณ์
postureDetails[]	object (PostureDetail) รายละเอียดเพิ่มเติมเกี่ยวกับท่าทางด้านความปลอดภัยของอุปกรณ์

PostureDetail

การแสดง JSON
{ "securityRisk": enum (SecurityRisk), "advice": [ { object (UserFacingMessage) } ] }

ช่อง
securityRisk	enum (SecurityRisk) ความเสี่ยงด้านความปลอดภัยที่เฉพาะเจาะจงซึ่งส่งผลเสียต่อท่าทีด้านความปลอดภัยของอุปกรณ์
advice[]	object (UserFacingMessage) คำแนะนำที่เกี่ยวข้องสำหรับผู้ดูแลระบบเพื่อลดความเสี่ยงด้านความปลอดภัยนี้และปรับปรุงระดับความปลอดภัยของอุปกรณ์

CommonCriteriaModeInfo

การแสดง JSON
{ "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus), "policySignatureVerificationStatus": enum (PolicySignatureVerificationStatus) }

ช่อง
commonCriteriaModeStatus	enum (CommonCriteriaModeStatus) เปิดใช้โหมด Common Criteria หรือไม่
policySignatureVerificationStatus	enum (PolicySignatureVerificationStatus) เอาต์พุตเท่านั้น สถานะการยืนยันลายเซ็นของนโยบาย

PasswordRequirements

การแสดง JSON

{ "passwordMinimumLength": integer, "passwordMinimumLetters": integer, "passwordMinimumLowerCase": integer, "passwordMinimumNonLetter": integer, "passwordMinimumNumeric": integer, "passwordMinimumSymbols": integer, "passwordMinimumUpperCase": integer, "passwordQuality": enum (PasswordQuality), "passwordHistoryLength": integer, "maximumFailedPasswordsForWipe": integer, "passwordExpirationTimeout": string, "passwordScope": enum (PasswordPolicyScope), "requirePasswordUnlock": enum (RequirePasswordUnlock), "unifiedLockSettings": enum (UnifiedLockSettings) }

ช่อง
passwordMinimumLength	integer ความยาวขั้นต่ำของรหัสผ่านที่อนุญาต ค่า 0 หมายความว่าไม่มีข้อจำกัด บังคับใช้เมื่อ password_quality เป็น NUMERIC, NUMERIC_COMPLEX, ALPHABETIC, ALPHANUMERIC หรือ COMPLEX เท่านั้น
passwordMinimumLetters	integer จำนวนตัวอักษรขั้นต่ำที่ต้องมีในรหัสผ่าน จะบังคับใช้เมื่อ password_quality เป็น COMPLEX เท่านั้น
passwordMinimumLowerCase	integer จำนวนตัวอักษรพิมพ์เล็กขั้นต่ำที่ต้องมีในรหัสผ่าน จะบังคับใช้เมื่อ password_quality เป็น COMPLEX เท่านั้น
passwordMinimumNonLetter	integer จำนวนอักขระที่ไม่ใช่ตัวอักษรขั้นต่ำ (ตัวเลขหรือสัญลักษณ์) ที่ต้องมีในรหัสผ่าน จะบังคับใช้เมื่อ password_quality เป็น COMPLEX เท่านั้น
passwordMinimumNumeric	integer จำนวนหลักที่เป็นตัวเลขขั้นต่ำที่ต้องมีในรหัสผ่าน จะบังคับใช้เมื่อ password_quality เป็น COMPLEX เท่านั้น
passwordMinimumSymbols	integer จำนวนสัญลักษณ์ขั้นต่ำที่ต้องมีในรหัสผ่าน จะบังคับใช้เมื่อ password_quality เป็น COMPLEX เท่านั้น
passwordMinimumUpperCase	integer จำนวนตัวอักษรพิมพ์ใหญ่ขั้นต่ำที่ต้องมีในรหัสผ่าน จะบังคับใช้เมื่อ password_quality เป็น COMPLEX เท่านั้น
passwordQuality	enum (PasswordQuality) คุณภาพรหัสผ่านที่จำเป็น
passwordHistoryLength	integer ความยาวของประวัติรหัสผ่าน หลังจากตั้งค่าช่องนี้แล้ว ผู้ใช้จะป้อนรหัสผ่านใหม่ที่เหมือนกับรหัสผ่านใดก็ตามในประวัติไม่ได้ ค่า 0 หมายความว่าไม่มีข้อจำกัด
maximumFailedPasswordsForWipe	integer จำนวนครั้งที่ป้อนรหัสผ่านปลดล็อกอุปกรณ์ที่ไม่ถูกต้องได้ก่อนที่จะล้างข้อมูลอุปกรณ์ ค่า 0 หมายความว่าไม่มีข้อจำกัด
passwordExpirationTimeout	string (Duration format) การหมดเวลาการหมดอายุของรหัสผ่าน ระยะเวลาเป็นวินาทีที่มีเศษทศนิยมได้สูงสุด 9 หลัก โดยลงท้ายด้วย 's' เช่น "3.5s"
passwordScope	enum (PasswordPolicyScope) ขอบเขตที่ใช้ข้อกำหนดของรหัสผ่าน
requirePasswordUnlock	enum (RequirePasswordUnlock) ระยะเวลาหลังจากปลดล็อกอุปกรณ์หรือโปรไฟล์งานโดยใช้รูปแบบการตรวจสอบสิทธิ์ที่มีความปลอดภัยสูง (รหัสผ่าน, PIN, รูปแบบ) ที่สามารถปลดล็อกได้โดยใช้วิธีการตรวจสอบสิทธิ์อื่นๆ (เช่น ลายนิ้วมือ, ตัวแทนที่เชื่อถือได้, ใบหน้า) หลังจากระยะเวลาที่ระบุผ่านไปแล้ว จะใช้ได้เฉพาะการตรวจสอบสิทธิ์ที่มีความปลอดภัยสูงเพื่อปลดล็อกอุปกรณ์หรือโปรไฟล์งาน
unifiedLockSettings	enum (UnifiedLockSettings) ควบคุมว่าจะอนุญาตการล็อกแบบรวมสำหรับอุปกรณ์และโปรไฟล์งานในอุปกรณ์ที่ใช้ Android 9 ขึ้นไปที่มีโปรไฟล์งานหรือไม่ คุณจะตั้งค่านี้ได้ก็ต่อเมื่อตั้งค่า password_scope เป็น SCOPE_PROFILE เท่านั้น มิเช่นนั้นระบบจะปฏิเสธนโยบาย หากผู้ใช้ไม่ได้ตั้งค่าการล็อกของโปรไฟล์งานแยกต่างหากและตั้งค่าฟิลด์นี้เป็น REQUIRE_SEPARATE_WORK_LOCK ระบบจะรายงาน NonComplianceDetail โดยตั้งค่า nonComplianceReason เป็น USER_ACTION

ระยะเวลา

การแสดง JSON
{ "seconds": string, "nanos": integer }

ช่อง
seconds	string (int64 format) วินาทีที่ลงนามของช่วงเวลา ต้องอยู่ระหว่าง -315,576,000,000 ถึง +315,576,000,000 เท่านั้น หมายเหตุ: ขอบเขตเหล่านี้คำนวณจาก 60 วินาที/นาที * 60 นาที/ชั่วโมง * 24 ชั่วโมง/วัน * 365.25 วัน/ปี * 10000 ปี
nanos	integer เศษส่วนของวินาทีที่มีการลงนามที่ความละเอียดระดับนาโนวินาทีของช่วงเวลา ระยะเวลาที่น้อยกว่า 1 วินาทีจะแสดงด้วยฟิลด์ 0 seconds และฟิลด์ nanos ที่เป็นบวกหรือลบ สำหรับระยะเวลาตั้งแต่ 1 วินาทีขึ้นไป ค่าที่ไม่ใช่ 0 สำหรับฟิลด์ nanos ต้องมีเครื่องหมายเดียวกันกับฟิลด์ seconds ต้องอยู่ระหว่าง -999,999,999 ถึง +999,999,999 เท่านั้น

DpcMigrationInfo

การแสดง JSON
{ "previousDpc": string, "additionalData": string }

ช่อง
previousDpc	string เอาต์พุตเท่านั้น หากอุปกรณ์นี้ย้ายข้อมูลมาจาก DPC อื่น นี่คือชื่อแพ็กเกจของอุปกรณ์ มิเช่นนั้นจะไม่แสดง
additionalData	string เอาต์พุตเท่านั้น หากย้ายข้อมูลอุปกรณ์นี้จาก DPC อื่น ระบบจะกรอกข้อมูลในช่อง additionalData ของโทเค็นการย้ายข้อมูลที่นี่

DefaultApplicationInfo

การแสดง JSON
{ "defaultApplicationType": enum (DefaultApplicationType), "packageName": string, "defaultApplicationSettingAttempts": [ { object (DefaultApplicationSettingAttempt) } ] }

ช่อง
defaultApplicationType	enum (DefaultApplicationType) เอาต์พุตเท่านั้น ประเภทแอปพลิเคชันเริ่มต้น
packageName	string เอาต์พุตเท่านั้น ชื่อแพ็กเกจของแอปพลิเคชันเริ่มต้นปัจจุบัน
defaultApplicationSettingAttempts[]	object (DefaultApplicationSettingAttempt) เอาต์พุตเท่านั้น รายละเอียดเกี่ยวกับความพยายามในการตั้งค่าแอปพลิเคชันเริ่มต้น ตามลำดับเดียวกับที่ระบุไว้ใน defaultApplications

DefaultApplicationSettingAttempt

การแสดง JSON
{ "packageName": string, "attemptOutcome": enum (AttemptOutcome) }

ช่อง
packageName	string เอาต์พุตเท่านั้น ชื่อแพ็กเกจของแอปพลิเคชันที่พยายาม
attemptOutcome	enum (AttemptOutcome) เอาต์พุตเท่านั้น ผลลัพธ์ของการตั้งค่าแอปเป็นค่าเริ่มต้น

คำอธิบายประกอบเครื่องมือ

คำแนะนำที่ทำลายล้าง: ❌ | คำแนะนำที่ทำซ้ำได้: ✅ | คำแนะนำแบบอ่านอย่างเดียว: ✅ | คำแนะนำแบบโลกเปิด: ❌