Resource: ChromeOsDevice
Google Chrome devices run on the Chrome OS. For more information about common API tasks, see the Developer's Guide.
JSON representation |
---|
{ "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 } |
Fields | |
---|---|
deviceId |
The unique ID of the Chrome device. |
serialNumber |
The Chrome device serial number entered when the device was enabled. This value is the same as the Admin console's Serial Number in the Chrome OS Devices tab. |
status |
The status of the device. Acceptable values are:
|
lastSync |
The date and time the device was last synchronized with the policy settings in the Admin console. The value is in ISO 8601 date and time format. The time is the complete date plus hours, minutes, and seconds in the form |
supportEndDate |
The final date the device will be supported. This is applicable only for those devices purchased directly from Google. The value is in ISO 8601 date and time format. The time is the complete date plus hours, minutes, and seconds in the form |
annotatedUser |
The user of the device as noted by the administrator. Maximum length is 100 characters. Empty values are allowed. |
annotatedLocation |
The address or location of the device as noted by the administrator. Maximum length is |
notes |
Notes about this device added by the administrator. This property can be searched with the list method's |
model |
The device's model information. If the device does not have this information, this property is not included in the response. |
meid |
The Mobile Equipment Identifier (MEID) or the International Mobile Equipment Identity (IMEI) for the 3G mobile card in a mobile device. A MEID/IMEI is typically used when adding a device to a wireless carrier's post-pay service plan. If the device does not have this information, this property is not included in the response. For more information on how to export a MEID/IMEI list, see the Developer's Guide. |
orderNumber |
The device's order number. Only devices directly purchased from Google have an order number. |
willAutoRenew |
Determines if the device will auto renew its support after the support end date. This is a read-only property. |
osVersion |
The Chrome device's operating system version. |
platformVersion |
The Chrome device's platform version. |
firmwareVersion |
The Chrome device's firmware version. |
macAddress |
The device's wireless MAC address. If the device does not have this information, it is not included in the response. |
bootMode |
The boot mode for the device. The possible values are:
|
lastEnrollmentTime |
The date and time the device was last enrolled. The value is in ISO 8601 date and time format. The time is the complete date plus hours, minutes, and seconds in the form |
kind |
The type of resource. For the Chromeosdevices resource, the value is |
recentUsers[] |
asps.list of recent device users, in descending order, by last login time. |
recentUsers[].type |
The type of the user. Acceptable values are:
|
recentUsers[].email |
The user's email address. This is only present if the user type is |
activeTimeRanges[] |
asps.list of active time ranges (Read-only). |
activeTimeRanges[].activeTime |
Duration of usage in milliseconds. |
activeTimeRanges[].date |
Date of usage. |
ethernetMacAddress |
The device's MAC address on the ethernet network interface. |
annotatedAssetId |
The asset identifier as noted by an administrator or specified during enrollment. |
etag |
ETag of the resource. |
diskVolumeReports[] |
Reports of disk space and other info about mounted/connected volumes. |
diskVolumeReports[].volumeInfo[] |
Disk volumes |
diskVolumeReports[].volumeInfo[].volumeId |
Volume id |
diskVolumeReports[].volumeInfo[].storageTotal |
Total disk space [in bytes] |
diskVolumeReports[].volumeInfo[].storageFree |
Free disk space [in bytes] |
systemRamTotal |
Total RAM on the device in bytes |
cpuStatusReports[] |
Reports of CPU utilization and temperature (Read-only) |
cpuStatusReports[].reportTime |
Date and time the report was received. |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
|
cpuStatusReports[].cpuTemperatureInfo[] |
asps.list of CPU temperature samples. |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
Temperature in Celsius degrees. |
cpuStatusReports[].cpuTemperatureInfo[].label |
CPU label |
cpuInfo[] |
Information regarding CPU specs in the device. |
cpuInfo[].model |
The CPU model name. |
cpuInfo[].architecture |
The CPU architecture. |
cpuInfo[].maxClockSpeedKhz |
The max CPU clock speed in kHz. |
cpuInfo[].logicalCpus[] |
Information for the Logical CPUs |
cpuInfo[].logicalCpus[].maxScalingFrequencyKhz |
Maximum frequency the CPU is allowed to run at, by policy. |
cpuInfo[].logicalCpus[].currentScalingFrequencyKhz |
Current frequency the CPU is running at. |
cpuInfo[].logicalCpus[].idleDuration |
Idle time since last boot. A duration in seconds with up to nine fractional digits, terminated by ' |
cpuInfo[].logicalCpus[].cStates[] |
C-States indicate the power consumption state of the CPU. For more information look at documentation published by the CPU maker. |
cpuInfo[].logicalCpus[].cStates[].displayName |
Name of the state. |
cpuInfo[].logicalCpus[].cStates[].sessionDuration |
Time spent in the state since the last reboot. A duration in seconds with up to nine fractional digits, terminated by ' |
deviceFiles[] |
asps.list of device files to download (Read-only) |
deviceFiles[].name |
File name |
deviceFiles[].type |
File type |
deviceFiles[].downloadUrl |
File download URL |
deviceFiles[].createTime |
Date and time the file was created |
systemRamFreeReports[] |
Reports of amounts of available RAM memory (Read-only) |
systemRamFreeReports[].reportTime |
Date and time the report was received. |
systemRamFreeReports[].systemRamFreeInfo[] |
|
lastKnownNetwork[] |
Contains last known network (Read-only) |
lastKnownNetwork[].ipAddress |
The IP address. |
lastKnownNetwork[].wanIpAddress |
The WAN IP address. |
autoUpdateExpiration |
(Read-only) The timestamp after which the device will stop receiving Chrome updates or support |
ethernetMacAddress0 |
(Read-only) MAC address used by the Chromebook’s internal ethernet port, and for onboard network (ethernet) interface. The format is twelve (12) hexadecimal digits without any delimiter (uppercase letters). This is only relevant for some devices. |
dockMacAddress |
(Read-only) Built-in MAC address for the docking station that the device connected to. Factory sets Media access control address (MAC address) assigned for use by a dock. It is reserved specifically for MAC pass through device policy. The format is twelve (12) hexadecimal digits without any delimiter (uppercase letters). This is only relevant for some devices. |
manufactureDate |
(Read-only) The date the device was manufactured in yyyy-mm-dd format. |
orgUnitPath |
The full parent path with the organizational unit's name associated with the device. Path names are case insensitive. If the parent organizational unit is the top-level organization, it is represented as a forward slash, |
tpmVersionInfo |
Trusted Platform Module (TPM) (Read-only) |
tpmVersionInfo.family |
TPM family. We use the TPM 2.0 style encoding, e.g.: |
tpmVersionInfo.specLevel |
TPM specification level. See Library Specification for TPM 2.0 and Main Specification for TPM 1.2. |
tpmVersionInfo.manufacturer |
TPM manufacturer code. |
tpmVersionInfo.tpmModel |
TPM model number. |
tpmVersionInfo.firmwareVersion |
TPM firmware version. |
tpmVersionInfo.vendorSpecific |
Vendor-specific information such as Vendor ID. |
screenshotFiles[] |
asps.list of screenshot files to download. Type is always "SCREENSHOT_FILE". (Read-only) |
screenshotFiles[].name |
File name |
screenshotFiles[].type |
File type |
screenshotFiles[].downloadUrl |
File download URL |
screenshotFiles[].createTime |
Date and time the file was created |
orgUnitId |
The unique ID of the organizational unit. orgUnitPath is the human readable version of orgUnitId. While orgUnitPath may change by renaming an organizational unit within the path, orgUnitId is unchangeable for one organizational unit. This property can be updated using the API. For more information about how to create an organizational structure for your device, see the administration help center. |
Methods |
|
---|---|
|
Takes an action that affects a Chrome OS Device. |
|
Retrieves a Chrome OS device's properties. |
|
Retrieves a paginated list of Chrome OS devices within an account. |
|
Moves or inserts multiple Chrome OS devices to an organizational unit. |
|
Updates a device's updatable properties, such as annotatedUser , annotatedLocation , notes , orgUnitPath , or annotatedAssetId . |
|
Updates a device's updatable properties, such as annotatedUser , annotatedLocation , notes , orgUnitPath , or annotatedAssetId . |