- Tài nguyên: Thiết bị
- DeviceState
- NonComplianceDetail
- InstallationFailureReason
- SpecificNonComplianceReason
- SpecificNonComplianceContext
- OncWifiContext
- PasswordPoliciesContext
- SoftwareInfo
- SystemUpdateInfo
- UpdateStatus
- HardwareInfo
- Màn hình
- DisplayState
- ApplicationReport
- ApplicationEvent
- ApplicationEventType
- ApplicationSource
- ApplicationState
- KeyedAppState
- Mức độ nghiêm trọng
- UserFacingType
- NetworkInfo
- TelephonyInfo
- MemoryInfo
- MemoryEvent
- MemoryEventType
- PowerManagementEvent
- PowerManagementEventType
- HardwareStatus
- DeviceSettings
- EncryptionStatus
- SecurityPosture
- DevicePosture
- PostureDetail
- SecurityRisk
- CommonCriteriaModeInfo
- CommonCriteriaModeStatus
- PolicySignatureVerificationStatus
- DpcMigrationInfo
- Phương thức
Tài nguyên: Thiết bị
Một thiết bị thuộc sở hữu của một doanh nghiệp. Trừ khi có ghi chú khác, tất cả các trường đều chỉ có thể đọc và enterprises.devices.patch
không thể sửa đổi.
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 |
user |
Tên tài nguyên của người dùng sở hữu thiết bị này ở dạng |
management |
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 chế độ cài đặt chính sách được hỗ trợ. |
state |
Trạng thái sẽ áp dụng cho thiết bị. Bạn có thể sửa đổi trường này theo yêu cầu bản vá. Lưu ý rằng khi gọi |
applied |
Trạng thái hiện được áp dụng cho thiết bị. |
policy |
Liệu thiết bị có tuân thủ chính sách của thiết bị hay không. |
non |
Thông tin chi tiết về chế độ cài đặt chính sách mà thiết bị không tuân thủ. |
enrollment |
Thời gian đăng ký thiết bị. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
last |
Lần gần đây nhất thiết bị gửi báo cáo trạng thái. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: |
lastPolicyComplianceReportTime |
Không dùng nữa. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: |
last |
Lần gần đây nhất thiết bị tìm nạp chính sách. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
policy |
Tên của chính sách áp dụng cho thiết bị, ở dạng |
applied |
Tên của chính sách hiện được áp dụng cho thiết bị. |
applied |
Phiên bản của chính sách hiện được áp dụng cho thiết bị. |
api |
Cấp độ API của phiên bản nền tảng Android chạy trên thiết bị. |
enrollment |
Nếu thiết bị được đăng ký bằng mã thông báo đăng ký có cung cấp dữ liệu bổ sung, thì trường này sẽ chứa dữ liệu đó. |
enrollment |
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. |
disabled |
Nếu trạng thái thiết bị là |
software |
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 |
hardware |
Thông tin chi tiết về phần cứng 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 |
application |
Báo cáo cho các ứng dụng đã cài đặt trên thiết bị. Thông tin này chỉ có sẵn khi |
previous |
Nếu cùng một thiết bị thực đã được đăng ký nhiều lần, thì 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 duy nhất để xác định xem liệu thiết bị thực tế đó đã được đăng ký trước đó hay chưa. Các tên được sắp xếp theo thứ tự thời gian. |
network |
Thông tin về mạng của thiết bị. Thông tin này chỉ có sẵn nếu |
memory |
Thông tin bộ nhớ: chứa thông tin về bộ nhớ và bộ nhớ lưu trữ của thiết bị. |
memory |
Các sự kiện liên quan đến việc đo lường bộ nhớ và bộ nhớ theo thứ 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á. |
power |
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 |
hardware |
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 |
device |
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ị. |
system |
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 |
security |
Giá trị tư thế 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ý. |
common |
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 |
applied |
Các yêu cầu về mật khẩu hiện áp dụng cho thiết bị.
|
dpc |
Chỉ có đầu ra. Thông tin liên quan đến việc thiết bị này có được di chuyển từ việc 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. |
DeviceState
Các trạng thái có thể áp dụng cho một thiết bị.
Enum | |
---|---|
DEVICE_STATE_UNSPECIFIED |
Bạn không được phép sử dụng giá trị này. |
ACTIVE |
Thiết bị đang hoạt động. |
DISABLED |
Thiết bị bị tắt. |
DELETED |
Thiết bị đã bị xoá. Trạng thái này không bao giờ được lệnh gọi API trả về, nhưng được dùng trong báo cáo trạng thái cuối cùng khi thiết bị xác nhận việc xoá. Nếu thiết bị bị xoá thông qua lệnh gọi API, trạng thái này sẽ được phát hành lên Pub/Sub. Nếu người dùng xoá hồ sơ công việc hoặc đặt lại thiết bị, thì máy chủ sẽ vẫn không xác định được trạng thái thiết bị. |
PROVISIONING |
Thiết bị đang được cấp phép. Các thiết bị mới đăng ký sẽ ở trạng thái này cho đến khi có chính sách được áp dụng. |
LOST |
Thiết bị bị mất. Trạng thái này chỉ có thể áp dụng trên các thiết bị thuộc sở hữu của tổ chức. |
PREPARING_FOR_MIGRATION |
Thiết bị đang chuẩn bị di chuyển sang Android Management API. Bạn không cần làm gì thêm để quá trình di chuyển tiếp tục. |
DEACTIVATED_BY_DEVICE_FINANCE |
Đây là thiết bị mua trả góp đã bị "khoá" bởi đại lý tài chính. Điều này có nghĩa là một số chế độ cài đặt chính sách đã được áp dụng để hạn chế chức năng của thiết bị cho đến khi đại lý tài chính "mở khoá" thiết bị. Thiết bị sẽ tiếp tục áp dụng các chế độ cài đặt chính sách ngoại trừ những chế độ cài đặt bị nhân viên hỗ trợ tài chính ghi đè. Khi thiết bị "đã khoá", trạng thái sẽ được báo cáo trong appliedState dưới dạng DEACTIVATED_BY_DEVICE_FINANCE . |
NonComplianceDetail
Cung cấp thông tin chi tiết về việc không tuân thủ chế độ cài đặt chính sách.
Biểu diễn dưới dạng JSON |
---|
{ "settingName": string, "nonComplianceReason": enum ( |
Trường | |
---|---|
setting |
Tên của chế độ cài đặt chính sách. Đây là tên trường JSON của trường |
non |
Lý do thiết bị không tuân thủ chế độ cài đặt. |
package |
Tên gói cho biết ứng dụng nào không tuân thủ (nếu có). |
field |
Đố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 giống như cách tham chiếu trường JSON của chính sách trong JavaScript, tức là: 1) Đối với các trường có kiểu đối tượng, tên trường theo sau là một dấu chấm, sau đó là tên trường phụ. 2) Đối với các trường có dạng mảng, tên trường đứng trước chỉ mục mảng được đặt trong ngoặc đơn. Ví dụ: để chỉ ra sự cố với trường |
current |
Nếu không thể áp dụng 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ị. |
installation |
Nếu bạn đặt |
specific |
Lý do cụ thể theo chính sách khiến thiết bị không tuân thủ chế độ cài đặt. |
specific |
Ngữ cảnh bổ sung cho |
InstallationFailureReason
Lý do có thể khiến việc cài đặt ứng dụng không thành công.
Enum | |
---|---|
INSTALLATION_FAILURE_REASON_UNSPECIFIED |
Bạn không được phép sử dụng giá trị này. |
INSTALLATION_FAILURE_REASON_UNKNOWN |
Một điều kiện không xác định đang ngăn không cho ứng dụng được cài đặt. Một số lý do có thể xảy ra là thiết bị không có đủ bộ nhớ, kết nối mạng của thiết bị không đáng tin cậy hoặc quá trình cài đặt mất nhiều thời gian hơn dự kiến. Quá trình cài đặt sẽ tự động thử lại. |
IN_PROGRESS |
Quá trình cài đặt vẫn đang diễn ra. |
NOT_FOUND |
Không tìm thấy ứng dụng này trong Play. |
NOT_COMPATIBLE_WITH_DEVICE |
Ứng dụng không tương thích với thiết bị. |
NOT_APPROVED |
Quản trị viên chưa phê duyệt ứng dụng. |
PERMISSIONS_NOT_ACCEPTED |
Ứng dụng có các quyền mới mà quản trị viên chưa chấp nhận. |
NOT_AVAILABLE_IN_COUNTRY |
Ứng dụng không có mặt tại quốc gia của người dùng. |
NO_LICENSES_REMAINING |
Không có giấy phép nào để chỉ định cho người dùng này. |
NOT_ENROLLED |
Doanh nghiệp không còn đăng ký với Managed Google Play hoặc quản trị viên chưa chấp nhận Điều khoản dịch vụ mới nhất của Managed Google Play. |
USER_INVALID |
Người dùng không còn hợp lệ. Người dùng này có thể đã bị xoá hoặc bị vô hiệu hoá. |
NETWORK_ERROR_UNRELIABLE_CONNECTION |
Một lỗi mạng trên thiết bị của người dùng đã khiến quá trình cài đặt không thành công. Điều này thường xảy ra khi kết nối Internet của thiết bị bị giảm chất lượng, không hoạt động hoặc có vấn đề về cấu hình mạng. Vui lòng đảm bảo rằng thiết bị có thể kết nối Internet đầy đủ trên một mạng đáp ứng |
INSUFFICIENT_STORAGE |
Thiết bị của người dùng không có đủ dung lượng lưu trữ để cài đặt ứng dụng. Bạn có thể giải quyết vấn đề này bằng cách giải phóng dung lượng lưu trữ trên thiết bị. Quá trình cài đặt hoặc cập nhật ứng dụng sẽ tự động tiếp tục sau khi thiết bị có đủ dung lượng lưu trữ. |
SpecificNonComplianceReason
Thông tin chi tiết khác về lý do một thiết bị có thể không tuân thủ chế độ cài đặt chính sách. Sau này, bạn có thể thêm giá trị mới vào enum.
Enum | |
---|---|
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED |
Chưa chỉ định lý do cụ thể về việc không tuân thủ. Các trường trong chưa được đặt. |
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED |
Người dùng cần xác nhận thông tin đăng nhập bằng cách nhập phương thức khoá màn hình. Các trường trong chưa được đặt. được đặt thành . |
PASSWORD_POLICIES_PASSWORD_EXPIRED |
Mật khẩu của thiết bị hoặc hồ sơ đã hết hạn. đã được đặt. được đặt thành . |
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT |
Mật khẩu thiết bị không đáp ứng các yêu cầu về mật khẩu. đã được đặt. được đặt thành . |
ONC_WIFI_INVALID_VALUE |
Có một giá trị không chính xác trong cấu hình Wi-Fi của ONC. chỉ định giá trị trường nào không chính xác. đã được đặt. được đặt thành . |
ONC_WIFI_API_LEVEL |
Chế độ cài đặt Wi-Fi ONC không được hỗ trợ ở cấp độ API của phiên bản Android đang chạy trên thiết bị. chỉ định giá trị trường nào không được hỗ trợ. đã được đặt. được đặt thành . |
ONC_WIFI_INVALID_ENTERPRISE_CONFIG |
Mạng Wi-Fi doanh nghiệp thiếu CA gốc hoặc tên miền. được đặt thành . |
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK |
Người dùng cần xoá mạng Wi-Fi đã định cấu hình theo cách thủ công. Điều này chỉ áp dụng cho hồ sơ công việc trên thiết bị thuộc sở hữu cá nhân. được đặt thành . |
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY |
Bí danh cặp khoá được chỉ định thông qua trường ClientCertKeyPairAlias trong không tương ứng với khoá hiện đã cài đặt trên thiết bị. được đặt thành . |
SpecificNonComplianceContext
Ngữ cảnh bổ sung cho
.SpecificNonComplianceReason
Biểu diễn dưới dạng JSON |
---|
{ "oncWifiContext": { object ( |
Trường | |
---|---|
onc |
Bối cảnh bổ sung về việc không tuân thủ liên quan đến cấu hình Wi-Fi. Xem |
password |
Bối cảnh bổ sung về việc không tuân thủ liên quan đến chính sách về mật khẩu. Hãy xem |
OncWifiContext
Bối cảnh bổ sung về việc không tuân thủ liên quan đến cấu hình Wi-Fi.
Biểu diễn dưới dạng JSON |
---|
{ "wifiGuid": string } |
Trường | |
---|---|
wifi |
GUID của cấu hình Wi-Fi không tuân thủ. |
PasswordPoliciesContext
Thông tin bổ sung về hành vi không tuân thủ liên quan đến chính sách về mật khẩu.
Biểu diễn dưới dạng JSON |
---|
{
"passwordPolicyScope": enum ( |
Trường | |
---|---|
password |
Phạm vi của mật khẩu không tuân thủ. |
SoftwareInfo
Thông tin về phần mềm trên thiết bị.
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 | |
---|---|
android |
Chuỗi phiên bản Android hiển thị cho người dùng. Ví dụ: |
android |
Mã phiên bản ứng dụng Android Device Policy. |
android |
Phiên bản ứng dụng Android Device Policy hiển thị cho người dùng. |
android |
Chuỗi mã bản dựng Android dùng để hiển thị cho người dùng. Ví dụ: |
device |
Phiên bản kernel, ví dụ: |
bootloader |
Số phiên bản trình tải khởi động của hệ thống, ví dụ: |
android |
Thời gian tạo bản dựng. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: |
security |
Cấp bản vá bảo mật, ví dụ: |
primary |
Mã ngôn ngữ IETF BCP 47 dành cho ngôn ngữ chính trên thiết bị. |
device |
Hàm băm SHA-256 của |
system |
Thông tin về bản cập nhật hệ thống có thể đang chờ xử lý. |
SystemUpdateInfo
Thông tin về bản cập nhật hệ thống có thể đang chờ xử lý.
Biểu diễn dưới dạng JSON |
---|
{
"updateStatus": enum ( |
Trường | |
---|---|
update |
Trạng thái của bản cập nhật: bản cập nhật có tồn tại hay không và thuộc loại nào. |
update |
Thời điểm phát hành bản cập nhật lần đầu. 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à Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: |
UpdateStatus
Trạng thái của bản cập nhật: liệu có bản cập nhật hay không và bản cập nhật đó thuộc loại nào.
Enum | |
---|---|
UPDATE_STATUS_UNKNOWN |
Không biết có bản cập nhật hệ thống đang chờ xử lý hay không. Ví dụ: điều này xảy ra khi cấp độ API của thiết bị thấp hơn 26 hoặc nếu phiên bản Chính sách thiết bị Android đã lỗi thời. |
UP_TO_DATE |
Không có bản cập nhật hệ thống nào đang chờ xử lý trên thiết bị. |
UNKNOWN_UPDATE_AVAILABLE |
Có một bản cập nhật hệ thống đang chờ xử lý nhưng không xác định được loại bản cập nhật. |
SECURITY_UPDATE_AVAILABLE |
Có một bản cập nhật bảo mật đang chờ xử lý. |
OS_UPDATE_AVAILABLE |
Có một bản cập nhật hệ điều hành đang chờ xử lý. |
HardwareInfo
Thông tin về phần cứng thiết bị. Các trường liên quan đến ngưỡng nhiệt độ chỉ có sẵn nếu hardwareStatusEnabled
là true trong chính sách của thiết bị.
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 } |
Trường | |
---|---|
brand |
Thương hiệu của thiết bị. Ví dụ: |
hardware |
Tên phần cứng. Ví dụ: |
device |
Phiên bản băng tần cơ sở. Ví dụ: |
manufacturer |
Nhà sản xuất. Ví dụ: |
serial |
Số sê-ri của thiết bị. |
model |
Mẫu thiết bị. Ví dụ: |
battery |
Ngưỡng nhiệt độ tắt pin tính bằng độ C cho từng pin trên thiết bị. |
battery |
Ngưỡng nhiệt độ điều tiết pin theo độ C cho từng pin trên thiết bị. |
cpu |
Ngưỡng nhiệt độ tắt CPU tính bằng độ C cho từng CPU trên thiết bị. |
cpu |
Ngưỡng nhiệt độ điều tiết CPU theo độ C cho mỗi CPU trên thiết bị. |
gpu |
Ngưỡng nhiệt độ tắt GPU tính bằng độ C cho mỗi GPU trên thiết bị. |
gpu |
Ngưỡng nhiệt độ điều tiết GPU theo độ C cho mỗi GPU trên thiết bị. |
skin |
Ngưỡng nhiệt độ tắt giao diện thiết bị tính bằng độ C. |
skin |
Ngưỡng nhiệt độ điều tiết trên da thiết bị tính bằng độ C. |
enterprise |
Chỉ có đầu ra. Mã nhận dạng giúp xác định riêng biệt 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 đăng ký với cùng một tổ chức, mã nhận dạng này vẫn tồn tại trong các lần thiết lập và thậm chí là khi đặt lại về trạng thái ban đầu. Giấy tờ tuỳ thân này có trên các thiết bị do cá nhân sở hữu có hồ sơ công việc trên thiết bị chạy Android 12 trở lên. |
Màn hình
Thông tin màn hình thiết bị.
Biểu diễn dưới dạng JSON |
---|
{
"name": string,
"displayId": integer,
"refreshRate": integer,
"state": enum ( |
Trường | |
---|---|
name |
Tên màn hình. |
display |
Mã nhận dạng hiển thị duy nhất. |
refresh |
Tốc độ làm mới của màn hình tính bằng 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. |
DisplayState
Trạng thái của màn hình.
Enum | |
---|---|
DISPLAY_STATE_UNSPECIFIED |
Bạn không được phép sử dụng giá trị này. |
OFF |
Màn hình đang tắt. |
ON |
Màn hình đang bật. |
DOZE |
Màn hình đang ở trạng thái ngủ ở trạng thái tiết kiệm pin |
SUSPENDED |
Màn hình đang ngủ ở trạng thái tạm ngưng pin. |
ApplicationReport
Thông tin được báo cáo về một ứng dụng đã cài đặt.
Biểu diễn dưới dạng JSON |
---|
{ "packageName": string, "versionName": string, "versionCode": integer, "events": [ { object ( |
Trường | |
---|---|
package |
Tên gói của ứng dụng. |
version |
Phiên bản ứng dụng hiển thị cho người dùng. |
version |
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 phiên bản khác hay không. |
events[] |
Danh sách các sự kiện trong ứng dụng đã xảy ra trong 30 giờ qua. |
display |
Tên hiển thị của ứng dụng. |
package |
Hàm băm SHA-256 của tệp APK của ứng dụng. Hàm này có thể dùng để xác minh ứ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 hai chữ số. |
signing |
Hàm băm SHA-1 của mỗi |
installer |
Tên gói của ứng dụng đã cài đặt ứng dụng này. |
application |
Nguồn của gói. |
state |
Trạng thái ứng dụng. |
keyed |
Danh sách các trạng thái được khoá của ứng dụng được ứng dụng báo cáo. |
user |
Liệu ứng dụng có dành cho người dùng hay không. |
ApplicationEvent
Một sự kiện liên quan đến ứng dụng.
Biểu diễn dưới dạng JSON |
---|
{
"eventType": enum ( |
Trường | |
---|---|
event |
Loại sự kiện trong ứng dụng. |
create |
Thời gian tạo sự kiện. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: |
ApplicationEventType
Một loại sự kiện liên quan đến ứng dụng.
Enum | |
---|---|
APPLICATION_EVENT_TYPE_UNSPECIFIED |
Bạn không được phép sử dụng giá trị này. |
INSTALLED |
Đã cài đặt ứng dụng này. |
CHANGED |
Ứng dụng đã thay đổi, chẳng hạn như một thành phần đã được bật hoặc tắt. |
DATA_CLEARED |
Dữ liệu ứng dụng đã bị xoá. |
REMOVED |
Ứng dụng đã bị xoá. |
REPLACED |
Phiên bản mới của ứng dụng đã được cài đặt, thay thế phiên bản cũ. |
RESTARTED |
Ứng dụng đã được khởi động lại. |
PINNED |
Ứng dụng đã được ghim vào nền trước. |
UNPINNED |
Ứng dụng đã bị bỏ ghim. |
ApplicationSource
Nguồn cung cấp ứng dụng.
Enum | |
---|---|
APPLICATION_SOURCE_UNSPECIFIED |
Ứng dụng được tải không qua cửa hàng ứng dụng từ một nguồn không xác định. |
SYSTEM_APP_FACTORY_VERSION |
Đây là ứng dụng hệ thống trong hình ảnh gốc của thiết bị. |
SYSTEM_APP_UPDATED_VERSION |
Đây là ứng dụng hệ thống đã cập nhật. |
INSTALLED_FROM_PLAY_STORE |
Ứng dụng được cài đặt qua Cửa hàng Google Play. |
ApplicationState
Trạng thái cài đặt hiện tại.
Enum | |
---|---|
APPLICATION_STATE_UNSPECIFIED |
Trạng thái ứng dụng chưa được chỉ định |
REMOVED |
Đã xoá ứng dụng khỏi thiết bị |
INSTALLED |
Ứng dụng được cài đặt trên thiết bị |
KeyedAppState
Trạng thái quan trọng của ứng dụng do ứng dụng báo cáo.
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 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 |
Một chuỗi thông báo dạng tự do (không bắt buộc) để giải thích trạng thái ứ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ý), bạn phải đưa giá trị đó vào thông báo. |
data |
Không bắt buộc: Một giá trị mà máy có thể đọc được để EMM đọ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"). |
create |
Thời gian tạo của trạng thái ứng dụng trên thiết bị. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
last |
Thời gian gần đây nhất trạng thái ứng dụng được cập nhật. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: |
Mức độ nghiêm trọng
Mức độ nghiêm trọng của trạng thái ứng dụng.
Enum | |
---|---|
SEVERITY_UNSPECIFIED |
Mức độ nghiêm trọng không được chỉ định. |
INFO |
Mức độ nghiêm trọng của thông tin. |
ERROR |
Mức độ nghiêm trọng của lỗi. Bạn chỉ nên đặt giá trị này cho các điều kiện lỗi thực sự mà tổ chức quản lý cần khắc phục. |
UserFacingType
Liệu ứng dụng có dành cho người dùng hay không.
Enum | |
---|---|
USER_FACING_TYPE_UNSPECIFIED |
Loại giao diện người dùng ứng dụng chưa được chỉ định. |
NOT_USER_FACING |
Ứng dụng không dành cho người dùng. |
USER_FACING |
Ứng dụng dành cho người dùng. |
NetworkInfo
Thông tin về mạng của thiết bị.
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ụ: |
wifi |
Địa chỉ MAC của Wi-Fi trên thiết bị. Ví dụ: |
networkOperatorName |
Tên theo thứ tự bảng chữ cái của nhà điều hành đã đăng ký hiện tại. Ví dụ: Vodafone. |
telephony |
Cung cấp thông tin điện thoại liên kết với 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 kể từ API Android cấp 23. |
TelephonyInfo
Thông tin điện thoại liên kết với một thẻ SIM cụ thể trên thiết bị. Chỉ được hỗ trợ trên các thiết bị được quản lý đầy đủ bắt đầu từ Android API cấp 23.
Biểu diễn dưới dạng JSON |
---|
{ "phoneNumber": string, "carrierName": string, "iccId": string } |
Trường | |
---|---|
phone |
Số điện thoại liên kết với thẻ SIM này. |
carrier |
Tên nhà mạng liên kết với thẻ SIM này. |
icc |
Chỉ có đầu ra. ICCID liên kết với thẻ SIM này. |
MemoryInfo
Thông tin về bộ nhớ và dung lượng lưu trữ của thiết bị.
Biểu diễn dưới dạng JSON |
---|
{ "totalRam": string, "totalInternalStorage": string } |
Trường | |
---|---|
total |
Tổng dung lượng RAM trên thiết bị tính bằng byte. |
total |
Tổng dung lượng bộ nhớ trong trên thiết bị tính bằng byte. |
MemoryEvent
Một sự kiện liên quan đến kết quả đo lường bộ nhớ và dung lượng lưu trữ.
Để phân biệt giữa sự kiện mới và cũ, bạn nên sử dụng trường
.createTime
Biểu diễn dưới dạng JSON |
---|
{
"eventType": enum ( |
Trường | |
---|---|
event |
Loại sự kiện. |
create |
Thời gian tạo sự kiện. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: |
byte |
Số byte trống trong phương tiện hoặc đối với |
MemoryEventType
Loại sự kiện.
Enum | |
---|---|
MEMORY_EVENT_TYPE_UNSPECIFIED |
Không xác định. Không có sự kiện nào thuộc loại này. |
RAM_MEASURED |
Đo lường dung lượng trống trong RAM. |
INTERNAL_STORAGE_MEASURED |
Đo lường dung lượng trống trong bộ nhớ trong. |
EXTERNAL_STORAGE_DETECTED |
Đã phát hiện một phương tiện bộ nhớ ngoài mới. Số byte được báo cáo là tổng dung lượng của phương tiện lưu trữ. |
EXTERNAL_STORAGE_REMOVED |
Đã xoá một phương tiện bộ nhớ ngoài. Số byte được báo cáo bằng 0. |
EXTERNAL_STORAGE_MEASURED |
Đo lường dung lượng trống trong phương tiện bộ nhớ ngoài. |
PowerManagementEvent
Một sự kiện quản lý nguồn điện.
Biểu diễn dưới dạng JSON |
---|
{
"eventType": enum ( |
Trường | |
---|---|
event |
Loại sự kiện. |
create |
Thời gian tạo sự kiện. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: |
battery |
Đối với các sự kiện |
PowerManagementEventType
Loại sự kiện.
Enum | |
---|---|
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED |
Không xác định. Không có sự kiện nào có loại này. |
BATTERY_LEVEL_COLLECTED |
Đã đo mức pin. |
POWER_CONNECTED |
Thiết bị đã bắt đầu sạc. |
POWER_DISCONNECTED |
Thiết bị đã ngừng sạc. |
BATTERY_LOW |
Thiết bị đã chuyển sang chế độ tiết kiệm pin. |
BATTERY_OKAY |
Thiết bị đã thoát khỏi chế độ tiết kiệm pin. |
BOOT_COMPLETED |
Thiết bị đã khởi động. |
SHUTDOWN |
Thiết bị đã tắt. |
HardwareStatus
Trạng thái phần cứng. Bạn có thể so sánh nhiệt độ với ngưỡng nhiệt độ có trong hardwareInfo
để xác định tình trạng phần cứng.
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 | |
---|---|
create |
Thời gian thực hiện phép đo. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, có độ phân giải nano giây và tối đa 9 chữ số thập phân. Ví dụ: |
battery |
Nhiệt độ pin hiện tại tính theo độ C cho mỗi pin trên thiết bị. |
cpu |
Nhiệt độ CPU hiện tại tính bằng độ C của từng CPU trên thiết bị. |
gpu |
Nhiệt độ GPU hiện tại tính theo độ C cho mỗi GPU trên thiết bị. |
skin |
Nhiệt độ trên da của thiết bị hiện tại tính theo độ C. |
fan |
Tốc độ quạt (tính bằng RPM) của mỗi quạt trên thiết bị. Mảng trống có nghĩa là không có quạt hoặc tốc độ quạt không được hỗ trợ trên hệ thống. |
cpu |
Mức sử dụng CPU theo tỷ lệ phần trăm cho mỗi lõi có trên thiết bị. Mức sử dụng là 0 cho mỗi lõi đã rút phích cắm. Mảng trống có nghĩa là hệ thống không hỗ trợ mức sử dụng CPU. |
DeviceSettings
Thông tin về các chế độ cài đặt thiết bị liên quan đến bảo mật trên thiết bị.
Biểu diễn dưới dạng JSON |
---|
{
"isDeviceSecure": boolean,
"unknownSourcesEnabled": boolean,
"developmentSettingsEnabled": boolean,
"adbEnabled": boolean,
"isEncrypted": boolean,
"encryptionStatus": enum ( |
Trường | |
---|---|
is |
Liệu thiết bị có được bảo mật bằng mã PIN/mật khẩu hay không. |
unknown |
Liệu chế độ cài đặt ứng dụng từ các nguồn không xác định có được bật hay không. |
development |
Liệu chế độ nhà phát triển có được bật trên thiết bị hay không. |
adb |
Liệu ADB có được bật trên thiết bị hay không. |
is |
Liệu tính năng mã hoá bộ nhớ có được bật hay không. |
encryption |
Trạng thái mã hoá từ DevicePolicyManager. |
verify |
Liệu quy trình xác minh của Google Play Protect có được thực thi trên thiết bị hay không. |
EncryptionStatus
Trạng thái mã hoá của thiết bị.
Enum | |
---|---|
ENCRYPTION_STATUS_UNSPECIFIED |
Không xác định. Không thiết bị nào được có loại này. |
UNSUPPORTED |
Thiết bị không hỗ trợ tính năng mã hoá. |
INACTIVE |
Thiết bị hỗ trợ tính năng mã hoá nhưng hiện không hoạt động. |
ACTIVATING |
Tính năng mã hoá hiện chưa hoạt động nhưng đang được kích hoạt. |
ACTIVE |
Tính năng mã hoá đang hoạt động. |
ACTIVE_DEFAULT_KEY |
Tính năng mã hoá đang hoạt động nhưng người dùng chưa đặt khoá mã hoá. |
ACTIVE_PER_USER |
Tính năng mã hoá đang hoạt động và khoá mã hoá được liên kết với hồ sơ người dùng. |
SecurityPosture
Vị trí bảo mật của thiết bị, được xác định theo trạng thái thiết bị hiện tại và các chính sách được áp dụng.
Biểu diễn dưới dạng JSON |
---|
{ "devicePosture": enum ( |
Trường | |
---|---|
device |
Giá trị trạng thái bảo mật của thiết bị. |
posture |
Thông tin bổ sung về trạng thái bảo mật của thiết bị. |
DevicePosture
Các giá trị trạng thái bảo mật có thể có của một thiết bị đang được quản lý.
Enum | |
---|---|
POSTURE_UNSPECIFIED |
Không xác định. Không có thông tin chi tiết về tư thế cho giá trị tư thế này. |
SECURE |
Thiết bị này an toàn. |
AT_RISK |
Thiết bị này có thể dễ bị các tác nhân độc hại tấn công hơn nên không nên dùng để lưu trữ dữ liệu của công ty. |
POTENTIALLY_COMPROMISED |
Thiết bị này có thể đã bị xâm phạm và các bên không được uỷ quyền có thể truy cập vào dữ liệu của công ty. |
PostureDetail
Thông tin bổ sung về trạng thái bảo mật của thiết bị.
Biểu diễn dưới dạng JSON |
---|
{ "securityRisk": enum ( |
Trường | |
---|---|
security |
Một rủi ro bảo mật cụ thể ảnh hưởng tiêu cực đến tình trạng bảo mật của thiết bị. |
advice[] |
Đề xuất 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ị. |
SecurityRisk
Rủi ro khiến thiết bị không ở trạng thái an toàn nhất.
Enum | |
---|---|
SECURITY_RISK_UNSPECIFIED |
Không xác định. |
UNKNOWN_OS |
API Tính toàn vẹn của Play phát hiện thấy thiết bị đang chạy một hệ điều hành không xác định (quy trình kiểm tra basicIntegrity thành công nhưng ctsProfileMatch không thành công). |
COMPROMISED_OS |
API Tính toàn vẹn của Play phát hiện thiết bị đang chạy một hệ điều hành bị xâm phạm (không kiểm tra được basicIntegrity). |
HARDWARE_BACKED_EVALUATION_FAILED |
API Tính toàn vẹn của Play sẽ phát hiện thiết bị không có sự đảm bảo chắc chắn về tính toàn vẹn của hệ thống nếu nhãn MEETS_STRONG_INTEGRITY không xuất hiện trong trường tính toàn vẹn của thiết bị. |
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ỉ xem được nếu statusReportingSettings.commonCriteriaModeEnabled
là true
trong chính sách của thiết bị.
Biểu diễn dưới dạng JSON |
---|
{ "commonCriteriaModeStatus": enum ( |
Trường | |
---|---|
common |
Liệu Chế độ tiêu chí chung có được bật hay không. |
policy |
Chỉ có đầu ra. Trạng thái xác minh chữ ký chính sách. |
CommonCriteriaModeStatus
Liệu Chế độ Tiêu chí chung có được bật hay không.
Enum | |
---|---|
COMMON_CRITERIA_MODE_STATUS_UNKNOWN |
Trạng thái không xác định. |
COMMON_CRITERIA_MODE_DISABLED |
Chế độ Tiêu chí chung hiện đang tắt. |
COMMON_CRITERIA_MODE_ENABLED |
Chế độ Tiêu chí chung hiện đang bật. |
PolicySignatureVerificationStatus
Trạng thái xác minh chữ ký chính sách.
Enum | |
---|---|
POLICY_SIGNATURE_VERIFICATION_STATUS_UNSPECIFIED |
Không xác định. Trạng thái xác minh chưa được báo cáo. Giá trị này chỉ được đặt nếu là false. |
POLICY_SIGNATURE_VERIFICATION_DISABLED |
Tính năng xác minh chữ ký chính sách bị tắt trên thiết bị vì được đặt thành false. |
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED |
Xác minh chữ ký chính sách thành công. |
POLICY_SIGNATURE_VERIFICATION_NOT_SUPPORTED |
Không hỗ trợ xác minh chữ ký chính sách. Ví dụ: do thiết bị đã được đăng ký với một phiên bản CloudDPC không hỗ trợ xác minh chữ ký chính sách. |
POLICY_SIGNATURE_VERIFICATION_FAILED |
Không xác minh được chữ ký chính sách. Chính sách chưa được áp dụng. |
DpcMigrationInfo
Thông tin liên quan đến việc thiết bị này có được di chuyển từ việc 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.
Biểu diễn dưới dạng JSON |
---|
{ "previousDpc": string, "additionalData": string } |
Trường | |
---|---|
previous |
Chỉ có đầu ra. Nếu thiết bị này được di chuyển từ một DPC khác, thì đây sẽ là tên gói của thiết bị đó. Nếu không, giá trị này sẽ không được điền. |
additional |
Chỉ có đầu ra. Nếu thiết bị này được di chuyển từ một DPC khác, thì trường |
Phương thức |
|
---|---|
|
Xoá một thiết bị. |
|
Lấy một thiết bị. |
|
Ra lệnh cho một thiết bị. |
|
Liệt kê các thiết bị cho một doanh nghiệp cụ thể. |
|
Cập nhật thiết bị. |