Công cụ: get_device
Lấy thông tin chi tiết về thiết bị cho một doanh nghiệp và mã thiết bị nhất định. Yêu cầu tên tài nguyên ở định dạng: enterprises/{enterpriseId}/devices/{deviceId}.
Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ get_device MCP.
| Yêu cầu 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": "get_device", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
Giản đồ đầu vào
Yêu cầu lấy một thiết bị.
GetDeviceRequest
| Biểu diễn dưới dạng JSON |
|---|
{ "name": string } |
| Trường | |
|---|---|
name |
Tên của thiết bị ở dạng |
Giản đồ đầu ra
Thiết bị thuộc sở hữu của một doanh nghiệp. Trừ phi có ghi chú khác, tất cả các trường đều ở chế độ chỉ đọc và enterprises.devices.patch không thể sửa đổi.
Thiết bị
| Biểu diễn dưới dạng JSON |
|---|
{ "name": string, "userName": string, "managementMode": enum ( |
| Trường | |
|---|---|
name |
Tên của thiết bị ở dạng |
userName |
Tên tài nguyên của người dùng sở hữu thiết bị này ở dạng |
managementMode |
Loại chế độ quản lý mà Android Device Policy áp dụng trên thiết bị. Điều này ảnh hưởng đến những chế độ cài đặt chính sách được hỗ trợ. |
state |
Trạng thái sẽ được áp dụng cho thiết bị. Bạn có thể sửa đổi trường này bằng yêu cầu vá. Xin lưu ý rằng khi gọi |
appliedState |
Trạng thái hiện được áp dụng cho thiết bị. |
policyCompliant |
Thiết bị có tuân thủ chính sách của thiết bị hay không. |
nonComplianceDetails[] |
Thông tin chi tiết về các chế độ cài đặt chính sách mà thiết bị không tuân thủ. |
enrollmentTime |
Thời gian đăng ký thiết bị. Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
lastStatusReportTime |
Lần gần đây nhất thiết bị gửi báo cáo trạng thái. Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
lastPolicyComplianceReportTime |
Không dùng nữa. Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
lastPolicySyncTime |
Lần gần đây nhất thiết bị tìm nạp chính sách. Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
policyName |
Tên của chính sách được áp dụng cho thiết bị, ở dạng |
appliedPolicyName |
Tên của chính sách hiện đang áp dụng cho thiết bị. |
appliedPolicyVersion |
Phiên bản chính sách hiện đang áp dụng cho thiết bị. |
apiLevel |
Cấp độ API của phiên bản nền tảng Android đang chạy trên thiết bị. |
enrollmentTokenData |
Nếu thiết bị được đăng ký bằng mã thông báo đăng ký có dữ liệu bổ sung được cung cấp, thì trường này sẽ chứa dữ liệu đó. |
enrollmentTokenName |
Nếu thiết bị được đăng ký bằng mã thông báo đăng ký, thì trường này sẽ chứa tên của mã thông báo. |
disabledReason |
Nếu trạng thái thiết bị là |
softwareInfo |
Thông tin chi tiết về phần mềm thiết bị. Thông tin này chỉ có sẵn nếu |
hardwareInfo |
Thông tin chi tiết về phần cứng của thiết bị. |
displays[] |
Thông tin chi tiết về màn hình trên thiết bị. Thông tin này chỉ có sẵn nếu |
applicationReports[] |
Báo cáo về các ứng dụng đã cài đặt trên thiết bị. Thông tin này chỉ có khi |
previousDeviceNames[] |
Nếu cùng một thiết bị thực đã được đăng ký nhiều lần, trường này sẽ chứa tên thiết bị trước đó. Số sê-ri được dùng làm giá trị nhận dạng riêng biệt để xác định xem cùng một thiết bị thực đã đăng ký trước đó hay chưa. Tên được sắp xếp theo thứ tự thời gian. |
networkInfo |
Thông tin về mạng của thiết bị. Thông tin này chỉ có sẵn nếu |
memoryInfo |
Thông tin về bộ nhớ: chứa thông tin về bộ nhớ và bộ nhớ lưu trữ của thiết bị. |
memoryEvents[] |
Các sự kiện liên quan đến phép đo bộ nhớ và bộ nhớ lưu trữ theo trình tự thời gian. Thông tin này chỉ có sẵn nếu Các sự kiện được giữ lại trong một khoảng thời gian nhất định và các sự kiện cũ sẽ bị xoá. |
powerManagementEvents[] |
Các sự kiện quản lý nguồn trên thiết bị theo thứ tự thời gian. Thông tin này chỉ có sẵn nếu |
hardwareStatusSamples[] |
Các mẫu trạng thái phần cứng theo thứ tự thời gian. Thông tin này chỉ có sẵn nếu |
deviceSettings |
Thông tin về chế độ cài đặt thiết bị. Thông tin này chỉ có sẵn nếu |
user |
Người dùng sở hữu thiết bị. |
systemProperties |
Bản đồ tên và giá trị thuộc tính hệ thống đã chọn liên quan đến thiết bị. Thông tin này chỉ có sẵn nếu Một đối tượng chứa danh sách các cặp |
securityPosture |
Giá trị trạng thái bảo mật của thiết bị, phản ánh mức độ bảo mật của thiết bị. |
ownership |
Quyền sở hữu thiết bị được quản lý. |
commonCriteriaModeInfo |
Thông tin về Chế độ Tiêu chí chung – các tiêu chuẩn bảo mật được xác định trong Tiêu chí chung để đánh giá bảo mật công nghệ thông tin (CC). Thông tin này chỉ có sẵn nếu |
appliedPasswordPolicies[] |
Các yêu cầu về mật khẩu hiện đang áp dụng cho thiết bị.
|
dpcMigrationInfo |
Chỉ có đầu ra. Thông tin liên quan đến việc thiết bị này có được di chuyển từ trạng thái do một Trình điều khiển chính sách thiết bị (DPC) khác quản lý hay không. |
defaultApplicationInfo[] |
Chỉ có đầu ra. Thông tin ứng dụng mặc định cho Tất cả các loại ứng dụng đều được báo cáo trên thiết bị được quản lý toàn bộ. Các loại |
NonComplianceDetail
| Biểu diễn dưới dạng JSON |
|---|
{ "settingName": string, "nonComplianceReason": enum ( |
| Trường | |
|---|---|
settingName |
Tên của chế độ cài đặt chính sách. Đây là tên trường JSON của một trường |
nonComplianceReason |
Lý do thiết bị không tuân thủ chế độ cài đặt. |
packageName |
Tên gói cho biết ứng dụng nào không tuân thủ, nếu có. |
fieldPath |
Đối với các chế độ cài đặt có trường lồng nhau, nếu một trường lồng nhau cụ thể không tuân thủ, thì trường này sẽ chỉ định đường dẫn đầy đủ đến trường vi phạm. Đường dẫn được định dạng theo cách tương tự như trường JSON của chính sách sẽ được tham chiếu trong JavaScript, tức là: 1) Đối với các trường có kiểu đối tượng, tên trường sẽ theo sau là dấu chấm rồi đến tên trường con. 2) Đối với các trường có kiểu mảng, tên trường sẽ theo sau chỉ mục mảng được đặt trong dấu ngoặc. Ví dụ: để cho biết vấn đề với trường |
currentValue |
Nếu không áp dụng được chế độ cài đặt chính sách, thì giá trị hiện tại của chế độ cài đặt trên thiết bị. |
installationFailureReason |
Nếu bạn đặt |
specificNonComplianceReason |
Lý do cụ thể theo chính sách khiến thiết bị không tuân thủ chế độ cài đặt. |
specificNonComplianceContext |
Ngữ cảnh bổ sung cho |
Giá trị
| Biểu diễn dưới dạng JSON |
|---|
{ // Union field |
| Trường | |
|---|---|
Trường nhóm kind. Loại giá trị. kind chỉ có thể là một trong những trạng thái sau: |
|
nullValue |
Biểu thị một giá trị rỗng. |
numberValue |
Biểu thị một giá trị kiểu double. |
stringValue |
Biểu thị một giá trị chuỗi. |
boolValue |
Biểu thị một giá trị boolean. |
structValue |
Biểu thị một giá trị có cấu trúc. |
listValue |
Đại diện cho một |
Struct
| Biểu diễn dưới dạng JSON |
|---|
{ "fields": { string: value, ... } } |
| Trường | |
|---|---|
fields |
Bản đồ không có thứ tự của các giá trị được nhập động. Một đối tượng chứa danh sách các cặp |
FieldsEntry
| Biểu diễn dưới dạng JSON |
|---|
{ "key": string, "value": value } |
| Trường | |
|---|---|
key |
|
value |
|
ListValue
| Biểu diễn dưới dạng JSON |
|---|
{ "values": [ value ] } |
| Trường | |
|---|---|
values[] |
Trường lặp lại của các giá trị được nhập động. |
SpecificNonComplianceContext
| Biểu diễn dưới dạng JSON |
|---|
{ "oncWifiContext": { object ( |
| Trường | |
|---|---|
oncWifiContext |
Bối cảnh bổ sung cho trường hợp không tuân thủ liên quan đến cấu hình Wi-Fi. Hãy xem |
passwordPoliciesContext |
Thông tin bổ sung về trường hợp không tuân thủ liên quan đến chính sách mật khẩu. Hãy xem |
defaultApplicationContext |
Chỉ có đầu ra. Thông tin bổ sung về trường hợp không tuân thủ liên quan đến chế độ cài đặt mặc định của ứng dụng. Vui lòng xem |
OncWifiContext
| Biểu diễn dưới dạng JSON |
|---|
{ "wifiGuid": string } |
| Trường | |
|---|---|
wifiGuid |
GUID của cấu hình Wi-Fi không tuân thủ. |
PasswordPoliciesContext
| Biểu diễn dưới dạng JSON |
|---|
{
"passwordPolicyScope": enum ( |
| Trường | |
|---|---|
passwordPolicyScope |
Phạm vi của mật khẩu không tuân thủ. |
DefaultApplicationContext
| Biểu diễn dưới dạng JSON |
|---|
{
"defaultApplicationScope": enum ( |
| Trường | |
|---|---|
defaultApplicationScope |
Chỉ có đầu ra. Phạm vi của chế độ cài đặt ứng dụng mặc định không tuân thủ. |
Dấu thời gian
| Biểu diễn dưới dạng JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Trường | |
|---|---|
seconds |
Biểu thị số giây theo giờ UTC kể từ thời gian bắt đầu của hệ thống Unix là 00:00:00 ngày 01/01/1970. Phải nằm trong khoảng từ -62135596800 đến 253402300799 (tương ứng với 0001-01-01T00:00:00Z đến 9999-12-31T23:59:59Z). |
nanos |
Phân số không âm của một giây ở độ phân giải nano giây. Trường này là phần nano giây của khoảng thời gian, chứ không phải là một lựa chọn thay thế cho giây. Giá trị giây âm có phân số vẫn phải có giá trị nano giây không âm để đếm thời gian. Phải nằm trong khoảng từ 0 đến 999.999.999. |
UserFacingMessage
| Biểu diễn dưới dạng JSON |
|---|
{ "localizedMessages": { string: string, ... }, "defaultMessage": string } |
| Trường | |
|---|---|
localizedMessages |
Một bản đồ chứa các cặp <ngôn ngữ, thông báo>, trong đó ngôn ngữ là mã ngôn ngữ BCP 47 có cấu trúc tốt, chẳng hạn như en-US, es-ES hoặc fr. Một đối tượng chứa danh sách các cặp |
defaultMessage |
Thông báo mặc định sẽ xuất hiện nếu bạn không chỉ định thông báo được bản địa hoá hoặc ngôn ngữ của người dùng không khớp với bất kỳ thông báo được bản địa hoá nào. Bạn phải cung cấp một thông báo mặc định nếu cung cấp bất kỳ thông báo nào đã bản địa hoá. |
LocalizedMessagesEntry
| Biểu diễn dưới dạng JSON |
|---|
{ "key": string, "value": string } |
| Trường | |
|---|---|
key |
|
value |
|
SoftwareInfo
| Biểu diễn dưới dạng JSON |
|---|
{
"androidVersion": string,
"androidDevicePolicyVersionCode": integer,
"androidDevicePolicyVersionName": string,
"androidBuildNumber": string,
"deviceKernelVersion": string,
"bootloaderVersion": string,
"androidBuildTime": string,
"securityPatchLevel": string,
"primaryLanguageCode": string,
"deviceBuildSignature": string,
"systemUpdateInfo": {
object ( |
| Trường | |
|---|---|
androidVersion |
Chuỗi phiên bản Android mà người dùng nhìn thấy. Ví dụ: |
androidDevicePolicyVersionCode |
Mã phiên bản của ứng dụng Android Device Policy. |
androidDevicePolicyVersionName |
Phiên bản ứng dụng Android Device Policy mà người dùng nhìn thấy. |
androidBuildNumber |
Chuỗi mã nhận dạng bản dựng Android dùng để hiển thị cho người dùng. Ví dụ: |
deviceKernelVersion |
Phiên bản kernel, ví dụ: |
bootloaderVersion |
Số phiên bản trình tải khởi động hệ thống, ví dụ: |
androidBuildTime |
Thời gian xây dựng. Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
securityPatchLevel |
Cấp bản vá bảo mật, ví dụ: |
primaryLanguageCode |
Mã ngôn ngữ IETF BCP 47 cho ngôn ngữ chính trên thiết bị. |
deviceBuildSignature |
Giá trị băm SHA-256 của |
systemUpdateInfo |
Thông tin về một bản cập nhật hệ thống có thể đang chờ xử lý. |
SystemUpdateInfo
| Biểu diễn dưới dạng JSON |
|---|
{
"updateStatus": enum ( |
| Trường | |
|---|---|
updateStatus |
Trạng thái của bản cập nhật: có bản cập nhật hay không và loại bản cập nhật. |
updateReceivedTime |
Thời điểm bản cập nhật được cung cấp lần đầu tiên. Giá trị 0 cho biết trường này chưa được đặt. Trường này chỉ được đặt nếu có bản cập nhật (tức là Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
HardwareInfo
| Biểu diễn dưới dạng 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 ( |
| Trường | |
|---|---|
brand |
Thương hiệu của thiết bị. Ví dụ: |
hardware |
Tên của phần cứng. Ví dụ: |
deviceBasebandVersion |
Phiên bản băng tần cơ sở. Ví dụ: |
manufacturer |
Nhà sản xuất. Ví dụ: |
serialNumber |
Số sê-ri của thiết bị. Tuy nhiên, đối với các thiết bị thuộc sở hữu cá nhân chạy Android 12 trở lên, điều này cũng tương tự như |
model |
Mẫu thiết bị. Ví dụ: |
batteryShutdownTemperatures[] |
Ngưỡng nhiệt độ tắt pin (tính bằng độ C) cho từng pin trên thiết bị. |
batteryThrottlingTemperatures[] |
Ngưỡng nhiệt độ giảm hiệu suất pin (tính bằng độ C) cho từng pin trên thiết bị. |
cpuShutdownTemperatures[] |
Ngưỡng nhiệt độ tắt CPU tính bằng độ C cho từng CPU trên thiết bị. |
cpuThrottlingTemperatures[] |
Ngưỡng nhiệt độ điều tiết CPU tính bằng độ C cho từng CPU trên thiết bị. |
gpuShutdownTemperatures[] |
Ngưỡng nhiệt độ tắt GPU tính bằng độ C cho từng GPU trên thiết bị. |
gpuThrottlingTemperatures[] |
Ngưỡng nhiệt độ điều tiết GPU tính bằng độ C cho từng GPU trên thiết bị. |
skinShutdownTemperatures[] |
Ngưỡng nhiệt độ tắt thiết bị theo độ C. |
skinThrottlingTemperatures[] |
Ngưỡng nhiệt độ điều tiết trên da của thiết bị theo độ C. |
enterpriseSpecificId |
Chỉ có đầu ra. Mã nhận dạng riêng biệt của một thiết bị thuộc sở hữu cá nhân trong một tổ chức cụ thể. Trên cùng một thiết bị thực khi được đăng ký bằng cùng một tổ chức, mã nhận dạng này sẽ duy trì trong các lần thiết lập và ngay cả khi đặt lại về trạng thái ban đầu. Mã nhận dạng này có trên các thiết bị do cá nhân sở hữu có sử dụng hồ sơ công việc và chạy Android 12 trở lên. |
euiccChipInfo[] |
Chỉ có đầu ra. Thông tin liên quan đến chip eUICC. |
EuiccChipInfo
| Biểu diễn dưới dạng JSON |
|---|
{ "eid": string } |
| Trường | |
|---|---|
eid |
Chỉ có đầu ra. Tài liệu nhận dạng được nhúng (EID) giúp xác định chip eUICC cho từng chip eUICC trên thiết bị. Tính năng này có trên các thiết bị do công ty sở hữu chạy Android 13 trở lên. |
Màn hình
| Biểu diễn dưới dạng JSON |
|---|
{
"name": string,
"displayId": integer,
"refreshRate": integer,
"state": enum ( |
| Trường | |
|---|---|
name |
Tên của màn hình. |
displayId |
Mã nhận dạng duy nhất của màn hình. |
refreshRate |
Tốc độ làm mới của màn hình, tính bằng số khung hình/giây. |
state |
Trạng thái của màn hình. |
width |
Chiều rộng màn hình tính bằng pixel. |
height |
Chiều cao màn hình tính bằng pixel. |
density |
Mật độ hiển thị được biểu thị bằng số điểm trên mỗi inch. |
ApplicationReport
| Biểu diễn dưới dạng JSON |
|---|
{ "packageName": string, "versionName": string, "versionCode": integer, "events": [ { object ( |
| Trường | |
|---|---|
packageName |
Tên gói của ứng dụng. |
versionName |
Phiên bản ứng dụng mà người dùng nhìn thấy. |
versionCode |
Mã phiên bản ứng dụng, có thể dùng để xác định xem một phiên bản có mới hơn một phiên bản khác hay không. |
events[] |
Danh sách các sự kiện ứng dụng đã xảy ra trong 30 giờ qua. |
displayName |
Tên hiển thị của ứng dụng. |
packageSha256Hash |
Hàm băm SHA-256 của tệp APK của ứng dụng. Bạn có thể dùng hàm băm này để xác minh rằng ứng dụng chưa bị sửa đổi. Mỗi byte của giá trị băm được biểu thị dưới dạng một số thập lục phân gồm 2 chữ số. |
signingKeyCertFingerprints[] |
Băm SHA-1 của mỗi |
installerPackageName |
Tên gói của ứng dụng đã cài đặt ứng dụng này. |
applicationSource |
Nguồn của gói. |
state |
Trạng thái ứng dụng. |
keyedAppStates[] |
Danh sách các trạng thái ứng dụng có khoá do ứng dụng báo cáo. |
userFacingType |
Ứng dụng có hướng đến người dùng hay không. |
ApplicationEvent
| Biểu diễn dưới dạng JSON |
|---|
{
"eventType": enum ( |
| Trường | |
|---|---|
eventType |
Loại sự kiện ứng dụng. |
createTime |
Thời gian tạo sự kiện. Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
KeyedAppState
| Biểu diễn dưới dạng JSON |
|---|
{
"key": string,
"severity": enum ( |
| Trường | |
|---|---|
key |
Khoá cho trạng thái ứng dụng. Đóng vai trò là điểm tham chiếu cho trạng thái mà ứng dụng đang cung cấp. Ví dụ: khi cung cấp ý kiến phản hồi về cấu hình được quản lý, khoá này có thể là khoá cấu hình được quản lý. |
severity |
Mức độ nghiêm trọng của trạng thái ứng dụng. |
message |
Nếu muốn, bạn có thể dùng một chuỗi thông báo dạng tự do để giải thích trạng thái của ứng dụng. Nếu trạng thái được kích hoạt bởi một giá trị cụ thể (ví dụ: giá trị cấu hình được quản lý), thì bạn nên đưa giá trị đó vào thông báo. |
data |
Bạn có thể chọn một giá trị mà EMM có thể đọc được. Ví dụ: đặt các giá trị mà quản trị viên có thể chọn để truy vấn trong bảng điều khiển EMM (ví dụ: "thông báo cho tôi nếu dữ liệu battery_warning < 10"). |
createTime |
Thời gian tạo trạng thái ứng dụng trên thiết bị. Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
lastUpdateTime |
Thời gian gần đây nhất trạng thái ứng dụng được cập nhật. Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
NetworkInfo
| Biểu diễn dưới dạng JSON |
|---|
{
"imei": string,
"meid": string,
"wifiMacAddress": string,
"networkOperatorName": string,
"telephonyInfos": [
{
object ( |
| Trường | |
|---|---|
imei |
Số IMEI của thiết bị GSM. Ví dụ: |
meid |
Số MEID của thiết bị CDMA. Ví dụ: |
wifiMacAddress |
Địa chỉ MAC của Wi-Fi trên thiết bị. Ví dụ: |
networkOperatorName |
Tên theo bảng chữ cái của nhà mạng đã đăng ký hiện tại. Ví dụ: Vodafone. |
telephonyInfos[] |
Cung cấp thông tin về điện thoại liên quan đến từng thẻ SIM trên thiết bị. Chỉ được hỗ trợ trên các thiết bị được quản lý hoàn toàn bắt đầu từ cấp độ API 23 của Android. |
TelephonyInfo
| Biểu diễn dưới dạng JSON |
|---|
{ "phoneNumber": string, "carrierName": string, "iccId": string, "activationState": enum ( |
| Trường | |
|---|---|
phoneNumber |
Số điện thoại được liên kết với thẻ SIM này. |
carrierName |
Tên nhà mạng liên kết với thẻ SIM này. |
iccId |
Chỉ có đầu ra. Mã nhận dạng thẻ SIM (ICCID) được liên kết với thẻ SIM này. |
activationState |
Chỉ có đầu ra. Trạng thái kích hoạt của thẻ SIM trên thiết bị. Điều này chỉ áp dụng cho eSIM. Chế độ này được hỗ trợ trên mọi thiết bị có API cấp 35 trở lên. Đây luôn là |
configMode |
Chỉ có đầu ra. Chế độ cấu hình của thẻ SIM trên thiết bị. Điều này chỉ áp dụng cho eSIM. Chế độ này được hỗ trợ trên mọi thiết bị có API cấp 35 trở lên. Đây luôn là |
MemoryInfo
| Biểu diễn dưới dạng JSON |
|---|
{ "totalRam": string, "totalInternalStorage": string } |
| Trường | |
|---|---|
totalRam |
Tổng dung lượng RAM trên thiết bị tính bằng byte. |
totalInternalStorage |
Tổng dung lượng bộ nhớ trong trên thiết bị tính bằng byte. |
MemoryEvent
| Biểu diễn dưới dạng JSON |
|---|
{
"eventType": enum ( |
| Trường | |
|---|---|
eventType |
Loại sự kiện. |
createTime |
Thời gian tạo sự kiện. Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
byteCount |
Số byte trống trong phương tiện hoặc đối với |
PowerManagementEvent
| Biểu diễn dưới dạng JSON |
|---|
{
"eventType": enum ( |
| Trường | |
|---|---|
eventType |
Loại sự kiện. |
createTime |
Thời gian tạo sự kiện. Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
batteryLevel |
Đối với các sự kiện |
HardwareStatus
| Biểu diễn dưới dạng JSON |
|---|
{ "createTime": string, "batteryTemperatures": [ number ], "cpuTemperatures": [ number ], "gpuTemperatures": [ number ], "skinTemperatures": [ number ], "fanSpeeds": [ number ], "cpuUsages": [ number ] } |
| Trường | |
|---|---|
createTime |
Thời gian đo lường. Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: |
batteryTemperatures[] |
Nhiệt độ pin hiện tại (đơn vị là độ C) của từng pin trên thiết bị. |
cpuTemperatures[] |
Nhiệt độ CPU hiện tại theo độ C cho từng CPU trên thiết bị. |
gpuTemperatures[] |
Nhiệt độ hiện tại của GPU (tính bằng độ C) cho từng GPU trên thiết bị. |
skinTemperatures[] |
Nhiệt độ hiện tại trên da của thiết bị tính bằng độ C. |
fanSpeeds[] |
Tốc độ quạt tính bằng số vòng quay mỗi phút cho từng quạt trên thiết bị. Mảng trống có nghĩa là không có quạt hoặc hệ thống không hỗ trợ tốc độ quạt. |
cpuUsages[] |
Mức sử dụng CPU theo tỷ lệ phần trăm cho từng lõi có trên thiết bị. Mức sử dụng là 0 cho mỗi lõi không cắm điện. Mảng trống ngụ ý rằng hệ thống không hỗ trợ mức sử dụng CPU. |
DeviceSettings
| Biểu diễn dưới dạng JSON |
|---|
{
"isDeviceSecure": boolean,
"unknownSourcesEnabled": boolean,
"developmentSettingsEnabled": boolean,
"adbEnabled": boolean,
"isEncrypted": boolean,
"encryptionStatus": enum ( |
| Trường | |
|---|---|
isDeviceSecure |
Thiết bị có được bảo mật bằng mã PIN/mật khẩu hay không. |
unknownSourcesEnabled |
Liệu có bật chế độ cài đặt ứng dụng từ nguồn không xác định hay không. |
developmentSettingsEnabled |
Chế độ nhà phát triển có được bật trên thiết bị hay không. |
adbEnabled |
Liệu ADB có được bật trên thiết bị hay không. |
isEncrypted |
Tính năng mã hoá bộ nhớ có được bật hay không. |
encryptionStatus |
Trạng thái mã hoá từ DevicePolicyManager. |
verifyAppsEnabled |
Xác minh bằng Google Play Protect có được thực thi trên thiết bị hay không. |
Người dùng
| Biểu diễn dưới dạng JSON |
|---|
{ "accountIdentifier": string } |
| Trường | |
|---|---|
accountIdentifier |
Giá trị nhận dạng riêng biệt mà bạn tạo cho người dùng này, chẳng hạn như |
SystemPropertiesEntry
| Biểu diễn dưới dạng JSON |
|---|
{ "key": string, "value": string } |
| Trường | |
|---|---|
key |
|
value |
|
SecurityPosture
| Biểu diễn dưới dạng JSON |
|---|
{ "devicePosture": enum ( |
| Trường | |
|---|---|
devicePosture |
Giá trị trạng thái bảo mật của thiết bị. |
postureDetails[] |
Thông tin bổ sung về trạng thái bảo mật của thiết bị. |
PostureDetail
| Biểu diễn dưới dạng JSON |
|---|
{ "securityRisk": enum ( |
| Trường | |
|---|---|
securityRisk |
Một rủi ro bảo mật cụ thể ảnh hưởng tiêu cực đến trạng thái bảo mật của thiết bị. |
advice[] |
Lời khuyên tương ứng dành cho quản trị viên để giảm thiểu rủi ro bảo mật này và cải thiện trạng thái bảo mật của thiết bị. |
CommonCriteriaModeInfo
| Biểu diễn dưới dạng JSON |
|---|
{ "commonCriteriaModeStatus": enum ( |
| Trường | |
|---|---|
commonCriteriaModeStatus |
Chế độ Tiêu chí chung có được bật hay không. |
policySignatureVerificationStatus |
Chỉ có đầu ra. Trạng thái xác minh chữ ký chính sách. |
PasswordRequirements
| Biểu diễn dưới dạng JSON |
|---|
{ "passwordMinimumLength": integer, "passwordMinimumLetters": integer, "passwordMinimumLowerCase": integer, "passwordMinimumNonLetter": integer, "passwordMinimumNumeric": integer, "passwordMinimumSymbols": integer, "passwordMinimumUpperCase": integer, "passwordQuality": enum ( |
| Trường | |
|---|---|
passwordMinimumLength |
Độ dài tối thiểu được phép của mật khẩu. Giá trị 0 có nghĩa là không có quy định hạn chế. Chỉ được thực thi khi |
passwordMinimumLetters |
Số lượng chữ cái tối thiểu bắt buộc trong mật khẩu. Chỉ được thực thi khi |
passwordMinimumLowerCase |
Số lượng chữ cái viết thường tối thiểu bắt buộc trong mật khẩu. Chỉ được thực thi khi |
passwordMinimumNonLetter |
Số lượng tối thiểu các ký tự không phải chữ cái (chữ số hoặc ký hiệu) cần có trong mật khẩu. Chỉ được thực thi khi |
passwordMinimumNumeric |
Số lượng chữ số tối thiểu bắt buộc trong mật khẩu. Chỉ được thực thi khi |
passwordMinimumSymbols |
Số lượng ký hiệu tối thiểu bắt buộc trong mật khẩu. Chỉ được thực thi khi |
passwordMinimumUpperCase |
Số lượng chữ cái viết hoa tối thiểu bắt buộc trong mật khẩu. Chỉ được thực thi khi |
passwordQuality |
Chất lượng mật khẩu bắt buộc. |
passwordHistoryLength |
Độ dài của nhật ký mật khẩu. Sau khi đặt trường này, người dùng sẽ không thể nhập mật khẩu mới giống với bất kỳ mật khẩu nào trong nhật ký. Giá trị 0 có nghĩa là không có quy định hạn chế. |
maximumFailedPasswordsForWipe |
Số lần nhập sai mật khẩu mở khoá thiết bị trước khi dữ liệu trên thiết bị bị xoá. Giá trị 0 có nghĩa là không có quy định hạn chế. |
passwordExpirationTimeout |
Hết thời gian chờ hết hạn mật khẩu. Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng " |
passwordScope |
Phạm vi áp dụng yêu cầu về mật khẩu. |
requirePasswordUnlock |
Khoảng thời gian sau khi thiết bị hoặc hồ sơ công việc được mở khoá bằng một phương thức xác thực mạnh (mật khẩu, mã PIN, hình mở khoá) mà thiết bị hoặc hồ sơ đó có thể được mở khoá bằng bất kỳ phương thức xác thực nào khác (ví dụ: vân tay, tác nhân tin cậy, khuôn mặt). Sau khi khoảng thời gian đã chỉ định trôi qua, chỉ có thể sử dụng các phương thức xác thực mạnh để mở khoá thiết bị hoặc hồ sơ công việc. |
unifiedLockSettings |
Kiểm soát việc có cho phép sử dụng chế độ khoá hợp nhất cho thiết bị và hồ sơ công việc hay không, trên các thiết bị chạy Android 9 trở lên có hồ sơ công việc. Bạn chỉ có thể đặt chính sách này nếu |
Thời lượng
| Biểu diễn dưới dạng JSON |
|---|
{ "seconds": string, "nanos": integer } |
| Trường | |
|---|---|
seconds |
Số giây có dấu của khoảng thời gian. Giá trị phải nằm trong khoảng từ -315.576.000.000 đến +315.576.000.000. Lưu ý: các giới hạn này được tính từ: 60 giây/phút * 60 phút/giờ * 24 giờ/ngày * 365,25 ngày/năm * 10.000 năm |
nanos |
Phân số có dấu của một giây ở độ phân giải nano giây của khoảng thời gian. Khoảng thời gian dưới một giây được biểu thị bằng trường 0 |
DpcMigrationInfo
| Biểu diễn dưới dạng JSON |
|---|
{ "previousDpc": string, "additionalData": string } |
| Trường | |
|---|---|
previousDpc |
Chỉ có đầu ra. Nếu thiết bị này được di chuyển từ một DPC khác, thì đây là tên gói của thiết bị. Nếu không, thông tin này sẽ không được điền sẵn. |
additionalData |
Chỉ có đầu ra. Nếu thiết bị này được di chuyển từ một DPC khác, thì trường |
DefaultApplicationInfo
| Biểu diễn dưới dạng JSON |
|---|
{ "defaultApplicationType": enum ( |
| Trường | |
|---|---|
defaultApplicationType |
Chỉ có đầu ra. Loại ứng dụng mặc định. |
packageName |
Chỉ có đầu ra. Tên gói của ứng dụng mặc định hiện tại. |
defaultApplicationSettingAttempts[] |
Chỉ có đầu ra. Thông tin chi tiết về các lần thử cài đặt ứng dụng mặc định, theo thứ tự như trong |
DefaultApplicationSettingAttempt
| Biểu diễn dưới dạng JSON |
|---|
{
"packageName": string,
"attemptOutcome": enum ( |
| Trường | |
|---|---|
packageName |
Chỉ có đầu ra. Tên gói của ứng dụng đã thử. |
attemptOutcome |
Chỉ có đầu ra. Kết quả của việc đặt ứng dụng làm ứng dụng mặc định. |
Chú giải công cụ
Gợi ý mang tính phá hoại: ❌ | Gợi ý mang tính luỹ đẳng: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý về thế giới mở: ❌