REST Resource: enterprises.devices

资源：Device

归企业所有的设备。除非另有说明，否则所有字段均为只读字段，无法由 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)
  }
}
字段
name

string

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

string

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

enum (ManagementMode)

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

enum (DeviceState)

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

enum (DeviceState)

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

boolean

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

object (NonComplianceDetail)

详细了解设备不符合的政策设置。
enrollmentTime

string (Timestamp format)

设备注册的时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
lastStatusReportTime

string (Timestamp format)

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

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
lastPolicyComplianceReportTime
(deprecated)

string (Timestamp format)

已弃用。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
lastPolicySyncTime

string (Timestamp format)

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

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
policyName

string

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

string

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

string (int64 format)

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

integer

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

string

如果设备是通过注册令牌注册的，并提供了其他数据，则此字段会包含这些数据。
enrollmentTokenName

string

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

object (UserFacingMessage)

如果设备状态为 DISABLED，设备上会显示一条可选消息，用于说明设备停用原因。此字段可通过修补请求进行修改。
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)

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

只有当设备的政策中为公司自有设备中的 statusReportingSettings.commonCriteriaModeEnabled 设为 true 时，系统才会显示此信息。
appliedPasswordPolicies[]

object (PasswordRequirements)

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

  • 在某些情况下，适用的要求可能与 passwordPolicies 中指定的要求略有不同。
  • “fieldPath”是根据 passwordPolicies 设置的。
dpcMigrationInfo

object (DpcMigrationInfo)

仅限输出。有关此设备是否迁移而不再受其他设备政策控制器 (DPC) 管理的信息。

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。

SpecificNonComplianceContext

SpecificNonComplianceReason 的其他上下文。

JSON 表示法 
{
  "oncWifiContext": {
    object (OncWifiContext)
  },
  "passwordPoliciesContext": {
    object (PasswordPoliciesContext)
  }
}
字段
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》。

OncWifiContext

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

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

string

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

PasswordPoliciesContext

与密码政策相关的不合规行为的其他背景信息。

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

enum (PasswordPolicyScope)

不合规的密码的范围。

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)

构建时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
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)

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

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

UpdateStatus

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

枚举
UPDATE_STATUS_UNKNOWN 不知道是否有待处理的系统更新。例如，当设备 API 级别低于 26 或 Android Device Policy 版本已过时。
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
}
字段
brand

string

设备的品牌。例如 Google。
hardware

string

硬件的名称。例如 Angler。
deviceBasebandVersion

string

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

string

制造商。例如 Motorola。
serialNumber

string

设备序列号。
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 及更高版本的设备）。

显示

设备显示信息。

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)

事件的创建时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

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 商店安装的。

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)

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

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
lastUpdateTime

string (Timestamp format)

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

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

严重程度

应用状态的严重程度。

枚举
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
}
字段
phoneNumber

string

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

string

与此 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)

事件的创建时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
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)

事件的创建时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
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)

进行测量的时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
batteryTemperatures[]

number

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

number

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

number

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

number

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

number

设备上每个风扇的风扇转速（以每千次展示收入为单位）。空数组表示没有风扇，或者系统不支持风扇转速。
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 检测到设备正在运行遭破解的操作系统（基本完整性检查失败）。
HARDWARE_BACKED_EVALUATION_FAILED 如果设备完整性字段中未显示 MEETS_STRONG_INTEGRITY 标签，Play Integrity API 会检测到设备无法强有力的系统完整性保证。

CommonCriteriaModeInfo

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

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

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

enum (CommonCriteriaModeStatus)

表示是否启用了通用条件模式。

CommonCriteriaModeStatus

表示是否启用了通用条件模式。

枚举
COMMON_CRITERIA_MODE_STATUS_UNKNOWN 未知状态。
COMMON_CRITERIA_MODE_DISABLED 通用标准模式目前已停用。
COMMON_CRITERIA_MODE_ENABLED 通用标准模式目前已启用。

DpcMigrationInfo

有关此设备是否迁移而不再受其他设备政策控制器 (DPC) 管理的信息。

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

string

仅限输出。如果此设备从其他 DPC 迁移过来，则为其软件包名称。否则不填充。
additionalData

string

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

方法

delete

 删除设备。

get

 获取设备。

issueCommand

 向设备发出命令。

list

 列出指定企业的设备。

patch

 更新设备。