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)

关于 Common Criteria 模式的信息 - 信息技术安全评估通用标准 (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)

首次发布更新的时间。值为 0 表示未设置此字段。只有在有可用更新时（即 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 设备政策版本已过时，就会发生这种情况。
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 会在各种设置（甚至恢复出厂设置）后保留。在搭载 Android 12 及更高版本的设备上，具有工作资料的个人自有设备可使用此 ID。

展示广告

设备显示信息。

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,
  "iccId": string
}
字段
phoneNumber

string

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

string

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

string

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

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 检测到设备运行的是已遭到入侵的操作系统（basicIntegrity 检查失败）。
HARDWARE_BACKED_EVALUATION_FAILED 如果 device integrity 字段中未显示 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 字段。

方法

delete

 删除设备。

get

 获取设备。

issueCommand

 向设备发出命令。

list

 列出指定企业的设备。

patch

 更新设备。