资源:ChromeOsDevice
Google Chrome 设备搭载的是 Chrome 操作系统。要详细了解常见的 API 任务,请参阅开发者指南。
JSON 表示法 |
---|
{ "deviceId": string, "serialNumber": string, "status": string, "lastSync": string, "supportEndDate": string, "annotatedUser": string, "annotatedLocation": string, "notes": string, "model": string, "meid": string, "orderNumber": string, "willAutoRenew": boolean, "osVersion": string, "platformVersion": string, "firmwareVersion": string, "macAddress": string, "bootMode": string, "lastEnrollmentTime": string, "kind": string, "recentUsers": [ { "type": string, "email": string } ], "activeTimeRanges": [ { "activeTime": integer, "date": string } ], "ethernetMacAddress": string, "annotatedAssetId": string, "etag": string, "diskVolumeReports": [ { "volumeInfo": [ { "volumeId": string, "storageTotal": string, "storageFree": string } ] } ], "systemRamTotal": string, "cpuStatusReports": [ { "reportTime": string, "cpuUtilizationPercentageInfo": [ integer ], "cpuTemperatureInfo": [ { "temperature": integer, "label": string } ] } ], "cpuInfo": [ { "model": string, "architecture": string, "maxClockSpeedKhz": integer, "logicalCpus": [ { "maxScalingFrequencyKhz": integer, "currentScalingFrequencyKhz": integer, "idleDuration": string, "cStates": [ { "displayName": string, "sessionDuration": string } ] } ] } ], "deviceFiles": [ { "name": string, "type": string, "downloadUrl": string, "createTime": string } ], "systemRamFreeReports": [ { "reportTime": string, "systemRamFreeInfo": [ string ] } ], "lastKnownNetwork": [ { "ipAddress": string, "wanIpAddress": string } ], "autoUpdateExpiration": string, "ethernetMacAddress0": string, "dockMacAddress": string, "manufactureDate": string, "orgUnitPath": string, "tpmVersionInfo": { "family": string, "specLevel": string, "manufacturer": string, "tpmModel": string, "firmwareVersion": string, "vendorSpecific": string }, "screenshotFiles": [ { "name": string, "type": string, "downloadUrl": string, "createTime": string } ], "orgUnitId": string, "osUpdateStatus": { object ( |
字段 | |
---|---|
deviceId |
Chrome 设备的唯一 ID。 |
serialNumber |
启用设备时输入的 Chrome 设备序列号。此值与管理控制台中 Chrome 操作系统设备标签页中的序列号相同。 |
status |
设备的状态。 可接受的值为:
|
lastSync |
上次使用管理控制台中的政策设置同步该设备的日期和时间。该值采用 ISO 8601 日期和时间格式。时间是完整日期加时、分、秒,格式为 |
supportEndDate |
支持此设备的最后日期。这仅适用于直接从 Google 购买的设备。该值采用 ISO 8601 日期和时间格式。时间是完整日期加时、分、秒,格式为 |
annotatedUser |
管理员注明的设备用户。长度上限为 100 个字符。允许空值。 |
annotatedLocation |
管理员注明的设备地址或位置。长度上限为 |
notes |
管理员添加的有关此设备的备注。您可以使用 list 方法的 |
model |
设备的型号信息。如果设备没有此信息,则响应中将不会包含此属性。 |
meid |
移动设备上的 3G 移动卡的移动设备标识符 (MEID) 或国际移动设备识别码 (IMEI)。MEID/IMEI 通常用于将设备添加到无线运营商的后付费服务计划。如果设备没有此信息,则响应中将不会包含此属性。如需详细了解如何导出 MEID/IMEI 列表,请参阅开发者指南。 |
orderNumber |
设备的订单号。只有直接从 Google 购买的设备才有订单号。 |
willAutoRenew |
确定设备是否在支持结束日期之后自动续订支持。这是一个只读属性。 |
osVersion |
Chrome 设备的操作系统版本。 |
platformVersion |
Chrome 设备的平台版本。 |
firmwareVersion |
Chrome 设备的固件版本。 |
macAddress |
设备的无线 MAC 地址。如果设备没有此信息,则不会将其包含在响应中。 |
bootMode |
设备的启动模式。可能的值包括:
|
lastEnrollmentTime |
上次注册设备的日期和时间。该值采用 ISO 8601 日期和时间格式。时间是完整日期加时、分、秒,格式为 |
kind |
资源类型。对于 Chromeosdevices 资源,该值为 |
recentUsers[] |
按上次登录时间降序排列的近期设备用户列表。 |
recentUsers[].type |
用户的类型。 可接受的值为:
|
recentUsers[].email |
用户的电子邮件地址。仅当用户类型为 |
activeTimeRanges[] |
有效时间范围(只读)的列表。 |
activeTimeRanges[].activeTime |
使用时长(以毫秒为单位)。 |
activeTimeRanges[].date |
使用日期。 |
ethernetMacAddress |
设备在以太网网络接口上的 MAC 地址。 |
annotatedAssetId |
管理员注明的或在注册期间指定的资产标识符。 |
etag |
资源的 ETag。 |
diskVolumeReports[] |
磁盘空间报告,以及与已装载/已连接的卷相关的其他信息。 |
diskVolumeReports[].volumeInfo[] |
磁盘卷 |
diskVolumeReports[].volumeInfo[].volumeId |
卷 ID |
diskVolumeReports[].volumeInfo[].storageTotal |
总磁盘空间 [以字节为单位] |
diskVolumeReports[].volumeInfo[].storageFree |
可用磁盘空间 [以字节为单位] |
systemRamTotal |
设备端 RAM 总容量(以字节为单位) |
cpuStatusReports[] |
关于 CPU 利用率和温度的报告(只读) |
cpuStatusReports[].reportTime |
收到报告的日期和时间。 |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
|
cpuStatusReports[].cpuTemperatureInfo[] |
CPU 温度样本列表。 |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
温度(以摄氏度为单位)。 |
cpuStatusReports[].cpuTemperatureInfo[].label |
CPU 标签 |
cpuInfo[] |
有关设备 CPU 规格的信息。 |
cpuInfo[].model |
CPU 型号名称。 |
cpuInfo[].architecture |
CPU 架构。 |
cpuInfo[].maxClockSpeedKhz |
最大 CPU 时钟速度,以 kHz 为单位。 |
cpuInfo[].logicalCpus[] |
逻辑 CPU 的信息 |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
根据政策,允许 CPU 运行的最高频率。 |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
CPU 运行的当前频率。 |
cpuInfo[].logicalCpus[].idleDuration |
自上次启动以来的空闲时间。 时长以秒为单位,最多包含九个小数位,以“ |
cpuInfo[].logicalCpus[].cStates[] |
C 状态指示 CPU 的功耗状态。如需了解详情,请参阅 CPU 制造商发布的文档。 |
cpuInfo[].logicalCpus[].cStates[].displayName |
州/省/自治区/直辖市名称。 |
cpuInfo[].logicalCpus[].cStates[].sessionDuration |
自上次重新启动后处于该状态所花费的时间。 时长以秒为单位,最多包含九个小数位,以“ |
deviceFiles[] |
要下载的设备文件的列表(只读) |
deviceFiles[].name |
文件名 |
deviceFiles[].type |
文件类型 |
deviceFiles[].downloadUrl |
文件下载网址 |
deviceFiles[].createTime |
文件的创建日期和时间 |
systemRamFreeReports[] |
关于可用 RAM 内存量的报告(只读) |
systemRamFreeReports[].reportTime |
收到报告的日期和时间。 |
systemRamFreeReports[].systemRamFreeInfo[] |
|
lastKnownNetwork[] |
包含上一个已知网络(只读) |
lastKnownNetwork[].ipAddress |
IP 地址。 |
lastKnownNetwork[].wanIpAddress |
WAN IP 地址。 |
autoUpdateExpiration |
(只读)时间戳,超过此时间戳后设备将停止接收 Chrome 更新或支持 |
ethernetMacAddress0 |
(只读)Chromebook 的内部以太网端口和板载网络(以太网)接口使用的 MAC 地址。格式为十二 (12) 个十六进制数字,不带任何分隔符(大写字母)。此设置仅与部分设备相关。 |
dockMacAddress |
(只读)设备所连接的基座的内置 MAC 地址。出厂设置已分配给基座使用的媒体访问控制地址(MAC 地址)。它专供设备政策的 MAC 传递使用。格式为十二 (12) 个十六进制数字,不带任何分隔符(大写字母)。此设置仅与部分设备相关。 |
manufactureDate |
(只读)设备的生产日期,格式为 yyyy-mm-dd。 |
orgUnitPath |
包含与设备关联的组织部门名称的完整父路径。路径名称不区分大小写。如果上级组织部门是顶级组织,则以正斜线 |
tpmVersionInfo |
可信平台模块 (TPM)(只读) |
tpmVersionInfo.family |
TPM 系列。我们使用 TPM 2.0 样式编码,例如: |
tpmVersionInfo.specLevel |
TPM 规范级别。请参阅 TPM 2.0 的库规范和 TPM 1.2 的主要规范。 |
tpmVersionInfo.manufacturer |
TPM 制造商代码。 |
tpmVersionInfo.tpmModel |
TPM 型号。 |
tpmVersionInfo.firmwareVersion |
TPM 固件版本。 |
tpmVersionInfo.vendorSpecific |
供应商特定信息,例如供应商 ID。 |
screenshotFiles[] |
要下载的屏幕截图文件的列表。类型始终为“SCREENSHOT_FILE”。(只读) |
screenshotFiles[].name |
文件名 |
screenshotFiles[].type |
文件类型 |
screenshotFiles[].downloadUrl |
文件下载网址 |
screenshotFiles[].createTime |
文件的创建日期和时间 |
orgUnitId |
组织部门的唯一 ID。orgUnitPath 是直观易懂的 orgUnitId。虽然 orgUnitPath 可能会通过重命名路径中的组织部门而发生变化,但只有一个组织部门的 orgUnitId 无法更改。您可以使用 API 更新此属性。要详细了解如何为设备创建组织结构,请参阅管理帮助中心。 |
osUpdateStatus |
设备的操作系统更新的状态。 |
firstEnrollmentTime |
首次注册设备的日期和时间。 |
lastDeprovisionTimestamp |
(只读)上次取消配置设备的日期和时间。 |
deprovisionReason |
(只读)取消配置原因。 |
deviceLicenseType |
仅供输出。设备许可类型。 |
OsUpdateStatus
包含有关当前操作系统更新状态的信息。
JSON 表示法 |
---|
{
"state": enum ( |
字段 | |
---|---|
state |
操作系统更新的更新状态。 |
targetOsVersion |
正在下载和应用操作系统映像的新平台版本。仅当更新状态为 UPDATE_STATUS_DOWNLOAD_IN_PROGRESS 或 UPDATE_STATUS_NEED_REBOOT 时才会设置。请注意,在某些极端情况下,这可能是 UPDATE_STATUS_NEED_REBOOT 的虚拟“0.0.0.0”,例如,更新引擎在不重新启动的情况下重启。 |
targetKioskAppVersion |
待更新自助服务终端应用中所需的新平台版本。 |
updateTime |
上次成功更新操作系统的日期和时间。 |
updateCheckTime |
上次检查更新的日期和时间。 |
rebootTime |
上次重新启动的日期和时间。 |
UpdateState
操作系统更新的更新状态。
枚举 | |
---|---|
UPDATE_STATE_UNSPECIFIED |
未指定更新状态。 |
UPDATE_STATE_NOT_STARTED |
有一项待处理的更新,但尚未开始。 |
UPDATE_STATE_DOWNLOAD_IN_PROGRESS |
正在下载待处理的更新。 |
UPDATE_STATE_NEED_REBOOT |
设备已准备好安装更新,但必须重新启动。 |
DeprovisionReason
设备被取消配置的原因。
枚举 | |
---|---|
DEPROVISION_REASON_UNSPECIFIED |
取消配置原因未知。 |
DEPROVISION_REASON_SAME_MODEL_REPLACEMENT |
该设备已被型号相同的设备替换。 |
DEPROVISION_REASON_UPGRADE |
设备已升级。 |
DEPROVISION_REASON_DOMAIN_MOVE |
设备的网域已更改。 |
DEPROVISION_REASON_SERVICE_EXPIRATION |
设备服务已过期。 |
DEPROVISION_REASON_OTHER |
设备因已不再受支持的旧版原因被取消配置。 |
DEPROVISION_REASON_DIFFERENT_MODEL_REPLACEMENT |
该设备已被一部不同型号的设备替换。 |
DEPROVISION_REASON_RETIRING_DEVICE |
该设备已弃用。 |
DEPROVISION_REASON_UPGRADE_TRANSFER |
设备的永久升级许可已转移到新设备。 |
DEPROVISION_REASON_NOT_REQUIRED |
原因无需填写。例如,将许可退回客户的许可池。 |
DEPROVISION_REASON_REPAIR_CENTER |
维修服务中心已取消配置该设备。 |
DeviceLicenseType
此设备的许可类型。
枚举 | |
---|---|
DEVICE_LICENSE_TYPE_UNSPECIFIED |
许可类型未知。 |
ENTERPRISE |
设备绑定了永久 Chrome 企业版升级。 |
ENTERPRISE_UPGRADE |
设备可以按年购买独立的 Chrome 企业版升级许可。 |
EDUCATION_UPGRADE |
设备拥有永久独立的 Chrome 教育版升级许可。 |
EDUCATION |
此设备绑定了永久 Chrome 教育版升级许可。 |
KIOSK_UPGRADE |
设备享有年度自助服务终端升级许可。 |
方法 |
|
---|---|
|
执行会影响 Chrome 操作系统设备的操作。 |
|
检索 Chrome 操作系统设备的属性。 |
|
检索账号中 Chrome 操作系统设备的分页列表。 |
|
将多台 ChromeOS 设备移动或插入一个组织部门。 |
|
更新设备的可更新属性,例如 annotatedUser 、annotatedLocation 、notes 、orgUnitPath 或 annotatedAssetId 。 |
|
更新设备的可更新属性,例如 annotatedUser 、annotatedLocation 、notes 、orgUnitPath 或 annotatedAssetId 。 |