REST Resource: enterprises.devices

Tài nguyên: Thiết bị

Thiết bị thuộc sở hữu của một doanh nghiệp. Trừ phi có ghi chú khác, tất cả các trường đều ở chế độ chỉ đọc và enterprises.devices.patch không thể sửa đổi.

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

string

Tên của thiết bị ở dạng enterprises/{enterpriseId}/devices/{deviceId}.
userName

string

Tên tài nguyên của người dùng sở hữu thiết bị này ở dạng enterprises/{enterpriseId}/users/{userId}.
managementMode

enum (ManagementMode)

Loại chế độ quản lý mà Android Device Policy áp dụng trên thiết bị. Điều này ảnh hưởng đến những chế độ cài đặt chính sách được hỗ trợ.
state

enum (DeviceState)

Trạng thái sẽ được áp dụng cho thiết bị. Bạn có thể sửa đổi trường này bằng một yêu cầu vá. Xin lưu ý rằng khi gọi enterprises.devices.patch, ACTIVE và DISABLED là những giá trị duy nhất được phép. Để chuyển thiết bị sang trạng thái DELETED, hãy gọi enterprises.devices.delete.
appliedState

enum (DeviceState)

Trạng thái hiện được áp dụng cho thiết bị.
policyCompliant

boolean

Thiết bị có tuân thủ chính sách của thiết bị hay không.
nonComplianceDetails[]

object (NonComplianceDetail)

Thông tin chi tiết về các chế độ cài đặt chính sách mà thiết bị không tuân thủ.
enrollmentTime

string (Timestamp format)

Thời gian đăng ký thiết bị.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
lastStatusReportTime

string (Timestamp format)

Lần gần đây nhất thiết bị gửi báo cáo trạng thái.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

Không dùng nữa.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
lastPolicySyncTime

string (Timestamp format)

Lần gần đây nhất thiết bị tìm nạp chính sách.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
policyName

string

Tên của chính sách được áp dụng cho thiết bị, ở dạng enterprises/{enterpriseId}/policies/{policyId}. Nếu bạn không chỉ định, thì policyName cho người dùng thiết bị sẽ được áp dụng. Bạn có thể sửa đổi trường này bằng một yêu cầu vá. Bạn chỉ có thể chỉ định policyId khi gọi enterprises.devices.patch, miễn là policyId không chứa dấu gạch chéo. Phần còn lại của tên chính sách sẽ được suy luận.
appliedPolicyName

string

Tên của chính sách hiện đang áp dụng cho thiết bị.
appliedPolicyVersion

string (int64 format)

Phiên bản của chính sách hiện đang áp dụng cho thiết bị.
apiLevel

integer

Cấp độ API của phiên bản nền tảng Android đang chạy trên thiết bị.
enrollmentTokenData

string

Nếu thiết bị được đăng ký bằng mã thông báo đăng ký có cung cấp thêm dữ liệu, thì trường này sẽ chứa dữ liệu đó.
enrollmentTokenName

string

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

object (UserFacingMessage)

Nếu trạng thái thiết bị là DISABLED, một thông báo không bắt buộc sẽ xuất hiện trên thiết bị, cho biết lý do thiết bị bị vô hiệu hoá. Bạn có thể sửa đổi trường này bằng một yêu cầu vá.
softwareInfo

object (SoftwareInfo)

Thông tin chi tiết về phần mềm thiết bị. Thông tin này chỉ có sẵn nếu softwareInfoEnabled là true trong chính sách của thiết bị.
hardwareInfo

object (HardwareInfo)

Thông tin chi tiết về phần cứng của thiết bị.
displays[]

object (Display)

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 displayInfoEnabled là true trong chính sách của thiết bị.
applicationReports[]

object (ApplicationReport)

Báo cáo về các ứng dụng đã cài đặt trên thiết bị. Thông tin này chỉ có khi applicationReportsEnabled là true trong chính sách của thiết bị.
previousDeviceNames[]

string

Nếu cùng một thiết bị thực đã được đăng ký nhiều lần, trường này sẽ chứa tên thiết bị trước đó. Số sê-ri được dùng làm giá trị nhận dạng riêng biệt để xác định xem thiết bị thực tế đó đã từng đăng ký hay chưa. Tên được sắp xếp theo thứ tự thời gian.
networkInfo

object (NetworkInfo)

Thông tin về mạng của thiết bị. Thông tin này chỉ có sẵn nếu networkInfoEnabled là true trong chính sách của thiết bị.
memoryInfo

object (MemoryInfo)

Thông tin về bộ nhớ: chứa thông tin về bộ nhớ và bộ nhớ lưu trữ của thiết bị.
memoryEvents[]

object (MemoryEvent)

Các sự kiện liên quan đến việc đo lường bộ nhớ và bộ nhớ lưu trữ theo trình tự thời gian. Thông tin này chỉ có sẵn nếu memoryInfoEnabled là true trong chính sách của thiết bị.

Các sự kiện được giữ lại trong một khoảng thời gian nhất định và các sự kiện cũ sẽ bị xoá.
powerManagementEvents[]

object (PowerManagementEvent)

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 powerManagementEventsEnabled là true trong chính sách của thiết bị.
hardwareStatusSamples[]

object (HardwareStatus)

Các mẫu trạng thái phần cứng theo thứ tự thời gian. Thông tin này chỉ có sẵn nếu hardwareStatusEnabled là true trong chính sách của thiết bị.
deviceSettings

object (DeviceSettings)

Thông tin về chế độ cài đặt thiết bị. Thông tin này chỉ có sẵn nếu deviceSettingsEnabled là true trong chính sách của thiết bị.
user

object (User)

Người dùng sở hữu thiết bị.
systemProperties

map (key: string, value: string)

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 systemPropertiesEnabled là true trong chính sách của thiết bị.

Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
securityPosture

object (SecurityPosture)

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

enum (Ownership)

Quyền sở hữu thiết bị được quản lý.
commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

Thông tin về Chế độ Tiêu chí chung – các tiêu chuẩn bảo mật được xác định trong Tiêu chí chung để đánh giá bảo mật công nghệ thông tin (CC).

Thông tin này chỉ có sẵn nếu statusReportingSettings.commonCriteriaModeEnabled là true trong chính sách của thiết bị và thiết bị đó thuộc sở hữu của công ty.
appliedPasswordPolicies[]

object (PasswordRequirements)

Các yêu cầu về mật khẩu hiện đang áp dụng cho thiết bị.

  • Các yêu cầu được áp dụng có thể hơi khác so với các yêu cầu được chỉ định trong passwordPolicies trong một số trường hợp.
  • fieldPath được đặt dựa trên passwordPolicies.
dpcMigrationInfo

object (DpcMigrationInfo)

Chỉ có đầu ra. Thông tin liên quan đến việc thiết bị này có được di chuyển từ trạng thái do một Trình điều khiển chính sách thiết bị (DPC) khác quản lý hay không.

DeviceState

Các trạng thái có thể được á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ị vô hiệu hoá.
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 xuất bản 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ẽ không biết trạng thái của 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 áp dụng một chính sách.
LOST Thiết bị bị thất lạc. Trạng thái này chỉ có thể xảy ra 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 để tiếp tục di chuyển.
DEACTIVATED_BY_DEVICE_FINANCE Đây là một thiết bị được mua trả góp và đã bị đại lý tài chính "khoá". Đ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 thiết bị được đại lý tài chính "mở khoá". 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ị ghi đè bởi đại lý tài chính. Khi thiết bị ở trạng thái "đã khoá", trạng thái này 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ủ một chế độ cài đặt chính sách.

Biểu diễn dưới dạng JSON 
{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string,
  "fieldPath": string,
  "currentValue": value,
  "installationFailureReason": enum (InstallationFailureReason),
  "specificNonComplianceReason": enum (SpecificNonComplianceReason),
  "specificNonComplianceContext": {
    object (SpecificNonComplianceContext)
  }
}
Trường
settingName

string

Tên của chế độ cài đặt chính sách. Đây là tên trường JSON của một trường Policy cấp cao nhất.
nonComplianceReason

enum (NonComplianceReason)

Lý do thiết bị không tuân thủ chế độ cài đặt.
packageName

string

Tên gói cho biết ứng dụng nào không tuân thủ, nếu có.
fieldPath

string

Đối với các chế độ cài đặt có trường lồng nhau, nếu một trường lồng nhau cụ thể không tuân thủ, thì trường này sẽ chỉ định đường dẫn đầy đủ đến trường vi phạm. Đường dẫn được định dạng theo cách tương tự như trường JSON của chính sách sẽ được tham chiếu trong JavaScript, tức là: 1) Đối với các trường có kiểu đối tượng, tên trường sẽ theo sau là dấu chấm rồi đến tên trường con. 2) Đối với các trường có kiểu mảng, tên trường sẽ theo sau chỉ mục mảng được đặt trong dấu ngoặc. Ví dụ: để cho biết vấn đề với trường url trong trường externalData của ứng dụng thứ 3, đường dẫn sẽ là applications[2].externalData.url
currentValue

value (Value format)

Nếu không áp dụng được chế độ cài đặt chính sách, thì giá trị hiện tại của chế độ cài đặt trên thiết bị.
installationFailureReason

enum (InstallationFailureReason)

Nếu bạn đặt packageName và lý do không tuân thủ là APP_NOT_INSTALLED hoặc APP_NOT_UPDATED, thì đây là lý do cụ thể khiến ứng dụng không cài đặt hoặc cập nhật được.
specificNonComplianceReason

enum (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

object (SpecificNonComplianceContext)

Ngữ cảnh bổ sung cho specificNonComplianceReason.

InstallationFailureReason

Lý do khiến bạn không cài đặt được ứng dụng.

Enum
INSTALLATION_FAILURE_REASON_UNSPECIFIED Giá trị này không được phép.
INSTALLATION_FAILURE_REASON_UNKNOWN Một điều kiện không xác định đang ngăn không cho 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 ổn định hoặc quá trình cài đặt mất nhiều thời gian hơn dự kiến. Hệ thống sẽ tự động thử lại quá trình cài đặt.
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 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 Quản trị viên chưa phê duyệt ứng dụng này.
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ó ở 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 này có thể đã bị xoá hoặc vô hiệu hoá.
NETWORK_ERROR_UNRELIABLE_CONNECTION

Lỗi mạng trên thiết bị của người dùng đã ngăn quá trình cài đặt 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 hoạt động hoặc có vấn đề về cấu hình mạng. Vui lòng đảm bảo thiết bị có quyền truy cập vào kết nối Internet đầy đủ trên một mạng đáp ứng Android Enterprise Network Requirements. Quá trình cài đặt hoặc cập nhật ứng dụng sẽ tự động tiếp tục khi có kết nối mạ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 khi thiết bị có đủ bộ nhớ.

SpecificNonComplianceReason

Thông tin chi tiết hơn về lý do khiến một thiết bị có thể không tuân thủ chế độ cài đặt chính sách. Bạn có thể thêm các giá trị mới vào enum trong tương lai.

Enum
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED Không nêu rõ lý do cụ thể về việc không tuân thủ. Bạn chưa đặt các trường trong specificNonComplianceContext.
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. Bạn chưa đặt các trường trong specificNonComplianceContext. nonComplianceReason được đặt thành USER_ACTION.
PASSWORD_POLICIES_PASSWORD_EXPIRED Mật khẩu thiết bị hoặc mật khẩu hồ sơ đã hết hạn. passwordPoliciesContext được đặt. nonComplianceReason được đặt thành USER_ACTION.
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. passwordPoliciesContext được đặt. nonComplianceReason được đặt thành USER_ACTION.
ONC_WIFI_INVALID_VALUE Có một giá trị không chính xác trong cấu hình Wi-Fi ONC. fieldPath chỉ định giá trị trường nào không chính xác. oncWifiContext được đặt. nonComplianceReason được đặt thành INVALID_VALUE.
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ị. fieldPath chỉ định giá trị trường nào không được hỗ trợ. oncWifiContext được đặt. nonComplianceReason được đặt thành API_LEVEL.
ONC_WIFI_INVALID_ENTERPRISE_CONFIG Mạng Wi-Fi doanh nghiệp thiếu CA gốc hoặc tên miền. nonComplianceReason được đặt thành INVALID_VALUE.
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ỉ áp dụng cho hồ sơ công việc trên thiết bị thuộc sở hữu cá nhân. nonComplianceReason được đặt thành USER_ACTION.
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 openNetworkConfiguration không tương ứng với một khoá hiện có được cài đặt trên thiết bị. nonComplianceReason được đặt thành INVALID_VALUE.
PERMISSIBLE_USAGE_RESTRICTION Chế độ cài đặt chính sách này bị hạn chế và không thể đặt cho dự án Google Cloud Platform này. Bạn có thể xem thêm thông tin (bao gồm cả cách bật chế độ cài đặt chính sách này) trong Chính sách về việc sử dụng được phép. nonComplianceReason được đặt thành PROJECT_NOT_PERMITTED.
REQUIRED_ACCOUNT_NOT_IN_ENTERPRISE Tài khoản công việc do chế độ cài đặt chính sách workAccountSetupConfig yêu cầu không còn thuộc doanh nghiệp nữa. nonComplianceReason được đặt thành USER_ACTION.
NEW_ACCOUNT_NOT_IN_ENTERPRISE Tài khoản công việc mà người dùng đã thêm không thuộc doanh nghiệp. nonComplianceReason được đặt thành USER_ACTION.

SpecificNonComplianceContext

Ngữ cảnh bổ sung cho SpecificNonComplianceReason.

Biểu diễn dưới dạng JSON 
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  }
}
Trường
oncWifiContext

object (OncWifiContext)

Bối cảnh bổ sung cho trường hợp không tuân thủ liên quan đến cấu hình Wi-Fi. Hãy xem ONC_WIFI_INVALID_VALUE và ONC_WIFI_API_LEVEL
passwordPoliciesContext

object (PasswordPoliciesContext)

Thông tin bổ sung về trường hợp không tuân thủ liên quan đến chính sách mật khẩu. Hãy xem PASSWORD_POLICIES_PASSWORD_EXPIRED và PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT.

OncWifiContext

Bối cảnh bổ sung cho trường hợp không tuân thủ liên quan đến cấu hình Wi-Fi.

Biểu diễn dưới dạng JSON 
{
  "wifiGuid": string
}
Trường
wifiGuid

string

GUID của cấu hình Wi-Fi không tuân thủ.

PasswordPoliciesContext

Thông tin bổ sung về trường hợp không tuân thủ liên quan đến chính sách mật khẩu.

Biểu diễn dưới dạng JSON 
{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}
Trường
passwordPolicyScope

enum (PasswordPolicyScope)

Phạm vi của mật khẩu không tuân thủ.

SoftwareInfo

Thông tin về phần mềm 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 (SystemUpdateInfo)
  }
}
Trường
androidVersion

string

Chuỗi phiên bản Android mà người dùng nhìn thấy. Ví dụ: 6.0.1.
androidDevicePolicyVersionCode

integer

Mã phiên bản của ứng dụng Android Device Policy.
androidDevicePolicyVersionName

string

Phiên bản ứng dụng Android Device Policy mà người dùng nhìn thấy.
androidBuildNumber

string

Chuỗi mã nhận dạng bản dựng Android dùng để hiển thị cho người dùng. Ví dụ: shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys.
deviceKernelVersion

string

Phiên bản kernel, ví dụ: 2.6.32.9-g103d848.
bootloaderVersion

string

Số phiên bản trình tải khởi động của hệ thống, ví dụ: 0.6.7.
androidBuildTime

string (Timestamp format)

Thời gian xây dựng.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
securityPatchLevel

string

Cấp bản vá bảo mật, ví dụ: 2016-05-01.
primaryLanguageCode

string

Mã ngôn ngữ IETF BCP 47 cho ngôn ngữ chính trên thiết bị.
deviceBuildSignature

string

Băm SHA-256 của android.content.pm.Signature được liên kết với gói hệ thống. Bạn có thể dùng băm này để xác minh rằng bản dựng hệ thống chưa bị sửa đổi.
systemUpdateInfo

object (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 (UpdateStatus),
  "updateReceivedTime": string
}
Trường
updateStatus

enum (UpdateStatus)

Trạng thái của bản cập nhật: có bản cập nhật hay không và loại bản cập nhật.
updateReceivedTime

string (Timestamp format)

Thời điểm bản cập nhật được cung cấp lần đầu tiên. Giá trị 0 cho biết trường này chưa được đặt. Trường này chỉ được đặt nếu có bản cập nhật (tức là updateStatus không phải là UPDATE_STATUS_UNKNOWN cũng không phải là UP_TO_DATE).

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

UpdateStatus

Trạng thái của bản cập nhật: có bản cập nhật hay không và loại bản cập nhật.

Enum
UPDATE_STATUS_UNKNOWN Không rõ có bản cập nhật hệ thống nào đang chờ xử lý hay không. Điều này xảy ra khi, ví dụ: API cấp của thiết bị thấp hơn 26 hoặc nếu phiên bản của 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 Hiện 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 Đã có bản cập nhật bảo mật đang chờ xử lý.
OS_UPDATE_AVAILABLE Đã có 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,
  "euiccChipInfo": [
    {
      object (EuiccChipInfo)
    }
  ]
}
Trường
brand

string

Thương hiệu của thiết bị. Ví dụ: Google.
hardware

string

Tên của phần cứng. Ví dụ: Angler.
deviceBasebandVersion

string

Phiên bản băng tần cơ sở. Ví dụ: MDM9625_104662.22.05.34p.
manufacturer

string

Nhà sản xuất. Ví dụ: Motorola.
serialNumber

string

Số sê-ri của thiết bị.
model

string

Mẫu thiết bị. Ví dụ: Asus Nexus 7.
batteryShutdownTemperatures[]

number

Ngưỡng nhiệt độ tắt pin (tính bằng độ C) cho từng pin trên thiết bị.
batteryThrottlingTemperatures[]

number

Ngưỡng nhiệt độ điều tiết pin theo độ C cho từng pin trên thiết bị.
cpuShutdownTemperatures[]

number

Ngưỡng nhiệt độ tắt CPU tính bằng độ C cho từng CPU trên thiết bị.
cpuThrottlingTemperatures[]

number

Ngưỡng nhiệt độ điều tiết CPU theo độ C cho từng CPU trên thiết bị.
gpuShutdownTemperatures[]

number

Ngưỡng nhiệt độ tắt GPU tính bằng độ C cho từng GPU trên thiết bị.
gpuThrottlingTemperatures[]

number

Ngưỡng nhiệt độ điều tiết GPU tính bằng độ C cho từng GPU trên thiết bị.
skinShutdownTemperatures[]

number

Ngưỡng nhiệt độ trên da của thiết bị khi tắt theo độ C.
skinThrottlingTemperatures[]

number

Ngưỡng nhiệt độ điều tiết trên da của thiết bị theo độ C.
enterpriseSpecificId

string

Chỉ có đầu ra. Mã nhận dạng duy nhất cho một thiết bị thuộc sở hữu cá nhân trong một tổ chức cụ thể. Trên cùng một thiết bị thực khi được đăng ký bằng cùng một tổ chức, mã nhận dạng này sẽ duy trì trong các lần thiết lập và ngay cả khi đặt lại về trạng thái ban đầu. Mã nhận dạng này có trên các thiết bị do cá nhân sở hữu có sử dụng hồ sơ công việc và chạy Android 12 trở lên.
euiccChipInfo[]

object (EuiccChipInfo)

Chỉ có đầu ra. Thông tin liên quan đến chip eUICC.

EuiccChipInfo

Thông tin liên quan đến chip eUICC.

Biểu diễn dưới dạng JSON 
{
  "eid": string
}
Trường
eid

string

Chỉ có đầu ra. Tài liệu nhận dạng được nhúng (EID) giúp xác định chip eUICC cho từng chip eUICC trên thiết bị. Tính năng này có trên các thiết bị do công ty sở hữu chạy Android 13 trở lên.

Màn hình

Thông tin hiển thị trên thiết bị.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "displayId": integer,
  "refreshRate": integer,
  "state": enum (DisplayState),
  "width": integer,
  "height": integer,
  "density": integer
}
Trường
name

string

Tên của màn hình.
displayId

integer

Mã nhận dạng duy nhất của màn hình.
refreshRate

integer

Tốc độ làm mới của màn hình, tính bằng số khung hình/giây.
state

enum (DisplayState)

Trạng thái của màn hình.
width

integer

Chiều rộng màn hình tính bằng pixel.
height

integer

Chiều cao màn hình tính bằng pixel.
density

integer

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 ở trạng thái ngủ ở chế độ tiết kiệm pin
SUSPENDED Màn hình đang ở trạng thái ngủ trong chế độ tạm ngưng tiết kiệm 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 (ApplicationEvent)
    }
  ],
  "displayName": string,
  "packageSha256Hash": string,
  "signingKeyCertFingerprints": [
    string
  ],
  "installerPackageName": string,
  "applicationSource": enum (ApplicationSource),
  "state": enum (ApplicationState),
  "keyedAppStates": [
    {
      object (KeyedAppState)
    }
  ],
  "userFacingType": enum (UserFacingType)
}
Trường
packageName

string

Tên gói của ứng dụng.
versionName

string

Phiên bản ứng dụng mà người dùng nhìn thấy.
versionCode

integer

Mã phiên bản ứng dụng. Bạn có thể dùng mã này để xác định xem một phiên bản có mới hơn một phiên bản khác hay không.
events[]

object (ApplicationEvent)

Danh sách các sự kiện ứng dụng đã xảy ra trong 30 giờ qua.
displayName

string

Tên hiển thị của ứng dụng.
packageSha256Hash

string

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 rằng ứng dụng chưa bị sửa đổi. Mỗi byte của giá trị băm được biểu thị dưới dạng một số thập lục phân gồm 2 chữ số.
signingKeyCertFingerprints[]

string

Băm SHA-1 của mỗi android.content.pm.Signature được liên kết với gói ứng dụng. Mỗi byte của mỗi giá trị băm được biểu thị dưới dạng một số thập lục phân gồm 2 chữ số.
installerPackageName

string

Tên gói của ứng dụng đã cài đặt ứng dụng này.
applicationSource

enum (ApplicationSource)

Nguồn của gói.
state

enum (ApplicationState)

Trạng thái ứng dụng.
keyedAppStates[]

object (KeyedAppState)

Danh sách các trạng thái ứng dụng có khoá do ứng dụng báo cáo.
userFacingType

enum (UserFacingType)

Ứng dụng có hướng đến 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 (ApplicationEventType),
  "createTime": string
}
Trường
eventType

enum (ApplicationEventType)

Loại sự kiện ứng dụng.
createTime

string (Timestamp format)

Thời gian tạo sự kiện.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

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 Ứng dụng đã được cài đặt.
CHANGED Ứng dụng đã thay đổi, ví dụ: 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 đã bị xoá.
REPLACED Một 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 cài đặt từ một nguồn không xác định.
SYSTEM_APP_FACTORY_VERSION Đây là một ứng dụng hệ thống trong hình ảnh gốc của thiết bị.
SYSTEM_APP_UPDATED_VERSION Đây là một ứng dụng hệ thống đã được 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 của ứng dụng chưa được chỉ định
REMOVED Ứng dụng đã bị xoá khỏi thiết bị
INSTALLED Ứng dụng được cài đặt trên thiết bị

KeyedAppState

Trạng thái ứng dụng có khoá do ứng dụng báo cáo.

Biểu diễn dưới dạng JSON 
{
  "key": string,
  "severity": enum (Severity),
  "message": string,
  "data": string,
  "createTime": string,
  "lastUpdateTime": string
}
Trường
key

string

Khoá cho trạng thái ứng dụng. Đóng vai trò là điểm tham chiếu cho trạng thái mà ứng dụng đang cung cấp. Ví dụ: khi cung cấp ý kiến phản hồi về cấu hình được quản lý, khoá này có thể là khoá cấu hình được quản lý.
severity

enum (Severity)

Mức độ nghiêm trọng của trạng thái ứng dụng.
message

string

Nếu muốn, bạn có thể dùng một chuỗi thông báo dạng tự do để giải thích trạng thái ứng dụng. Nếu trạng thái được kích hoạt bởi một giá trị cụ thể (ví dụ: giá trị cấu hình được quản lý), thì bạn nên đưa giá trị đó vào thông báo.
data

string

Ngoài ra, EMM có thể đọc được giá trị mà máy đọc được. Ví dụ: đặt các giá trị mà quản trị viên có thể chọn để truy vấn trong bảng điều khiển EMM (ví dụ: "thông báo cho tôi nếu dữ liệu battery_warning < 10").
createTime

string (Timestamp format)

Thời gian tạo trạng thái ứng dụng trên thiết bị.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
lastUpdateTime

string (Timestamp format)

Thời gian gần đây nhất trạng thái ứng dụng được cập nhật.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".

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 Cấp độ 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 thực hiện hành động để khắc phục.

UserFacingType

Ứng dụng có hướng đến người dùng hay không.

Enum
USER_FACING_TYPE_UNSPECIFIED Loại người dùng ứng dụng mà người dùng nhìn thấy 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 thiết bị.

Biểu diễn dưới dạng JSON 
{
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperatorName": string,
  "telephonyInfos": [
    {
      object (TelephonyInfo)
    }
  ]
}
Trường
imei

string

Số IMEI của thiết bị GSM. Ví dụ: A1000031212.
meid

string

Số MEID của thiết bị CDMA. Ví dụ: A00000292788E1.
wifiMacAddress

string

Địa chỉ MAC của Wi-Fi trên thiết bị. Ví dụ: 7c:11:11:11:11:11.
networkOperatorName
(deprecated)

string

Tên theo bảng chữ cái của nhà mạng đã đăng ký hiện tại. Ví dụ: Vodafone.
telephonyInfos[]

object (TelephonyInfo)

Cung cấp thông tin về điện thoại liên quan đến từng thẻ SIM trên thiết bị. Chỉ được hỗ trợ trên các thiết bị được quản lý hoàn toàn bắt đầu từ cấp độ API 23 của Android.

TelephonyInfo

Thông tin về điện thoạ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ý hoàn toàn bắt đầu từ cấp độ API 23 của Android.

Biểu diễn dưới dạng JSON 
{
  "phoneNumber": string,
  "carrierName": string,
  "iccId": string,
  "activationState": enum (ActivationState),
  "configMode": enum (ConfigMode)
}
Trường
phoneNumber

string

Số điện thoại được liên kết với thẻ SIM này.
carrierName

string

Tên nhà mạng liên kết với thẻ SIM này.
iccId

string

Chỉ có đầu ra. Mã nhận dạng thẻ SIM (ICCID) được liên kết với thẻ SIM này.
activationState

enum (ActivationState)

Chỉ có đầu ra. Trạng thái kích hoạt của thẻ SIM trên thiết bị. Điều này chỉ áp dụng cho eSIM. Chế độ này được hỗ trợ trên mọi thiết bị có API cấp 35 trở lên. Đây luôn là ACTIVATION_STATE_UNSPECIFIED đối với SIM vật lý và đối với các thiết bị dưới API cấp 35.
configMode

enum (ConfigMode)

Chỉ có đầu ra. Chế độ cấu hình của thẻ SIM trên thiết bị. Điều này chỉ áp dụng cho eSIM. Chế độ này được hỗ trợ trên mọi thiết bị có API cấp 35 trở lên. Đây luôn là CONFIG_MODE_UNSPECIFIED đối với SIM vật lý và đối với các thiết bị dưới API cấp 35.

ActivationState

Trạng thái kích hoạt của thẻ SIM trên thiết bị.

Enum
ACTIVATION_STATE_UNSPECIFIED Bạn chưa chỉ định trạng thái kích hoạt.
ACTIVATED Thẻ SIM đã được kích hoạt.
NOT_ACTIVATED Thẻ SIM chưa được kích hoạt.

ConfigMode

Chế độ cấu hình của thẻ SIM trên thiết bị.

Enum
CONFIG_MODE_UNSPECIFIED Chưa chỉ định chế độ cấu hình.
ADMIN_CONFIGURED Quản trị viên đã định cấu hình SIM này.
USER_CONFIGURED Người dùng đã định cấu hình SIM này.

MemoryInfo

Thông tin về bộ nhớ và bộ nhớ lưu trữ của thiết bị.

Biểu diễn dưới dạng JSON 
{
  "totalRam": string,
  "totalInternalStorage": string
}
Trường
totalRam

string (int64 format)

Tổng dung lượng RAM trên thiết bị tính bằng byte.
totalInternalStorage

string (int64 format)

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à bộ nhớ lưu trữ.

Để phân biệt giữa 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 (MemoryEventType),
  "createTime": string,
  "byteCount": string
}
Trường
eventType

enum (MemoryEventType)

Loại sự kiện.
createTime

string (Timestamp format)

Thời gian tạo sự kiện.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
byteCount

string (int64 format)

Số byte trống trong phương tiện hoặc đối với EXTERNAL_STORAGE_DETECTED, tổng dung lượng tính bằng byte của phương tiện lưu trữ.

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 lưu trữ 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 Đã tháo một phương tiện lưu trữ bên ngoài. Số byte được báo cáo là 0.
EXTERNAL_STORAGE_MEASURED Đo lường dung lượng trống trong một phương tiện lưu trữ bên 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 (PowerManagementEventType),
  "createTime": string,
  "batteryLevel": number
}
Trường
eventType

enum (PowerManagementEventType)

Loại sự kiện.
createTime

string (Timestamp format)

Thời gian tạo sự kiện.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
batteryLevel

number

Đối với các sự kiện BATTERY_LEVEL_COLLECTED, mức pin được tính bằng phần trăm.

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ế độ nguồn điện thấp.
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

string (Timestamp format)

Thời gian đo lường.

Sử dụng RFC 3339, trong đó đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các độ lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
batteryTemperatures[]

number

Nhiệt độ pin hiện tại (đơn vị là độ C) của từng pin trên thiết bị.
cpuTemperatures[]

number

Nhiệt độ CPU hiện tại theo độ C cho từng CPU trên thiết bị.
gpuTemperatures[]

number

Nhiệt độ hiện tại của GPU (tính bằng độ C) cho từng GPU trên thiết bị.
skinTemperatures[]

number

Nhiệt độ hiện tại trên da của thiết bị tính bằng độ C.
fanSpeeds[]

number

Tốc độ quạt tính bằng số vòng quay mỗi phút cho từng quạt trên thiết bị. Mảng trống có nghĩa là hệ thống không có quạt hoặc không hỗ trợ tốc độ quạt.
cpuUsages[]

number

Mức sử dụng CPU theo tỷ lệ phần trăm cho từng lõi có trên thiết bị. Mức sử dụng là 0 cho mỗi lõi không cắm điện. Mảng trống ngụ ý rằng hệ thống không hỗ trợ mức sử dụng CPU.

DeviceSettings

Thông tin về các chế độ cài đặt bảo mật liên quan đế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 (EncryptionStatus),
  "verifyAppsEnabled": boolean
}
Trường
isDeviceSecure

boolean

Thiết bị có được bảo mật bằng mã PIN/mật khẩu hay không.
unknownSourcesEnabled

boolean

Liệu có bật chế độ cài đặt ứng dụng từ nguồn không xác định hay không.
developmentSettingsEnabled

boolean

Chế độ nhà phát triển có được bật trên thiết bị hay không.
adbEnabled

boolean

Liệu ADB có được bật trên thiết bị hay không.
isEncrypted

boolean

Tính năng mã hoá bộ nhớ có được bật hay không.
encryptionStatus

enum (EncryptionStatus)

Trạng thái mã hoá từ DevicePolicyManager.
verifyAppsEnabled

boolean

Xác minh bằng 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ợ mã hoá.
INACTIVE Thiết bị có hỗ trợ 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 Chế độ mã hoá đang hoạt động.
ACTIVE_DEFAULT_KEY Quá trình mã hoá đang hoạt động nhưng người dùng chưa đặt khoá mã hoá.
ACTIVE_PER_USER Quá trình mã hoá đang diễn ra 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ị, do trạng thái hiện tại của thiết bị và các chính sách được áp dụng xác định.

Biểu diễn dưới dạng JSON 
{
  "devicePosture": enum (DevicePosture),
  "postureDetails": [
    {
      object (PostureDetail)
    }
  ]
}
Trường
devicePosture

enum (DevicePosture)

Giá trị trạng thái bảo mật của thiết bị.
postureDetails[]

object (PostureDetail)

Thông tin bổ sung về trạng thái bảo mật của thiết bị.

DevicePosture

Các giá trị có thể có về trạng thái 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ị những kẻ có hành vi xấu tấn công hơn mức khuyến nghị khi dùng với dữ liệu của công ty.
POTENTIALLY_COMPROMISED Thiết bị này có thể đã bị xâm nhập và những đố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 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 (SecurityRisk),
  "advice": [
    {
      object (UserFacingMessage)
    }
  ]
}
Trường
securityRisk

enum (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[]

object (UserFacingMessage)

Lời khuyên tương ứng dành cho quản trị viên để giảm thiểu rủi ro bảo mật này và cải thiện trạng thái bảo mật của thiết bị.

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 thất bại).
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 (kiểm tra basicIntegrity không thành công).
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 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ỉ có sẵ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 (CommonCriteriaModeStatus),
  "policySignatureVerificationStatus": enum (PolicySignatureVerificationStatus)
}
Trường
commonCriteriaModeStatus

enum (CommonCriteriaModeStatus)

Chế độ Tiêu chí chung có được bật hay không.
policySignatureVerificationStatus

enum (PolicySignatureVerificationStatus)

Chỉ có đầu ra. Trạng thái xác minh chữ ký chính sách.

CommonCriteriaModeStatus

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. Tham số này chỉ được đặt nếu statusReportingSettings.commonCriteriaModeEnabled 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ì commonCriteriaMode đượ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ợ quy trình xác minh chữ ký chính sách, chẳng hạn như vì thiết bị đã được đăng ký bằng phiên bản CloudDPC không hỗ trợ quy trình 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 này 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ừ trạng thái do một Trình điều khiển chính sách thiết bị (DPC) khác quản lý hay không.

Biểu diễn dưới dạng JSON 
{
  "previousDpc": string,
  "additionalData": string
}
Trường
previousDpc

string

Chỉ có đầu ra. Nếu thiết bị này được di chuyển từ một DPC khác, thì đây là tên gói của thiết bị. Nếu không, thông tin này sẽ không được điền sẵn.
additionalData

string

Chỉ có đầu ra. Nếu thiết bị này được di chuyển từ một DPC khác, thì trường additionalData của mã thông báo di chuyển sẽ được điền sẵn ở đây.

Phương thức

delete

 Xoá một thiết bị.

get

 Nhận một thiết bị.

issueCommand

 Ra lệnh cho một thiết bị.

list

 Liệt kê các thiết bị cho một doanh nghiệp cụ thể.

patch

 Cập nhật một thiết bị.