REST Resource: enterprises.devices

资源：设备

归企业所有的设备。除非另有说明，否则所有字段均为只读字段，无法通过 enterprises.devices.patch 进行修改。

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)
  },
  "defaultApplicationInfo": [
    {
      object (DefaultApplicationInfo)
    }
  ]
}
字段
name

string

设备的名称，格式为 enterprises/{enterpriseId}/devices/{deviceId}。
userName

string

拥有相应设备的用户的资源名称，格式为 enterprises/{enterpriseId}/users/{userId}。
managementMode

enum (ManagementMode)

Android Device Policy 在设备上采用的管理模式类型。这会影响支持哪些政策设置。
state

enum (DeviceState)

要应用于设备的状态。此字段可通过 PATCH 请求进行修改。请注意，在调用 enterprises.devices.patch 时，只允许使用 ACTIVE 和 DISABLED 这两个值。如需使设备进入 DELETED 状态，请调用 enterprises.devices.delete。
appliedState

enum (DeviceState)

当前应用于设备的状态。
policyCompliant

boolean

设备是否符合其政策。
nonComplianceDetails[]

object (NonComplianceDetail)

设备不符合的政策设置的详细信息。
enrollmentTime

string (Timestamp format)

设备注册时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
lastStatusReportTime

string (Timestamp format)

设备上次发送状态报告的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

已弃用。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
lastPolicySyncTime

string (Timestamp format)

设备上次提取政策的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
policyName

string

应用于设备的政策的名称，格式为 enterprises/{enterpriseId}/policies/{policyId}。如果未指定，则应用设备用户的 policyName。此字段可通过 PATCH 请求进行修改。调用 enterprises.devices.patch 时，您只能指定 policyId，前提是 policyId 不包含任何斜杠。系统会推断出政策名称的其余部分。
appliedPolicyName

string

当前应用于设备的政策的名称。
appliedPolicyVersion

string (int64 format)

当前应用于设备的政策的版本。
apiLevel

integer

设备上运行的 Android 平台版本的 API 级别。
enrollmentTokenData

string

如果设备注册时使用的注册令牌提供了额外数据，则此字段包含该数据。
enrollmentTokenName

string

如果设备是通过注册令牌注册的，则此字段包含令牌的名称。
disabledReason

object (UserFacingMessage)

如果设备状态为 DISABLED，则为显示在设备上的可选消息，用于指明设备被停用的原因。此字段可通过 PATCH 请求进行修改。
softwareInfo

object (SoftwareInfo)

有关设备软件的详细信息。仅当设备的政策中 softwareInfoEnabled 为 true 时，此信息才可用。
hardwareInfo

object (HardwareInfo)

有关设备硬件的详细信息。
displays[]

object (Display)

有关设备上显示屏的详细信息。仅当设备的政策中 displayInfoEnabled 为 true 时，此信息才可用。
applicationReports[]

object (ApplicationReport)

针对设备上安装的应用生成的报告。仅当设备的政策中 applicationReportsEnabled 为 true 时，此信息才可用。
previousDeviceNames[]

string

如果同一实体设备已多次注册，此字段会包含其之前的设备名称。序列号用作唯一标识符，用于确定同一物理设备之前是否已注册。这些名称按时间顺序列出。
networkInfo

object (NetworkInfo)

设备网络信息。仅当设备的政策中 networkInfoEnabled 为 true 时，此信息才可用。
memoryInfo

object (MemoryInfo)

内存信息：包含有关设备内存和存储空间的信息。
memoryEvents[]

object (MemoryEvent)

按时间顺序排列的与内存和存储空间测量相关的事件。仅当设备的政策中 memoryInfoEnabled 为 true 时，此信息才可用。

系统会保留活动一段时间，然后删除旧活动。
powerManagementEvents[]

object (PowerManagementEvent)

设备上的电源管理事件（按时间顺序排列）。仅当设备的政策中 powerManagementEventsEnabled 为 true 时，此信息才可用。
hardwareStatusSamples[]

object (HardwareStatus)

按时间顺序排列的硬件状态样本。仅当设备的政策中 hardwareStatusEnabled 为 true 时，此信息才可用。
deviceSettings

object (DeviceSettings)

设备设置信息。仅当设备的政策中 deviceSettingsEnabled 为 true 时，此信息才可用。
user

object (User)

设备的所有者。
systemProperties

map (key: string, value: string)

与设备相关的所选系统属性名称和值的映射。仅当设备的政策中 systemPropertiesEnabled 为 true 时，此信息才可用。

包含一系列 "key": value 对的对象。示例：{ "name": "wrench", "mass": "1.3kg", "count": "3" }。
securityPosture

object (SecurityPosture)

反映设备安全程度的设备安全态势值。
ownership

enum (Ownership)

受管理设备的所有权。
commonCriteriaModeInfo

object (CommonCriteriaModeInfo)

有关 Common Criteria 模式的信息 - 信息技术安全评估通用准则 (CC) 中定义的安全标准。

仅当设备为公司所有时，此信息才可用。statusReportingSettings.commonCriteriaModeEnabledtrue
appliedPasswordPolicies[]

object (PasswordRequirements)

当前应用于设备的密码要求。

  • 此字段的存在是因为在某些情况下，应用的要求可能与 passwordPolicies 中指定的要求略有不同。
  • 请注意，此字段不提供有关密码合规性的信息。如需了解不合规情况，请参阅 nonComplianceDetails。
  • NonComplianceDetail.fieldPath 是根据 passwordPolicies 设置的，而不是根据此字段设置的。
dpcMigrationInfo

object (DpcMigrationInfo)

仅限输出。与相应设备是否已从受其他设备政策控制器 (DPC) 管理的状态迁移相关的信息。
defaultApplicationInfo[]

object (DefaultApplicationInfo)

仅限输出。DefaultApplicationType 的默认应用信息。仅当设备的政策中 defaultApplicationInfoReportingEnabled 为 true 时，此信息才可用。适用于 Android 16 及更高版本。

完全受管理的设备会报告所有应用类型。DEFAULT_BROWSER、DEFAULT_CALL_REDIRECTION、DEFAULT_CALL_SCREENING 和 DEFAULT_DIALER 类型适用于设置了工作资料的公司自有设备和个人自有设备上的工作资料。对于装有工作资料的公司自有设备，系统也会报告 DEFAULT_WALLET，但只会包含工作资料信息。

DeviceState

可应用于设备的状态。

枚举
DEVICE_STATE_UNSPECIFIED 不允许使用此值。
ACTIVE 设备处于活跃状态。
DISABLED 设备已停用。
DELETED 设备已被删除。API 调用永远不会返回此状态，但当设备确认删除时，此状态会用于最终状态报告。如果通过 API 调用删除设备，则此状态会发布到 Pub/Sub。如果用户删除工作资料或重置设备，服务器将无法获知设备状态。
PROVISIONING 设备正在配置中。新注册的设备在应用政策之前处于此状态。
LOST 设备丢失。此状态仅可能出现在组织拥有的设备上。
PREPARING_FOR_MIGRATION 设备正在准备迁移到 Android Management API。无需采取进一步行动，迁移即可继续进行。
DEACTIVATED_BY_DEVICE_FINANCE 这是由分期付款代理机构“锁定”的分期付款设备。这意味着，系统已应用某些政策设置，这些设置会限制设备功能，直到融资代理“解锁”设备为止。设备将继续应用政策设置，但由融资代理机构覆盖的政策设置除外。当设备处于“锁定”状态时，appliedState 中报告的状态为 DEACTIVATED_BY_DEVICE_FINANCE。

NonComplianceDetail

提供有关不遵守政策设置的详细信息。

JSON 表示法 
{
  "settingName": string,
  "nonComplianceReason": enum (NonComplianceReason),
  "packageName": string,
  "fieldPath": string,
  "currentValue": value,
  "installationFailureReason": enum (InstallationFailureReason),
  "specificNonComplianceReason": enum (SpecificNonComplianceReason),
  "specificNonComplianceContext": {
    object (SpecificNonComplianceContext)
  }
}
字段
settingName

string

政策设置的名称。这是顶级 Policy 字段的 JSON 字段名称。
nonComplianceReason

enum (NonComplianceReason)

设备不符合相应设置的原因。
packageName

string

指示哪个应用不合规的软件包名称（如果适用）。
fieldPath

string

对于具有嵌套字段的设置，如果某个嵌套字段不合规，则此属性会指定违规字段的完整路径。路径的格式与在 JavaScript 中引用政策 JSON 字段的方式相同，即：1) 对于对象类型的字段，字段名称后跟一个点，然后是子字段名称。2) 对于数组类型的字段，字段名称后跟用方括号括起来的数组索引。例如，如需指明第 3 个应用的 externalData 字段中的 url 字段存在问题，路径应为 applications[2].externalData.url
currentValue

value (Value format)

如果无法应用政策设置，则为设备上相应设置的当前值。
installationFailureReason

enum (InstallationFailureReason)

如果设置了 packageName 且不合规原因为 APP_NOT_INSTALLED 或 APP_NOT_UPDATED，则表示应用无法安装或更新的详细原因。
specificNonComplianceReason

enum (SpecificNonComplianceReason)

设备不符合相应设置的具体政策原因。
specificNonComplianceContext

object (SpecificNonComplianceContext)

specificNonComplianceReason 的其他上下文。

InstallationFailureReason

应用安装可能会失败的原因。

枚举
INSTALLATION_FAILURE_REASON_UNSPECIFIED 不允许使用此值。
INSTALLATION_FAILURE_REASON_UNKNOWN 某个未知情况导致无法安装应用。可能的原因包括设备存储空间不足、设备网络连接不可靠，或者安装时间超出预期。系统将自动重试安装。
IN_PROGRESS 安装仍在进行中。
NOT_FOUND 在 Play 中未找到该应用。
NOT_COMPATIBLE_WITH_DEVICE 该应用与设备不兼容。
NOT_APPROVED 应用未经管理员批准。
PERMISSIONS_NOT_ACCEPTED 应用具有管理员尚未接受的新权限。
NOT_AVAILABLE_IN_COUNTRY 应用并未在用户所在国家/地区提供。
NO_LICENSES_REMAINING 没有可分配给用户的许可。
NOT_ENROLLED 企业已取消在 Google Play 企业版中的注册，或者管理员尚未接受最新的 Google Play 企业版服务条款。
USER_INVALID 用户不再有效。用户可能已被删除或停用。
NETWORK_ERROR_UNRELIABLE_CONNECTION

用户设备上的网络错误导致安装失败。当设备的互联网连接质量下降、无法连接到互联网或存在网络配置问题时，通常会发生这种情况。请确保设备在满足 Android Enterprise Network Requirements 的网络上具有完整的互联网连接。在这种情况下，应用安装或更新会自动恢复。
INSUFFICIENT_STORAGE 用户的设备没有足够的存储空间来安装应用。可以通过清理设备上的存储空间来解决此问题。当设备有足够的存储空间时，应用安装或更新将自动恢复。

SpecificNonComplianceReason

有关设备可能不符合政策设置的原因的更多详细信息。将来可以向枚举添加新值。

枚举
SPECIFIC_NON_COMPLIANCE_REASON_UNSPECIFIED 未指定具体的不合规原因。未设置 specificNonComplianceContext 中的字段。
PASSWORD_POLICIES_USER_CREDENTIALS_CONFIRMATION_REQUIRED 用户需要输入锁屏密码来确认凭据。未设置 specificNonComplianceContext 中的字段。nonComplianceReason 设置为 USER_ACTION。
PASSWORD_POLICIES_PASSWORD_EXPIRED 设备或个人资料密码已过期。passwordPoliciesContext。nonComplianceReason 设置为 USER_ACTION。
PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT 设备密码不符合密码要求。passwordPoliciesContext。nonComplianceReason 设置为 USER_ACTION。
ONC_WIFI_INVALID_VALUE ONC Wi-Fi 配置中存在错误的值。fieldPath 用于指定哪个字段值不正确。oncWifiContext。nonComplianceReason 设置为 INVALID_VALUE。
ONC_WIFI_API_LEVEL 设备上运行的 Android 版本的 API 级别不支持 ONC Wi-Fi 设置。fieldPath 用于指定哪个字段值不受支持。oncWifiContext。nonComplianceReason 设置为 API_LEVEL。
ONC_WIFI_INVALID_ENTERPRISE_CONFIG 企业 Wi-Fi 网络缺少根 CA 或域名。nonComplianceReason 设置为 INVALID_VALUE。
ONC_WIFI_USER_SHOULD_REMOVE_NETWORK 用户需要手动移除已配置的 Wi-Fi 网络。此功能仅适用于个人自带设备上的工作资料。nonComplianceReason 设置为 USER_ACTION。
ONC_WIFI_KEY_PAIR_ALIAS_NOT_CORRESPONDING_TO_EXISTING_KEY 通过 openNetworkConfiguration 中的 ClientCertKeyPairAlias 字段指定的密钥对别名与设备上安装的现有密钥不对应。nonComplianceReason 设置为 INVALID_VALUE。
PERMISSIBLE_USAGE_RESTRICTION 此政策设置受到限制，无法为此 Google Cloud Platform 项目设置。如需了解更多详情（包括如何启用此政策设置），请参阅允许的使用情况政策。nonComplianceReason 设置为 PROJECT_NOT_PERMITTED。
REQUIRED_ACCOUNT_NOT_IN_ENTERPRISE workAccountSetupConfig 政策设置所需的工作账号已不再属于企业。nonComplianceReason 设置为 USER_ACTION。
NEW_ACCOUNT_NOT_IN_ENTERPRISE 用户添加的工作账号不属于相应企业。nonComplianceReason 设置为 USER_ACTION。
DEFAULT_APPLICATION_SETTING_UNSUPPORTED_SCOPES

即使管理模式本身支持相应应用类型，默认应用设置也会应用于管理模式不支持的范围（例如，如果向完全受管理设备发送了具有 DEFAULT_BROWSER 应用类型和 [SCOPE_PERSONAL_PROFILE] 列表的政策，则相应范围不适用于该管理模式）。如果应用类型不支持管理模式，则会报告 NonComplianceDetail（包含 MANAGEMENT_MODE），但不包含 specificNonComplianceReason。

nonComplianceReason 设置为 MANAGEMENT_MODE。
DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE 未能针对特定范围应用默认应用设置。defaultApplicationContext。将 nonComplianceReason 设置为 INVALID_VALUE 或 APP_NOT_INSTALLED。

SpecificNonComplianceContext

SpecificNonComplianceReason 的其他上下文。

JSON 表示法 
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  },
  "defaultApplicationContext": {
    object (DefaultApplicationContext)
  }
}
字段
oncWifiContext

object (OncWifiContext)

与 Wi-Fi 配置相关的不合规情况的其他背景信息。请参阅ONC_WIFI_INVALID_VALUE和ONC_WIFI_API_LEVEL
passwordPoliciesContext

object (PasswordPoliciesContext)

有关密码政策违规行为的其他背景信息。请参阅 PASSWORD_POLICIES_PASSWORD_EXPIRED 和 PASSWORD_POLICIES_PASSWORD_NOT_SUFFICIENT。
defaultApplicationContext

object (DefaultApplicationContext)

仅限输出。与默认应用设置相关的不合规情况的更多背景信息。请参阅 DEFAULT_APPLICATION_SETTING_FAILED_FOR_SCOPE。

OncWifiContext

与 Wi-Fi 配置相关的不合规情况的其他上下文。

JSON 表示法 
{
  "wifiGuid": string
}
字段
wifiGuid

string

不合规的 Wi-Fi 配置的 GUID。

PasswordPoliciesContext

有关密码政策违规行为的其他背景信息。

JSON 表示法 
{
  "passwordPolicyScope": enum (PasswordPolicyScope)
}
字段
passwordPolicyScope

enum (PasswordPolicyScope)

不合规密码的范围。

DefaultApplicationContext

与默认应用设置相关的不合规情况的其他背景信息。

JSON 表示法 
{
  "defaultApplicationScope": enum (DefaultApplicationScope)
}
字段
defaultApplicationScope

enum (DefaultApplicationScope)

仅限输出。不合规的默认应用设置的范围。

SoftwareInfo

设备软件信息。

JSON 表示法 
{
  "androidVersion": string,
  "androidDevicePolicyVersionCode": integer,
  "androidDevicePolicyVersionName": string,
  "androidBuildNumber": string,
  "deviceKernelVersion": string,
  "bootloaderVersion": string,
  "androidBuildTime": string,
  "securityPatchLevel": string,
  "primaryLanguageCode": string,
  "deviceBuildSignature": string,
  "systemUpdateInfo": {
    object (SystemUpdateInfo)
  }
}
字段
androidVersion

string

用户可见的 Android 版本字符串。例如 6.0.1。
androidDevicePolicyVersionCode

integer

Android Device Policy 应用的版本代码。
androidDevicePolicyVersionName

string

向用户显示的 Android Device Policy 应用版本。
androidBuildNumber

string

旨在向用户显示的 Android build ID 字符串。例如 shamu-userdebug 6.0.1 MOB30I 2756745 dev-keys。
deviceKernelVersion

string

内核版本，例如 2.6.32.9-g103d848。
bootloaderVersion

string

系统引导加载程序版本号，例如 0.6.7。
androidBuildTime

string (Timestamp format)

构建时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
securityPatchLevel

string

安全补丁级别，例如 2016-05-01。
primaryLanguageCode

string

设备上主要语言区域的 IETF BCP 47 语言代码。
deviceBuildSignature

string

与系统软件包关联的 android.content.pm.Signature 的 SHA-256 哈希值，可用于验证系统 build 是否未被修改。
systemUpdateInfo

object (SystemUpdateInfo)

有关潜在的待处理系统更新的信息。

SystemUpdateInfo

有关潜在的待处理系统更新的信息。

JSON 表示法 
{
  "updateStatus": enum (UpdateStatus),
  "updateReceivedTime": string
}
字段
updateStatus

enum (UpdateStatus)

更新的状态：是否存在更新以及更新的类型。
updateReceivedTime

string (Timestamp format)

相应更新首次可用的时间。值为 0 表示未设置相应字段。仅当有更新可用时（即 updateStatus 既不是 UPDATE_STATUS_UNKNOWN 也不是 UP_TO_DATE），才会设置此字段。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

UpdateStatus

更新的状态：是否存在更新以及更新的类型。

枚举
UPDATE_STATUS_UNKNOWN 未知是否有待处理的系统更新。例如，当设备 API 级别低于 26 或 Android 设备政策版本过时时，就会发生这种情况。
UP_TO_DATE 设备上没有待处理的系统更新。
UNKNOWN_UPDATE_AVAILABLE 有待处理的系统更新可用，但其类型未知。
SECURITY_UPDATE_AVAILABLE 有待处理的安全更新。
OS_UPDATE_AVAILABLE 有待处理的操作系统更新。

HardwareInfo

有关设备硬件的信息。只有当设备的政策中 hardwareStatusEnabled 为 true 时，与温度阈值相关的字段才可用。

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)
    }
  ]
}
字段
brand

string

设备的品牌。例如 Google。
hardware

string

硬件的名称。例如 Angler。
deviceBasebandVersion

string

基带版本。例如 MDM9625_104662.22.05.34p。
manufacturer

string

制造商。例如 Motorola。
serialNumber

string

设备序列号。不过，对于搭载 Android 12 及更高版本的个人自有设备，此值与 enterpriseSpecificId 相同。
model

string

设备的型号。例如 Asus Nexus 7。
batteryShutdownTemperatures[]

number

设备上每块电池的电池关机温度阈值（以摄氏度为单位）。
batteryThrottlingTemperatures[]

number

设备上每块电池的电池节流温度阈值（以摄氏度为单位）。
cpuShutdownTemperatures[]

number

设备上每个 CPU 的 CPU 关闭温度阈值（以摄氏度为单位）。
cpuThrottlingTemperatures[]

number

设备上每个 CPU 的 CPU 节流温度阈值（以摄氏度为单位）。
gpuShutdownTemperatures[]

number

设备上每个 GPU 的 GPU 关闭温度阈值（以摄氏度为单位）。
gpuThrottlingTemperatures[]

number

设备上每个 GPU 的 GPU 节流温度阈值（以摄氏度为单位）。
skinShutdownTemperatures[]

number

设备表面关机温度阈值（以摄氏度为单位）。
skinThrottlingTemperatures[]

number

设备表面温度节流阈值（以摄氏度为单位）。
enterpriseSpecificId

string

仅限输出。唯一标识特定组织中个人自有设备的 ID。在同一实体设备上，如果注册到同一组织，此 ID 会在设置过程中甚至在恢复出厂设置后保持不变。此 ID 适用于搭载 Android 12 及更高版本且设有工作资料的个人自有设备。
euiccChipInfo[]

object (EuiccChipInfo)

仅限输出。与 eUICC 芯片相关的信息。

EuiccChipInfo

与 eUICC 芯片相关的信息。

JSON 表示法 
{
  "eid": string
}
字段
eid

string

仅限输出。用于标识设备上每个 eUICC 芯片的嵌入式身份文件 (EID)。此功能适用于搭载 Android 13 及更高版本的公司自有设备。

显示

设备显示信息。

JSON 表示法 
{
  "name": string,
  "displayId": integer,
  "refreshRate": integer,
  "state": enum (DisplayState),
  "width": integer,
  "height": integer,
  "density": integer
}
字段
name

string

显示屏的名称。
displayId

integer

唯一展示 ID。
refreshRate

integer

显示屏的刷新率（以每秒帧数为单位）。
state

enum (DisplayState)

显示屏的状态。
width

integer

显示宽度（以像素为单位）。
height

integer

显示高度（以像素为单位）。
density

integer

显示密度，以每英寸的点数表示。

DisplayState

显示屏的状态。

枚举
DISPLAY_STATE_UNSPECIFIED 不允许使用此值。
OFF 显示屏处于关闭状态。
ON 显示屏处于开启状态。
DOZE 显示屏在低功耗状态下处于休眠状态
SUSPENDED 显示屏处于休眠状态，即低功耗的暂停状态。

ApplicationReport

有关已安装应用的报告信息。

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)
}
字段
packageName

string

应用的软件包名称。
versionName

string

向用户显示的应用版本。
versionCode

integer

应用版本代码，可用于确定某个版本是否比另一个版本更新。
events[]

object (ApplicationEvent)

过去 30 小时内发生的应用事件的列表。
displayName

string

应用的显示名称。
packageSha256Hash

string

应用的 APK 文件的 SHA-256 哈希值，可用于验证应用是否已被修改。哈希值的每个字节都以两位十六进制数表示。
signingKeyCertFingerprints[]

string

与应用软件包关联的每个 android.content.pm.Signature 的 SHA-1 哈希值。每个哈希值的每个字节都表示为两位十六进制数。
installerPackageName

string

安装相应应用的应用的软件包名称。
applicationSource

enum (ApplicationSource)

软件包的来源。
state

enum (ApplicationState)

应用状态。
keyedAppStates[]

object (KeyedAppState)

应用报告的键控应用状态列表。
userFacingType

enum (UserFacingType)

应用是否面向用户。

ApplicationEvent

与应用相关的事件。

JSON 表示法 
{
  "eventType": enum (ApplicationEventType),
  "createTime": string
}
字段
eventType

enum (ApplicationEventType)

应用事件类型。
createTime

string (Timestamp format)

活动的创建时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

ApplicationEventType

一种与应用相关的事件。

枚举
APPLICATION_EVENT_TYPE_UNSPECIFIED 不允许使用此值。
INSTALLED 应用已安装。
CHANGED 应用已更改，例如某个组件已启用或停用。
DATA_CLEARED 应用数据已被清除。
REMOVED 应用已被移除。
REPLACED 已安装新版应用，替换旧版应用。
RESTARTED 应用已重启。
PINNED 应用已固定到前台。
UNPINNED 应用已取消固定。

ApplicationSource

提供应用的来源。

枚举
APPLICATION_SOURCE_UNSPECIFIED 应用是从未指定的来源旁加载的。
SYSTEM_APP_FACTORY_VERSION 这是设备出厂映像中的系统应用。
SYSTEM_APP_UPDATED_VERSION 这是更新后的系统应用。
INSTALLED_FROM_PLAY_STORE 应用是从 Google Play 商店安装的。
CUSTOM 应用是使用 AMAPI SDK 命令安装的。另请参阅：CUSTOM

ApplicationState

当前安装状态。

枚举
APPLICATION_STATE_UNSPECIFIED 应用状态未指定
REMOVED 应用已从设备中移除
INSTALLED 应用已安装在设备上

KeyedAppState

应用报告的键控应用状态。

JSON 表示法 
{
  "key": string,
  "severity": enum (Severity),
  "message": string,
  "data": string,
  "createTime": string,
  "lastUpdateTime": string
}
字段
key

string

应用状态的键。充当应用提供状态的参考点。例如，在提供受管配置反馈时，此键可以是受管配置键。
severity

enum (Severity)

应用状态的严重程度。
message

string

可选，用于说明应用状态的自由格式消息字符串。如果状态是由特定值（例如受管理的配置值）触发的，则应将其包含在消息中。
data

string

（可选）供 EMM 读取的机器可读值。例如，设置管理员可在 EMM 控制台中选择进行查询的值（例如“如果 battery_warning 数据 < 10，请通知我”）。
createTime

string (Timestamp format)

设备上应用状态的创建时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
lastUpdateTime

string (Timestamp format)

应用状态最近一次更新的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

严重程度

应用状态的严重程度。

枚举
SEVERITY_UNSPECIFIED 未指定严重程度。
INFO 信息严重程度级别。
ERROR 错误严重程度。只有在出现管理组织需要采取行动来修复的真正错误情况时，才应设置此值。

UserFacingType

应用是否面向用户。

枚举
USER_FACING_TYPE_UNSPECIFIED 面向应用用户的类型未指定。
NOT_USER_FACING 应用不面向用户。
USER_FACING 应用面向用户。

NetworkInfo

设备网络信息。

JSON 表示法 
{
  "imei": string,
  "meid": string,
  "wifiMacAddress": string,
  "networkOperatorName": string,
  "telephonyInfos": [
    {
      object (TelephonyInfo)
    }
  ]
}
字段
imei

string

GSM 设备的 IMEI 号码。例如 A1000031212。
meid

string

CDMA 设备的 MEID 号。例如 A00000292788E1。
wifiMacAddress

string

设备的 Wi-Fi MAC 地址。例如 7c:11:11:11:11:11。
networkOperatorName
(deprecated)

string

当前已注册运营商的字母名称。例如，Vodafone。
telephonyInfos[]

object (TelephonyInfo)

提供与设备上每张 SIM 卡关联的电话信息。仅在从 Android API 级别 23 开始的完全受管设备上受支持。

TelephonyInfo

设备上与指定 SIM 卡关联的电话信息。仅在从 Android API 级别 23 开始的完全受管设备上受支持。

JSON 表示法 
{
  "phoneNumber": string,
  "carrierName": string,
  "iccId": string,
  "activationState": enum (ActivationState),
  "configMode": enum (ConfigMode)
}
字段
phoneNumber

string

与此 SIM 卡关联的电话号码。
carrierName

string

与此 SIM 卡关联的运营商名称。
iccId

string

仅限输出。与此 SIM 卡关联的 ICCID。
activationState

enum (ActivationState)

仅限输出。设备上 SIM 卡的激活状态。此方法仅适用于 eSIM 卡。所有搭载 API 级别 35 及更高版本的设备均支持此功能。对于实体 SIM 卡和 API 级别低于 35 的设备，此值始终为 ACTIVATION_STATE_UNSPECIFIED。
configMode

enum (ConfigMode)

仅限输出。设备上 SIM 卡的配置模式。此方法仅适用于 eSIM 卡。所有搭载 API 级别 35 及更高版本的设备均支持此功能。对于实体 SIM 卡和 API 级别低于 35 的设备，此值始终为 CONFIG_MODE_UNSPECIFIED。

激活状态

设备上 SIM 卡的激活状态。

枚举
ACTIVATION_STATE_UNSPECIFIED 未指定激活状态。
ACTIVATED SIM 卡已激活。
NOT_ACTIVATED SIM 卡未激活。

ConfigMode

设备上 SIM 卡的配置模式。

枚举
CONFIG_MODE_UNSPECIFIED 配置模式未指定。
ADMIN_CONFIGURED 管理员已配置此 SIM 卡。
USER_CONFIGURED 用户已配置此 SIM 卡。

MemoryInfo

有关设备内存和存储空间的信息。

JSON 表示法 
{
  "totalRam": string,
  "totalInternalStorage": string
}
字段
totalRam

string (int64 format)

设备上的总 RAM（以字节为单位）。
totalInternalStorage

string (int64 format)

设备上的总内部存储空间（以字节为单位）。

MemoryEvent

与内存和存储空间测量相关的事件。

为了区分新旧事件，我们建议使用 createTime 字段。

JSON 表示法 
{
  "eventType": enum (MemoryEventType),
  "createTime": string,
  "byteCount": string
}
字段
eventType

enum (MemoryEventType)

事件类型。
createTime

string (Timestamp format)

活动的创建时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
byteCount

string (int64 format)

介质中的可用字节数；对于 EXTERNAL_STORAGE_DETECTED，则为存储介质的总容量（以字节为单位）。

MemoryEventType

事件的类型。

枚举
MEMORY_EVENT_TYPE_UNSPECIFIED 未指定。没有活动属于此类型。
RAM_MEASURED 测量了 RAM 中的可用空间。
INTERNAL_STORAGE_MEASURED 测量了内部存储空间中的可用空间。
EXTERNAL_STORAGE_DETECTED 检测到新的外部存储介质。报告的字节数是存储介质的总容量。
EXTERNAL_STORAGE_REMOVED 外部存储介质已被移除。报告的字节数为零。
EXTERNAL_STORAGE_MEASURED 测量了外部存储介质中的可用空间。

PowerManagementEvent

电源管理事件。

JSON 表示法 
{
  "eventType": enum (PowerManagementEventType),
  "createTime": string,
  "batteryLevel": number
}
字段
eventType

enum (PowerManagementEventType)

事件类型。
createTime

string (Timestamp format)

活动的创建时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
batteryLevel

number

对于 BATTERY_LEVEL_COLLECTED 事件，电池电量（以百分比表示）。

PowerManagementEventType

事件的类型。

枚举
POWER_MANAGEMENT_EVENT_TYPE_UNSPECIFIED 未指定。没有活动属于此类型。
BATTERY_LEVEL_COLLECTED 已测量电池电量。
POWER_CONNECTED 设备开始充电。
POWER_DISCONNECTED 设备停止充电。
BATTERY_LOW 设备进入了低电耗模式。
BATTERY_OKAY 设备退出了低电耗模式。
BOOT_COMPLETED 设备已启动。
SHUTDOWN 设备已关机。

HardwareStatus

硬件状态。可以将温度与 hardwareInfo 中提供的温度阈值进行比较，以确定硬件健康状况。

JSON 表示法 
{
  "createTime": string,
  "batteryTemperatures": [
    number
  ],
  "cpuTemperatures": [
    number
  ],
  "gpuTemperatures": [
    number
  ],
  "skinTemperatures": [
    number
  ],
  "fanSpeeds": [
    number
  ],
  "cpuUsages": [
    number
  ]
}
字段
createTime

string (Timestamp format)

进行测量的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
batteryTemperatures[]

number

设备上每块电池的当前电池温度（以摄氏度为单位）。
cpuTemperatures[]

number

设备上每个 CPU 的当前 CPU 温度（以摄氏度为单位）。
gpuTemperatures[]

number

设备上每个 GPU 的当前 GPU 温度（以摄氏度为单位）。
skinTemperatures[]

number

当前设备体表温度（以摄氏度为单位）。
fanSpeeds[]

number

设备上每个风扇的转速（以 RPM 为单位）。空数组表示系统上没有风扇，或者不支持风扇转速。
cpuUsages[]

number

设备上每个可用核心的 CPU 使用率（以百分比表示）。对于每个未插电的核心，用量为 0。空数组表示系统不支持 CPU 使用情况。

DeviceSettings

设备上与安全相关的设备设置方面的信息。

JSON 表示法 
{
  "isDeviceSecure": boolean,
  "unknownSourcesEnabled": boolean,
  "developmentSettingsEnabled": boolean,
  "adbEnabled": boolean,
  "isEncrypted": boolean,
  "encryptionStatus": enum (EncryptionStatus),
  "verifyAppsEnabled": boolean
}
字段
isDeviceSecure

boolean

设备是否已启用 PIN 码/密码安全保护。
unknownSourcesEnabled

boolean

是否已启用安装未知来源的应用。
developmentSettingsEnabled

boolean

设备上是否已启用开发者模式。
adbEnabled

boolean

设备上是否已启用 ADB。
isEncrypted

boolean

存储加密是否已启用。
encryptionStatus

enum (EncryptionStatus)

来自 DevicePolicyManager 的加密状态。
verifyAppsEnabled

boolean

设备上是否强制执行 Google Play 保护机制验证。

EncryptionStatus

设备的加密状态。

枚举
ENCRYPTION_STATUS_UNSPECIFIED 未指定。任何设备都不应具有此类型。
UNSUPPORTED 设备不支持加密。
INACTIVE 设备支持加密，但目前未启用。
ACTIVATING 加密功能目前未启用，但正在启用。
ACTIVE 加密处于有效状态。
ACTIVE_DEFAULT_KEY 加密处于有效状态，但用户未设置加密密钥。
ACTIVE_PER_USER 加密处于有效状态，并且加密密钥与用户个人资料相关联。

SecurityPosture

设备的安全性状况，由当前设备状态和应用的政策决定。

JSON 表示法 
{
  "devicePosture": enum (DevicePosture),
  "postureDetails": [
    {
      object (PostureDetail)
    }
  ]
}
字段
devicePosture

enum (DevicePosture)

设备的安全状况值。
postureDetails[]

object (PostureDetail)

有关设备安全状况的其他详细信息。

DevicePosture

受管理设备的可能安全态势值。

枚举
POSTURE_UNSPECIFIED 未指定。此安全状况值没有安全状况详情。
SECURE 此设备安全无虞。
AT_RISK 与建议用于公司数据的设备相比，此设备可能更容易受到恶意操作者的攻击。
POTENTIALLY_COMPROMISED 此设备可能已被破解，未经授权的恶意方可能可以访问公司数据。

PostureDetail

有关设备安全状况的其他详细信息。

JSON 表示法 
{
  "securityRisk": enum (SecurityRisk),
  "advice": [
    {
      object (UserFacingMessage)
    }
  ]
}
字段
securityRisk

enum (SecurityRisk)

一种会给设备的安全状况带来负面影响的特定安全风险。
advice[]

object (UserFacingMessage)

面向管理员的相应建议，用于缓解此安全风险并改善设备的安全状况。

SecurityRisk

导致设备处于非最安全状态的风险。

枚举
SECURITY_RISK_UNSPECIFIED 未指定。
UNKNOWN_OS Play Integrity API 检测到设备正在运行未知操作系统（basicIntegrity 检查成功，但 ctsProfileMatch 失败）。
COMPROMISED_OS Play Integrity API 检测到设备正在运行遭入侵的操作系统（basicIntegrity 检查失败）。
HARDWARE_BACKED_EVALUATION_FAILED 如果 设备完整性字段中未显示 MEETS_STRONG_INTEGRITY 标签，则 Play Integrity API 会检测到设备没有强有力的系统完整性保证。

CommonCriteriaModeInfo

有关 Common Criteria 模式的信息 - 信息技术安全评估通用准则 (CC) 中定义的安全标准。

只有当设备的政策中 statusReportingSettings.commonCriteriaModeEnabled 为 true 时，此信息才可用。

JSON 表示法 
{
  "commonCriteriaModeStatus": enum (CommonCriteriaModeStatus),
  "policySignatureVerificationStatus": enum (PolicySignatureVerificationStatus)
}
字段
commonCriteriaModeStatus

enum (CommonCriteriaModeStatus)

Common Criteria 模式是否已启用。
policySignatureVerificationStatus

enum (PolicySignatureVerificationStatus)

仅限输出。政策签名验证的状态。

CommonCriteriaModeStatus

Common Criteria 模式是否已启用。

枚举
COMMON_CRITERIA_MODE_STATUS_UNKNOWN 未知状态。
COMMON_CRITERIA_MODE_DISABLED Common Criteria 模式目前处于停用状态。
COMMON_CRITERIA_MODE_ENABLED Common Criteria 模式目前处于启用状态。

PolicySignatureVerificationStatus

政策签名验证的状态。

枚举
POLICY_SIGNATURE_VERIFICATION_STATUS_UNSPECIFIED 未指定。未报告验证状态。仅当 statusReportingSettings.commonCriteriaModeEnabled 为 false 时才会设置此字段。
POLICY_SIGNATURE_VERIFICATION_DISABLED 由于 commonCriteriaMode 设置为 false，因此设备上的政策签名验证处于停用状态。
POLICY_SIGNATURE_VERIFICATION_SUCCEEDED 政策签名验证成功。
POLICY_SIGNATURE_VERIFICATION_NOT_SUPPORTED 不支持政策签名验证，例如，设备已注册的 CloudDPC 版本不支持政策签名验证。
POLICY_SIGNATURE_VERIFICATION_FAILED 政策签名验证失败。政策尚未应用。

DpcMigrationInfo

与相应设备是否已从受其他设备政策控制器 (DPC) 管理的状态迁移相关的信息。

JSON 表示法 
{
  "previousDpc": string,
  "additionalData": string
}
字段
previousDpc

string

仅限输出。如果相应设备是从其他 DPC 迁移的，则这是其软件包名称。否则不填充。
additionalData

string

仅限输出。如果相应设备是从其他 DPC 迁移过来的，则迁移令牌的 additionalData 字段会在此处填充。

DefaultApplicationInfo

特定 DefaultApplicationType 的默认应用信息。

JSON 表示法 
{
  "defaultApplicationType": enum (DefaultApplicationType),
  "packageName": string,
  "defaultApplicationSettingAttempts": [
    {
      object (DefaultApplicationSettingAttempt)
    }
  ]
}
字段
defaultApplicationType

enum (DefaultApplicationType)

仅限输出。默认应用类型。
packageName

string

仅限输出。当前默认应用的软件包名称。
defaultApplicationSettingAttempts[]

object (DefaultApplicationSettingAttempt)

仅限输出。有关默认应用设置尝试的详细信息，按 defaultApplications 中列出的顺序排列。

DefaultApplicationSettingAttempt

有关默认应用设置尝试的详细信息。

JSON 表示法 
{
  "packageName": string,
  "attemptOutcome": enum (AttemptOutcome)
}
字段
packageName

string

仅限输出。尝试的应用的软件包名称。
attemptOutcome

enum (AttemptOutcome)

仅限输出。将应用设为默认应用后的结果。

AttemptOutcome

将应用设为默认应用后的结果。

枚举
ATTEMPT_OUTCOME_UNSPECIFIED 尝试结果未指定。未使用。
SUCCESS 已成功将应用设为默认应用。
APP_NOT_INSTALLED 尝试失败，因为应用未安装。
APP_SIGNING_CERT_MISMATCH 尝试失败，因为 Play 商店或 ApplicationPolicy.signingKeyCerts 中的应用的签名密钥证书指纹与设备上的指纹不一致。
OTHER_FAILURE 尝试失败，原因如下。

方法

delete

 删除设备。

get

 获取设备。

issueCommand

 向设备发出命令。

list

 列出指定企业的设备。

patch

 更新设备。