- 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
- Tính nghiêm trọng
- UserFacingType
- NetworkInfo
- TelephonyInfo
- MemoryInfo
- MemoryEvent
- MemoryEventType
- PowerManagementEvent
- PowerManagementEventType
- HardwareStatus
- DeviceSettings
- EncryptionStatus
- SecurityPosture
- DevicePosture
- PostureDetail
- SecurityRisk
- CommonCriteriaModeInfo
- CommonCriteriaModeStatus
- 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ừ phi có ghi chú khác, tất cả các trường đều ở chế độ chỉ đọc và không thể sửa đổi bằng enterprises.devices.patch
.
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ý Android Device Policy sử 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ẽ được á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 |
appliedState |
Trạng thái hiện đang áp dụng cho thiết bị. |
policyCompliant |
Liệu 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ề những chế độ cài đặt chính sách mà thiết bị chưa tuân thủ. |
enrollmentTime |
Thời gian đăng ký thiết bị. Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: |
lastStatusReportTime |
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 theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: |
lastPolicyComplianceReportTime |
Không dùng nữa. Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: |
lastPolicySyncTime |
Lần gần đây nhất thiết bị tìm nạp chính sách. Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: |
policyName |
Tên của chính sách áp dụng cho thiết bị, ở dạng |
appliedPolicyName |
Tên của chính sách hiện được áp dụng cho thiết bị. |
appliedPolicyVersion |
Phiên bản của chính sách hiện được áp dụng cho thiết bị. |
apiLevel |
Cấp độ API của phiên bản nền tảng Android 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ó cung cấp dữ liệu bổ sung, 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 trên thiết bị. Thông tin này chỉ có nếu |
hardwareInfo |
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ó nếu |
applicationReports[] |
Báo cáo về các ứng dụng được 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 các tên trước đó của thiết bị đó. Số sê-ri được dùng làm giá trị nhận dạng duy nhất để xác định xem 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. |
networkInfo |
Thông tin về mạng của thiết bị. Thông tin này chỉ có nếu |
memoryInfo |
Thông tin bộ nhớ: chứa thông tin về bộ nhớ và dung lượng lưu trữ của thiết bị. |
memoryEvents[] |
Các sự kiện liên quan đến bộ nhớ và các phép đo bộ nhớ theo trình tự thời gian. Thông tin này chỉ có nếu Các sự kiện sẽ được lưu giữ 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ó nếu |
hardwareStatusSamples[] |
Mẫu trạng thái phần cứng theo thứ tự thời gian. Thông tin này chỉ có nếu |
deviceSettings |
Thông tin về chế độ cài đặt thiết bị. Thông tin này chỉ có 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ó 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 độ an toàn 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 về đánh giá bảo mật công nghệ thông tin (CC). Thông tin này chỉ xuất hiện nếu |
appliedPasswordPolicies[] |
Các yêu cầu về mật khẩu hiện áp dụng cho thiết bị.
|
dpcMigrationInfo |
Chỉ có đầu ra. Thông tin liên quan đến việc liệu thiết bị này có thuộc sự quản lý của một Trình kiểm soát chính sách thiết bị (DPC) khác 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 |
Giá trị này không được phép. |
ACTIVE |
Thiết bị đang hoạt động. |
DISABLED |
Thiết bị đã bị tắt. |
DELETED |
Đã xoá thiết bị này. 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 yêu cầu 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ị này đang được cấp phép. Những thiết bị mới đăng ký sẽ ở trạng thái này cho đến khi được áp dụng chính sách. |
LOST |
Thiết bị bị mất. Trạng thái này chỉ có trên các thiết bị do tổ chức sở hữu. |
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 để tiếp tục quá trình di chuyển. |
DEACTIVATED_BY_DEVICE_FINANCE |
Đây là thiết bị hỗ trợ tài chính đã bị "khoá" thông qua công ty tài chính. Điều này có nghĩa là một số chế độ cài đặt chính sách nhất định đã được áp dụng, làm hạn chế chức năng của thiết bị cho đến khi thiết bị được "mở khoá" thông qua công ty tài chính. 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ị bị "khoá", trạng thái được báo cáo trong appliedState là DEACTIVATED_BY_DEVICE_FINANCE . |
NonComplianceDetail
Cung cấp thông tin chi tiết về việc không tuân thủ một chế độ cài đặt chính sách.
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 trường |
nonComplianceReason |
Lý do khiến 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 chế độ cài đặt có các trường lồng nhau, nếu một trường lồng nhau cụ thể không tuân thủ, điều này sẽ chỉ định đường dẫn đầy đủ đến trường vi phạm. Đường dẫn này đượ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ụ: để cho biết có vấn đề với trường |
currentValue |
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ị. |
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 |
InstallationFailureReason
Lý do có thể khiến quá trình cài đặt ứng dụng không thành công.
Enum | |
---|---|
INSTALLATION_FAILURE_REASON_UNSPECIFIED |
Giá trị này không được phép. |
INSTALLATION_FAILURE_REASON_UNKNOWN |
Một tình trạng không xác định đang ngăn cài đặt ứng dụng. Một số lý do có thể là do thiết bị không có đủ dung lượng lưu trữ, 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ẽ được thử lại tự động. |
IN_PROGRESS |
Vẫn đang cài đặt. |
NOT_FOUND |
Không tìm thấy ứng dụng đó trên Play. |
NOT_COMPATIBLE_WITH_DEVICE |
Ứng dụng không tương thích với thiết bị. |
NOT_APPROVED |
Ứng dụng này chưa được quản trị viên phê duyệt. |
PERMISSIONS_NOT_ACCEPTED |
Ứng dụng có các quyền mới chưa được quản trị viên chấp nhận. |
NOT_AVAILABLE_IN_COUNTRY |
Ứng dụng này không có 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ệ nữa. Người dùng này có thể đã bị xoá hoặc 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ị suy giảm, không dùng được 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ó đủ không gian 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êm thông tin chi tiết về lý do 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 |
Lý do không tuân thủ cụ thể không được chỉ định. 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 hồ sơ hoặc thiết bị đã hết hạn. Đã đặt . được đặt thành . |
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT |
Mật khẩu của thiết bị không đáp ứng được các yêu cầu về mật khẩu. Đã đặt . được đặt thành . |
ONC_WIFI_INVALID_VALUE |
Có giá trị không chính xác trong cấu hình Wi-Fi ONC. chỉ định giá trị trường nào không chính xác. Đã đặt . được đặt thành . |
ONC_WIFI_API_LEVEL |
Chế độ cài đặt ONC Wi-Fi không được hỗ trợ ở cấp độ API của phiên bản Android chạy trên thiết bị. chỉ định giá trị trường nào không được hỗ trợ. Đã đặt . được đặt thành . |
ONC_WIFI_INVALID_ENTERPRISE_CONFIG |
Mạng Wi-Fi doanh nghiệp thiếu tổ chức phát hành chứng chỉ 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. Chế độ này chỉ áp dụng cho hồ sơ công việc trên thiết bị của 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 qua trường ClientCertKeyPairAlias trong không tương ứng với khoá hiện có đã 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 | |
---|---|
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. Xem |
passwordPoliciesContext |
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 | |
---|---|
wifiGuid |
Mã GUID của cấu hình Wi-Fi không tuân thủ. |
PasswordPoliciesContext
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.
Biểu diễn dưới dạng JSON |
---|
{
"passwordPolicyScope": enum ( |
Trường | |
---|---|
passwordPolicyScope |
Phạm vi 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 | |
---|---|
androidVersion |
Chuỗi phiên bản Android mà người dùng thấy được. Ví dụ: |
androidDevicePolicyVersionCode |
Mã phiên bản ứng dụng Android Device Policy. |
androidDevicePolicyVersionName |
Phiên bản ứng dụng Android Device Policy hiển thị với người dùng. |
androidBuildNumber |
Chuỗi mã bản dựng Android dùng để hiển thị với người dùng. Ví dụ: |
deviceKernelVersion |
Phiên bản kernel, ví dụ: |
bootloaderVersion |
Số phiên bản của trình tải khởi động hệ thống, ví dụ: |
androidBuildTime |
Thời gian xây dựng. Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: |
securityPatchLevel |
Mức bản vá bảo mật, ví dụ: |
primaryLanguageCode |
Mã ngôn ngữ IETF BCP 47 dành cho ngôn ngữ chính trên thiết bị. |
deviceBuildSignature |
Hàm 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
Thông tin về một 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 | |
---|---|
updateStatus |
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. |
updateReceivedTime |
Thời điểm bản cập nhật xuất hiện lần đầu tiên. Giá trị bằng 0 cho biết trường này chưa được đặt. Trường này chỉ được đặt khi có bản cập nhật (nghĩa là Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: |
UpdateStatus
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.
Enum | |
---|---|
UPDATE_STATUS_UNKNOWN |
Không xác định được có bản cập nhật hệ thống đang chờ xử lý nào hay không. Chẳng hạn, đ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 Android Device Policy đã 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 chưa xác định được loại bản cập nhật này. |
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ỉ xuất hiện nếu hardwareStatusEnabled
là đúng 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ụ: |
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ị. |
model |
Kiểu máy của thiết bị. Ví dụ: |
batteryShutdownTemperatures[] |
Ngưỡng nhiệt độ tắt pin theo độ C cho từng pin trên thiết bị. |
batteryThrottlingTemperatures[] |
Ngưỡng nhiệt độ điều tiết pin theo độ 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 theo độ 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 giao diện thiết bị tính bằng độ C. |
skinThrottlingTemperatures[] |
Ngưỡng nhiệt độ điều tiết trên da thiết bị tính bằng độ C. |
enterpriseSpecificId |
Chỉ có đầu ra. Mã nhận dạng giúp xác định chính xác một thiết bị thuộc sở hữu của 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í cả các lần đặt lại về trạng thái ban đầu. Mã nhận dạng này có trên thiết bị thuộc sở hữu cá nhân có hồ sơ công việc trên các thiết bị chạy Android 12 trở lên. |
Màn hình
Thông tin hiển thị của 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 của màn hình. |
displayId |
Mã hiển thị duy nhất. |
refreshRate |
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 hiển thị. |
width |
Chiều rộng hiển thị tính bằng pixel. |
height |
Hiển thị chiều cao 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 |
Giá trị này không được phép. |
OFF |
Màn hình đang tắt. |
ON |
Màn hình đang bật. |
DOZE |
Màn hình đang ngủ ở trạng thái pin yếu |
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 | |
---|---|
packageName |
Tên gói của ứng dụng. |
versionName |
Phiên bản ứng dụng như 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 phiên bản khác hay không. |
events[] |
Danh sách 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 cho 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ị hàm băm được biểu thị dưới dạng số thập lục phân gồm hai chữ số. |
signingKeyCertFingerprints[] |
Hàm băm SHA-1 của từng |
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 được khoá của ứng dụng được ứng dụng báo cáo. |
userFacingType |
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 | |
---|---|
eventType |
Loại sự kiện ứng dụng. |
createTime |
Thời gian tạo sự kiện. Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: |
ApplicationEventType
Một loại sự kiện liên quan đến ứng dụng.
Enum | |
---|---|
APPLICATION_EVENT_TYPE_UNSPECIFIED |
Giá trị này không được phép. |
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 |
Đã xoá dữ liệu ứng dụng. |
REMOVED |
Ứng dụng này đã 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 |
Đã bỏ ghim ứng dụng này. |
ApplicationSource
Nguồn đã cung cấp một ứ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à một ứng dụng hệ thống được lấy từ 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 này đượ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. Có vai trò như một điểm tham chiếu cho những gì ứng dụng đang cung cấp trạng thái. 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 |
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 ứng dụng (không bắt buộc). 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ụ: các giá trị cài đặt 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 của trạng thái ứng dụng trên thiết bị. Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: |
lastUpdateTime |
Thời điểm cập nhật trạng thái ứng dụng gần đây nhất. Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 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 chưa xác đị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 thuộc tính này cho các điều kiện lỗi thực sự mà tổ chức quản lý cần tiến hành 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 |
Chưa xác định loại ứng dụng dành cho người dùng. |
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ụ: |
wifiMacAddress |
Địa chỉ MAC Wi-Fi của thiết bị. Ví dụ: |
networkOperatorName |
Tên bằng chữ cái của nhà cung cấp dịch vụ đã đăng ký hiện tại. Ví dụ: Vodafone. |
telephonyInfos[] |
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ý hoàn toàn kể từ API Android cấp 23.
Biểu diễn dưới dạng JSON |
---|
{ "phoneNumber": string, "carrierName": string } |
Trường | |
---|---|
phoneNumber |
Số điện thoại 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. |
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 | |
---|---|
totalRam |
Tổng dung lượng RAM trên thiết bị tính bằng byte. |
totalInternalStorage |
Tổ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 sự kiện mới và sự kiện cũ, bạn nên sử dụng trường
.createTime
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. Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: |
byteCount |
Số byte trống trong phương tiện hoặc |
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 dung lượng trống trong RAM. |
INTERNAL_STORAGE_MEASURED |
Đã đo dung lượng trống trên 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 là 0. |
EXTERNAL_STORAGE_MEASURED |
Đã đo 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.
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. Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: |
batteryLevel |
Đố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 thuộc loại này. |
BATTERY_LEVEL_COLLECTED |
Đã đo được 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 các 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 | |
---|---|
createTime |
Thời gian thực hiện phép đo. Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: |
batteryTemperatures[] |
Nhiệt độ hiện tại của pin tính bằng độ C đối với từng pin trên thiết bị. |
cpuTemperatures[] |
Nhiệt độ CPU hiện tại tính bằng độ C của từng CPU trên thiết bị. |
gpuTemperatures[] |
Nhiệt độ hiện tại của GPU tính bằng độ C đối với mỗi GPU trên thiết bị. |
skinTemperatures[] |
Nhiệt độ hiện tại trên giao diện của thiết bị tính bằng độ C. |
fanSpeeds[] |
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. |
cpuUsages[] |
Mức sử dụng CPU tính theo phần trăm của mỗi nhân có trên thiết bị. Mức sử dụng là 0 cho mỗi lõi chưa cắm. Mảng trống có nghĩa là hệ thống không hỗ trợ việ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 | |
---|---|
isDeviceSecure |
Liệu 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 không rõ nguồn gốc hay không. |
developmentSettingsEnabled |
Liệu 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 |
Liệu tính năng mã hoá bộ nhớ đã bật hay chưa. |
encryptionStatus |
Trạng thái mã hoá từ DevicePolicyManager. |
verifyAppsEnabled |
Liệu quy trình xác minh qua 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 nên có loại này. |
UNSUPPORTED |
Thiết bị không hỗ trợ tính năng mã hoá. |
INACTIVE |
Tính năng mã hoá được thiết bị hỗ trợ nhưng hiện không hoạt động. |
ACTIVATING |
Tính năng mã hoá hiện không 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 không đặ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
Trạng thái bảo mật của thiết bị, như được xác định theo trạng thái hiện tại của thiết bị và các chính sách được áp dụng.
Biểu diễn dưới dạng JSON |
---|
{ "devicePosture": enum ( |
Trường | |
---|---|
devicePosture |
Giá trị tình trạng bảo mật của thiết bị. |
postureDetails[] |
Thông tin chi tiết bổ sung về tình trạng bảo mật của thiết bị. |
DevicePosture
Các giá trị có thể có về tình trạng bảo mật 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ị đối tượng độc hại tấn công hơn so với cách khuyến nghị dùng để sử dụng với dữ liệu của doanh nghiệp. |
POTENTIALLY_COMPROMISED |
Thiết bị này có thể bị xâm phạm và các đối tượng không được phép có thể truy cập vào dữ liệu của công ty. |
PostureDetail
Thông tin chi tiết bổ sung về tình trạng bảo mật của thiết bị.
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 khả năng 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 khả năng 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 (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 thấy thiết bị đang chạy một hệ điều hành bị xâm nhập (không kiểm tra được tính toàn vẹn của cơ bản). |
HARDWARE_BACKED_EVALUATION_FAILED |
API Tính toàn vẹn của Play phát hiện thấy thiết bị không đảm bảo chắc chắn 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 về đá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 | |
---|---|
commonCriteriaModeStatus |
Liệu Chế độ tiêu chí chung có được bật hay không. |
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. |
DpcMigrationInfo
Thông tin liên quan đến việc liệu thiết bị này có thuộc sự quản lý của một Trình kiểm soát chính sách thiết bị (DPC) khác hay không.
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 sẽ là tên gói của thiết bị đó. 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 |
Phương thức |
|
---|---|
|
Xoá một thiết bị. |
|
Nhận một thiết bị. |
|
Ra lệnh cho một thiết bị. |
|
Liệt kê các thiết bị của một doanh nghiệp cụ thể. |
|
Cập nhật thiết bị. |