资源: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 |
|
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,但对于一个组织部门,组织部门 ID 不可更改。您可以使用 API 更新此属性。要详细了解如何为设备创建组织结构,请参阅管理帮助中心。 |
osUpdateStatus |
设备的操作系统更新状态。 |
firstEnrollmentTime |
设备首次注册的日期和时间。 |
lastDeprovisionTimestamp |
(只读)上次取消配置设备的日期和时间。 |
deprovisionReason |
(只读)取消配置的原因。 |
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 |
设备已准备好安装更新,但必须重新启动。 |
取消配置原因
取消配置设备的原因。
枚举 | |
---|---|
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 |
维修服务中心取消配置了该设备。 |
方法 |
|
---|---|
|
执行会影响 Chrome 操作系统设备的操作。 |
|
检索 Chrome 操作系统设备的属性。 |
|
在帐号中检索 Chrome 操作系统设备的分页列表。 |
|
将多个 Chrome 操作系统设备移动或插入到一个单位部门。 |
|
更新设备的可更新属性,例如 annotatedUser 、annotatedLocation 、notes 、orgUnitPath 或 annotatedAssetId 。 |
|
更新设备的可更新属性,例如 annotatedUser 、annotatedLocation 、notes 、orgUnitPath 或 annotatedAssetId 。 |