- Tài nguyên: Thiết bị
- DeviceState
- NonComplianceDetail
- InstallationFailureReason
- SpecificNonComplianceReason
- SpecificNonComplianceContext
- OncWifiContext
- PasswordPoliciesContext
- SoftwareInfo
- SystemUpdateInfo
- UpdateStatus
- HardwareInfo
- Hiển thị
- DisplayState
- ApplicationReport (Báo cáo ứng dụng)
- ApplicationEvent
- ApplicationEventType
- ApplicationSource
- ApplicationState
- KeyedAppState
- Mức độ nghiêm trọng
- UserFacingType
- NetworkInfo
- TelephonyInfo
- MemoryInfo
- MemoryEvent
- MemoryEventType
- PowerManagementEvent
- PowerManagementEventType
- HardwareStatus (Trạng thái phần cứng)
- DeviceSettings (Cài đặt thiết bị)
- 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ó thể đọ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ý của Android Device Policy sẽ sử 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ị. Trường này có thể được sửa đổi bằng yêu cầu bản vá. Lưu ý rằng khi gọi |
appliedState |
Trạng thái hiện được áp dụng cho thiết bị. |
policyCompliant |
Xem thiết bị có tuân thủ chính sách 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ị không tuân thủ. |
enrollmentTime |
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ụ: |
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 ở đị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ụ: |
lastPolicyComplianceReportTime |
Không dùng nữa. 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ụ: |
lastPolicySyncTime |
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ụ: |
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 đang á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ý với 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 của thiết bị. Thông tin này chỉ hiển thị 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ề các màn hình trên thiết bị. Thông tin này chỉ hiển thị 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ỉ hiển thị khi |
previousDeviceNames[] |
Nếu cùng một thiết bị thực được đăng ký nhiều lần, trường này chứa tên thiết bị 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ị vật lý này từng đăng ký 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 thiết bị. Thông tin này chỉ hiển thị 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 dữ liệu đo lường bộ nhớ và dung lượng lưu trữ theo trình tự thời gian. Thông tin này chỉ hiển thị nếu Các sự kiện được giữ lại trong một khoảng thời gian nhất định, còn 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ỉ hiển thị 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ỉ hiển thị nếu |
deviceSettings |
Thông tin về chế độ cài đặt thiết bị. Thông tin này chỉ hiển thị nếu |
user |
Người dùng sở hữu thiết bị. |
systemProperties |
Bản đồ tên và giá trị của thuộc tính hệ thống đã chọn liên quan đến thiết bị. Thông tin này chỉ hiển thị nếu Đối tượng chứa danh sách các cặp |
securityPosture |
Giá trị tình trạng 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 cho việc đá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 đang á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ó được di chuyển khỏi 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 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ị đã tắt. |
DELETED |
Đã xoá thiết bị. 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 thao tác xoá. Nếu thiết bị bị xoá thông qua lệnh gọi API, thì 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ị, máy chủ sẽ 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. 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ị thất lạc. Trạng thái này chỉ có thể sử dụng trên các thiết bị do tổ chức sở hữu. |
PREPARING_FOR_MIGRATION |
Thiết bị đang chuẩn bị chuyển sang Android Management API. Bạn không cần làm gì thêm để quá trình di chuyển này có thể tiếp tục. |
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 | |
---|---|
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 ghép cụ thể không tuân thủ, thì giá trị 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 nhập loại đối tượng, theo sau tên trường là dấu chấm, rồi đến tên trường phụ. 2) Đối với các trường nhập kiểu mảng, tên trường theo sau là chỉ mục mảng được đặt trong ngoặc. Ví dụ: để biểu thị sự cố 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ể trong chính sách, thiết bị không tuân thủ chế độ cài đặt này. |
specificNonComplianceContext |
Ngữ cảnh bổ sung cho |
InstallationFailureReason
Các 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 |
Giá trị này không được phép. |
INSTALLATION_FAILURE_REASON_UNKNOWN |
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à 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ẽ được tự động thử lại. |
IN_PROGRESS |
Vẫn đang cài đặt. |
NOT_FOUND |
Không tìm thấy ứng dụng này trên Play. |
NOT_COMPATIBLE_WITH_DEVICE |
Ứng dụng này không tương thích với thiết bị. |
NOT_APPROVED |
Ứng dụng 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 hoạt động ở 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. |
NOT_ENROLLED |
Doanh nghiệp không còn đăng ký Managed Google Play nữa 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 đó 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 khả dụng hoặc có sự cố về cấu hình mạng. Vui lòng đảm bảo thiết bị có thể sử dụng đầy đủ kết nối Internet trên 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. Điều này có thể được giải quyết bằng cách giải phóng không gian 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ó đủ bộ nhớ. |
SpecificNonComplianceReason
Thông tin chi tiết khác về lý do có thể khiến thiết bị không tuân thủ chế độ cài đặt chính sách. Trong tương lai, bạn có thể thêm các 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. Đã đặt thành . |
PASSWORD_POLICIES_PASSWORD_EXPIRED |
Mật khẩu thiết bị hoặc hồ sơ đã hết hạn. Đã đặt . Đã đặt thành . |
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT |
Mật khẩu của thiết bị không đáp ứng các yêu cầu về mật khẩu. Đã đặt . Đã đặ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 ONC. chỉ định giá trị của trường nào không chính xác. Đã đặt . Đã đặt thành . |
ONC_WIFI_API_LEVEL |
Chế độ cài đặt ONC Wi-Fi không được hỗ trợ trong 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 . Đã đặ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ủa cá nhân. được đặt thành . |
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY |
Bí danh của cặp khoá được chỉ định qua trường ClientCertKeyPairAlias trong không tương ứng với khoá hiện có đã được cài đặt trên thiết bị. Đã đặ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ề tình trạng không tuân thủ liên quan đến cấu hình Wi-Fi. Xem |
passwordPoliciesContext |
Bối cảnh bổ sung về tình trạng 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ề tình trạng 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 |
GUID của cấu hình Wi-Fi không tương thích. |
PasswordPoliciesContext
Bối cảnh bổ sung về tình trạng 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 của mật khẩu không tuân thủ. |
SoftwareInfo
Thông tin về phần mềm của 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 của ứng dụng Android Device Policy mà người dùng nhìn thấy. |
androidBuildNumber |
Chuỗi mã 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 của trình tải khởi động hệ thống, ví dụ: |
androidBuildTime |
Thời gian tạo bản dựng. 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ụ: |
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 |
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à bản cập nhật đó thuộc loại nào. |
updateReceivedTime |
Thời điểm bản cập nhật đầu tiên ra mắt. 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 (nghĩa là 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ụ: |
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à 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. Chẳng hạn, tình trạng này xảy ra khi cấp độ API của thiết bị thấp hơn 26 hoặc 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ị này. |
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 đó. |
SECURITY_UPDATE_AVAILABLE |
Hiện có một bản cập nhật bảo mật đang chờ xử lý. |
OS_UPDATE_AVAILABLE |
Hiện 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 giá trị hardwareStatusEnabled
trong chính sách của thiết bị là đúng.
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 thiết bị. Ví dụ: |
batteryShutdownTemperatures[] |
Ngưỡng nhiệt độ khi tắt pin (tính bằng độ C) cho mỗi pin trên thiết bị. |
batteryThrottlingTemperatures[] |
Ngưỡng nhiệt độ điều tiết pin tính bằng độ C cho mỗi 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 theo độ C cho mỗi CPU trên thiết bị. |
gpuShutdownTemperatures[] |
Ngưỡng nhiệt độ tắt GPU tính bằng độ C đối với 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 trên giao diện thiết bị tính bằng độ C. |
skinThrottlingTemperatures[] |
Ngưỡng nhiệt độ điều chỉnh giao diện người dùng trên thiết bị tính theo độ C. |
enterpriseSpecificId |
Chỉ có đầu ra. Mã nhận dạng xác định duy nhất 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 sẽ vẫn tồn tại trong các quá trình thiết lập và thậm chí cả khi đặt lại về trạng thái ban đầu. Mã này được cấp trên các thiết bị thuộc sở hữu của cá nhân có hồ sơ công việc trên thiết bị chạy Android 12 trở lên. |
Mạng Hiển thị
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 màn hình. |
displayId |
Mã hiển thị duy nhất. |
refreshRate |
Tốc độ làm mới 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 |
Chiều cao hiển thị 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ủ gật ở trạng thái pin yếu |
SUSPENDED |
Màn hình đang ngủ gật trong trạng thái pin yếu bị tạm ngưng. |
ApplicationReport
Thông tin được báo cáo về một ứng dụng cần 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 mà người dùng nhìn thấy. |
versionCode |
Bạn có thể dùng mã phiên bản ứng dụng để xác định xem một phiên bản có phải là phiên bản mới hơn phiên bản khác 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 của tệp APK ứng dụng 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 diễn 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 của ứng dụng. |
keyedAppStates[] |
Danh sách các trạng thái ứng dụng chính mà ứ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 ở đị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ụ: |
ApplicationEventType
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. |
CHANGED |
Ứng dụng đã thay đổi, chẳng hạn như bật hoặc tắt một thành phần. |
DATA_CLEARED |
Đã xoá dữ liệu ứng dụng. |
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 đã được bỏ ghim. |
ApplicationSource
Nguồn đã cung cấp một ứng dụng.
Enum | |
---|---|
APPLICATION_SOURCE_UNSPECIFIED |
Ứng dụng được cài đặt 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 từ hình ảnh gốc của thiết bị. |
SYSTEM_APP_UPDATED_VERSION |
Đây là ứng dụng hệ thống đã được 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 |
Chưa chỉ định trạng thái ứng dụng |
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 chính 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 |
Chìa khoá cho trạng thái ứng dụng. Đóng vai trò là một điểm tham chiếu cho nội dung mà ứng dụng 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 |
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ý), thì trạng thái đó phải được đưa vào thông báo. |
data |
Giá trị có thể đọc được trên máy để EMM đọc. Ví dụ: đặt 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ị. 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ụ: |
lastUpdateTime |
Thời gian cập nhật trạng thái ứng dụng gần đây 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 |
Chưa chỉ định mức độ nghiêm trọng. |
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 thiết lập 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 chỉ định kiểu mà ứ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 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ỉ Wi-Fi MAC của thiết bị. Ví dụ: |
networkOperatorName |
Tên theo thứ tự bảng chữ cái của toán tử hiện đã đăng ký. Ví dụ: Vodafone. |
telephonyInfos[] |
Cung cấp thông tin điện thoại liên kết với mỗi thẻ SIM trên thiết bị. Chỉ được hỗ trợ trên các thiết bị được quản lý toàn diện, kể từ API Android cấp 23. |
TelephonyInfo
Thông tin về cuộc gọi liên kết với một thẻ SIM nhất định trên thiết bị. Chỉ được hỗ trợ trên các thiết bị được quản lý toàn diệ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 đượ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. |
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 các phép đo bộ nhớ và dung lượng lưu trữ.
Để phân biệt các 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 | |
---|---|
eventType |
Loại sự kiện. |
createTime |
Thời gian tạo sự kiện. 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ụ: |
byteCount |
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 dung lượng trống trong RAM. |
INTERNAL_STORAGE_MEASURED |
Đã đo dung lượng trống trong bộ nhớ trong. |
EXTERNAL_STORAGE_DETECTED |
Đã phát hiện thấy 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á phương tiện lưu trữ bên 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 điệ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 ở đị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ụ: |
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 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 đo. 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ụ: |
batteryTemperatures[] |
Nhiệt độ hiện tại của pin, tính bằng độ C cho mỗi pin trên thiết bị. |
cpuTemperatures[] |
Nhiệt độ CPU hiện tại tính bằng độ C cho mỗi CPU trên thiết bị. |
gpuTemperatures[] |
Nhiệt độ GPU hiện tại tính bằng độ C cho từng GPU trên thiết bị. |
skinTemperatures[] |
Nhiệt độ hiện tại trên da thiết bị tính bằng độ C. |
fanSpeeds[] |
Tốc độ quạt (tính theo vòng/phút) 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 tỷ lệ phần trăm cho mỗi lõi có trên thiết bị. Mức sử dụng là 0 đối với mỗi lõi đã tháo. Mảng trống ngụ ý rằng hệ thống không hỗ trợ hoạt động sử dụng CPU. |
DeviceSettings
Thông tin về các chế độ cài đặt liên quan đến tính 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 |
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 tính năng 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ớ có được bật hay không. |
encryptionStatus |
Trạng thái mã hoá qua DevicePolicyManager. |
verifyAppsEnabled |
Liệu quy trình xác minh 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ó 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 khoá mã hoá không do người dùng đặt. |
ACTIVE_PER_USER |
Quá trình 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ị tình trạng 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 đối tượng độc hại tấn công hơn so với mức khuyến nghị khi sử dụng với 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 đối tượng không được cấp 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 tình trạ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 tình trạ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 phạm (không kiểm tra được basicIntegrity). |
HARDWARE_BACKED_EVALUATION_FAILED |
API Tính toàn vẹn của Play phát hiện thấy rằng 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 cho việc đá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 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ó được di chuyển khỏi 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 là tên gói của thiết bị. Không được điền theo cách khác. |
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á thiết bị. |
|
Nhận một thiết bị. |
|
Đưa 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ị. |