Update
|
|||||
|
|
||||
Update Chrome OS Device
Authorization
To use this building block you will have to grant access to at least one of the following scopes:
- View and manage your Chrome OS devices' metadata
Input
This building block consumes 66 input parameters
| Name | Format | Description |
|---|---|---|
customerId Required |
STRING |
Immutable ID of the G Suite account |
deviceId Required |
STRING |
Immutable ID of Chrome OS Device |
projection |
ENUMERATION |
Restrict information returned to a set of selected fields |
meid |
STRING |
Contains either the Mobile Equipment identifier (MEID) or the International Mobile Equipment Identity (IMEI) for the 3G mobile card in the Chromebook (Read-only) |
model |
STRING |
Chromebook Model (Read-only) |
recentUsers[] |
OBJECT |
|
recentUsers[].email |
STRING |
Email address of the user. Present only if the user type is managed |
recentUsers[].type |
STRING |
The type of the user |
annotatedUser |
STRING |
User of the device |
manufactureDate |
STRING |
(Read-only) The date the device was manufactured in yyyy-mm-dd format |
annotatedLocation |
STRING |
Address or location of the device as noted by the administrator |
annotatedAssetId |
STRING |
AssetId specified during enrollment or through later annotation |
ethernetMacAddress0 |
STRING |
(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 |
status |
STRING |
status of the device (Read-only) |
orgUnitPath |
STRING |
OrgUnit of the device |
cpuStatusReports[] |
OBJECT |
|
cpuStatusReports[].reportTime |
DATE_TIME |
Date and time the report was received |
cpuStatusReports[].cpuTemperatureInfo[] |
OBJECT |
|
cpuStatusReports[].cpuTemperatureInfo[].label |
STRING |
CPU label |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
INTEGER |
Temperature in Celsius degrees |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
INTEGER |
|
supportEndDate |
DATE_TIME |
Final date the device will be supported (Read-only) |
bootMode |
STRING |
Chromebook boot mode (Read-only) |
serialNumber |
STRING |
Chromebook serial number (Read-only) |
tpmVersionInfo |
OBJECT |
Trusted Platform Module (TPM) (Read-only) |
tpmVersionInfo.manufacturer |
STRING |
TPM manufacturer code |
tpmVersionInfo.firmwareVersion |
STRING |
TPM firmware version |
tpmVersionInfo.tpmModel |
STRING |
TPM model number |
tpmVersionInfo.family |
STRING |
TPM family |
tpmVersionInfo.specLevel |
STRING |
TPM specification level |
tpmVersionInfo.vendorSpecific |
STRING |
Vendor-specific information such as Vendor ID |
autoUpdateExpiration |
INTEGER |
(Read-only) The timestamp after which the device will stop receiving Chrome updates or support |
kind |
STRING |
Kind of resource this is |
systemRamTotal |
INTEGER |
Total RAM on the device [in bytes] (Read-only) |
platformVersion |
STRING |
Chromebook platform version (Read-only) |
dockMacAddress |
STRING |
(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 |
lastKnownNetwork[] |
OBJECT |
Information for an ip address |
lastKnownNetwork[].wanIpAddress |
STRING |
The WAN IP address |
lastKnownNetwork[].ipAddress |
STRING |
The IP address |
firmwareVersion |
STRING |
Chromebook firmware version (Read-only) |
activeTimeRanges[] |
OBJECT |
|
activeTimeRanges[].date |
DATE |
Date of usage |
activeTimeRanges[].activeTime |
INTEGER |
Duration in milliseconds |
macAddress |
STRING |
Chromebook Mac Address on wifi network interface (Read-only) |
ethernetMacAddress |
STRING |
Chromebook Mac Address on ethernet network interface (Read-only) |
orderNumber |
STRING |
Chromebook order number (Read-only) |
lastSync |
DATE_TIME |
Date and time the device was last synchronized with the policy settings in the G Suite administrator control panel (Read-only) |
etag |
STRING |
ETag of the resource |
notes |
STRING |
Notes added by the administrator |
willAutoRenew |
BOOLEAN |
Will Chromebook auto renew after support end date (Read-only) |
deviceId |
STRING |
Unique identifier of Chrome OS Device (Read-only) |
systemRamFreeReports[] |
OBJECT |
|
systemRamFreeReports[].systemRamFreeInfo[] |
INTEGER |
|
systemRamFreeReports[].reportTime |
DATE_TIME |
Date and time the report was received |
lastEnrollmentTime |
DATE_TIME |
Date and time the device was last enrolled (Read-only) |
diskVolumeReports[] |
OBJECT |
|
diskVolumeReports[].volumeInfo[] |
OBJECT |
|
diskVolumeReports[].volumeInfo[].storageFree |
INTEGER |
Free disk space [in bytes] |
diskVolumeReports[].volumeInfo[].volumeId |
STRING |
Volume id |
diskVolumeReports[].volumeInfo[].storageTotal |
INTEGER |
Total disk space [in bytes] |
osVersion |
STRING |
Chromebook Os Version (Read-only) |
deviceFiles[] |
OBJECT |
|
deviceFiles[].name |
STRING |
File name |
deviceFiles[].createTime |
DATE_TIME |
Date and time the file was created |
deviceFiles[].downloadUrl |
STRING |
File download URL |
deviceFiles[].type |
STRING |
File type |
= Parameter name
= Format
|
customerId STRING Required Immutable ID of the G Suite account |
|
deviceId STRING Required Immutable ID of Chrome OS Device |
|
projection ENUMERATION Restrict information returned to a set of selected fields |
|
meid STRING Contains either the Mobile Equipment identifier (MEID) or the International Mobile Equipment Identity (IMEI) for the 3G mobile card in the Chromebook (Read-only) |
|
model STRING Chromebook Model (Read-only) |
|
recentUsers[] OBJECT |
|
recentUsers[].email STRING Email address of the user. Present only if the user type is managed |
|
recentUsers[].type STRING The type of the user |
|
annotatedUser STRING User of the device |
|
manufactureDate STRING (Read-only) The date the device was manufactured in yyyy-mm-dd format |
|
annotatedLocation STRING Address or location of the device as noted by the administrator |
|
annotatedAssetId STRING AssetId specified during enrollment or through later annotation |
|
ethernetMacAddress0 STRING (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 |
|
status STRING status of the device (Read-only) |
|
orgUnitPath STRING OrgUnit of the device |
|
cpuStatusReports[] OBJECT |
|
cpuStatusReports[].reportTime DATE_TIME Date and time the report was received |
|
cpuStatusReports[].cpuTemperatureInfo[] OBJECT |
|
cpuStatusReports[].cpuTemperatureInfo[].label STRING CPU label |
|
cpuStatusReports[].cpuTemperatureInfo[].temperature INTEGER Temperature in Celsius degrees |
|
cpuStatusReports[].cpuUtilizationPercentageInfo[] INTEGER |
|
supportEndDate DATE_TIME Final date the device will be supported (Read-only) |
|
bootMode STRING Chromebook boot mode (Read-only) |
|
serialNumber STRING Chromebook serial number (Read-only) |
|
tpmVersionInfo OBJECT Trusted Platform Module (TPM) (Read-only) |
|
tpmVersionInfo.manufacturer STRING TPM manufacturer code |
|
tpmVersionInfo.firmwareVersion STRING TPM firmware version |
|
tpmVersionInfo.tpmModel STRING TPM model number |
|
tpmVersionInfo.family STRING TPM family |
|
tpmVersionInfo.specLevel STRING TPM specification level |
|
tpmVersionInfo.vendorSpecific STRING Vendor-specific information such as Vendor ID |
|
autoUpdateExpiration INTEGER (Read-only) The timestamp after which the device will stop receiving Chrome updates or support |
|
kind STRING Kind of resource this is |
|
systemRamTotal INTEGER Total RAM on the device [in bytes] (Read-only) |
|
platformVersion STRING Chromebook platform version (Read-only) |
|
dockMacAddress STRING (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 |
|
lastKnownNetwork[] OBJECT Information for an ip address |
|
lastKnownNetwork[].wanIpAddress STRING The WAN IP address |
|
lastKnownNetwork[].ipAddress STRING The IP address |
|
firmwareVersion STRING Chromebook firmware version (Read-only) |
|
activeTimeRanges[] OBJECT |
|
activeTimeRanges[].date DATE Date of usage |
|
activeTimeRanges[].activeTime INTEGER Duration in milliseconds |
|
macAddress STRING Chromebook Mac Address on wifi network interface (Read-only) |
|
ethernetMacAddress STRING Chromebook Mac Address on ethernet network interface (Read-only) |
|
orderNumber STRING Chromebook order number (Read-only) |
|
lastSync DATE_TIME Date and time the device was last synchronized with the policy settings in the G Suite administrator control panel (Read-only) |
|
etag STRING ETag of the resource |
|
notes STRING Notes added by the administrator |
|
willAutoRenew BOOLEAN Will Chromebook auto renew after support end date (Read-only) |
|
deviceId STRING Unique identifier of Chrome OS Device (Read-only) |
|
systemRamFreeReports[] OBJECT |
|
systemRamFreeReports[].systemRamFreeInfo[] INTEGER |
|
systemRamFreeReports[].reportTime DATE_TIME Date and time the report was received |
|
lastEnrollmentTime DATE_TIME Date and time the device was last enrolled (Read-only) |
|
diskVolumeReports[] OBJECT |
|
diskVolumeReports[].volumeInfo[] OBJECT |
|
diskVolumeReports[].volumeInfo[].storageFree INTEGER Free disk space [in bytes] |
|
diskVolumeReports[].volumeInfo[].volumeId STRING Volume id |
|
diskVolumeReports[].volumeInfo[].storageTotal INTEGER Total disk space [in bytes] |
|
osVersion STRING Chromebook Os Version (Read-only) |
|
deviceFiles[] OBJECT |
|
deviceFiles[].name STRING File name |
|
deviceFiles[].createTime DATE_TIME Date and time the file was created |
|
deviceFiles[].downloadUrl STRING File download URL |
|
deviceFiles[].type STRING File type |
Output
This building block provides 63 output parameters
| Name | Format | Description |
|---|---|---|
meid |
STRING |
Contains either the Mobile Equipment identifier (MEID) or the International Mobile Equipment Identity (IMEI) for the 3G mobile card in the Chromebook (Read-only) |
model |
STRING |
Chromebook Model (Read-only) |
recentUsers[] |
OBJECT |
|
recentUsers[].email |
STRING |
Email address of the user. Present only if the user type is managed |
recentUsers[].type |
STRING |
The type of the user |
annotatedUser |
STRING |
User of the device |
manufactureDate |
STRING |
(Read-only) The date the device was manufactured in yyyy-mm-dd format |
annotatedLocation |
STRING |
Address or location of the device as noted by the administrator |
annotatedAssetId |
STRING |
AssetId specified during enrollment or through later annotation |
ethernetMacAddress0 |
STRING |
(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 |
status |
STRING |
status of the device (Read-only) |
orgUnitPath |
STRING |
OrgUnit of the device |
cpuStatusReports[] |
OBJECT |
|
cpuStatusReports[].reportTime |
DATE_TIME |
Date and time the report was received |
cpuStatusReports[].cpuTemperatureInfo[] |
OBJECT |
|
cpuStatusReports[].cpuTemperatureInfo[].label |
STRING |
CPU label |
cpuStatusReports[].cpuTemperatureInfo[].temperature |
INTEGER |
Temperature in Celsius degrees |
cpuStatusReports[].cpuUtilizationPercentageInfo[] |
INTEGER |
|
supportEndDate |
DATE_TIME |
Final date the device will be supported (Read-only) |
bootMode |
STRING |
Chromebook boot mode (Read-only) |
serialNumber |
STRING |
Chromebook serial number (Read-only) |
tpmVersionInfo |
OBJECT |
Trusted Platform Module (TPM) (Read-only) |
tpmVersionInfo.manufacturer |
STRING |
TPM manufacturer code |
tpmVersionInfo.firmwareVersion |
STRING |
TPM firmware version |
tpmVersionInfo.tpmModel |
STRING |
TPM model number |
tpmVersionInfo.family |
STRING |
TPM family |
tpmVersionInfo.specLevel |
STRING |
TPM specification level |
tpmVersionInfo.vendorSpecific |
STRING |
Vendor-specific information such as Vendor ID |
autoUpdateExpiration |
INTEGER |
(Read-only) The timestamp after which the device will stop receiving Chrome updates or support |
kind |
STRING |
Kind of resource this is |
systemRamTotal |
INTEGER |
Total RAM on the device [in bytes] (Read-only) |
platformVersion |
STRING |
Chromebook platform version (Read-only) |
dockMacAddress |
STRING |
(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 |
lastKnownNetwork[] |
OBJECT |
Information for an ip address |
lastKnownNetwork[].wanIpAddress |
STRING |
The WAN IP address |
lastKnownNetwork[].ipAddress |
STRING |
The IP address |
firmwareVersion |
STRING |
Chromebook firmware version (Read-only) |
activeTimeRanges[] |
OBJECT |
|
activeTimeRanges[].date |
DATE |
Date of usage |
activeTimeRanges[].activeTime |
INTEGER |
Duration in milliseconds |
macAddress |
STRING |
Chromebook Mac Address on wifi network interface (Read-only) |
ethernetMacAddress |
STRING |
Chromebook Mac Address on ethernet network interface (Read-only) |
orderNumber |
STRING |
Chromebook order number (Read-only) |
lastSync |
DATE_TIME |
Date and time the device was last synchronized with the policy settings in the G Suite administrator control panel (Read-only) |
etag |
STRING |
ETag of the resource |
notes |
STRING |
Notes added by the administrator |
willAutoRenew |
BOOLEAN |
Will Chromebook auto renew after support end date (Read-only) |
deviceId |
STRING |
Unique identifier of Chrome OS Device (Read-only) |
systemRamFreeReports[] |
OBJECT |
|
systemRamFreeReports[].systemRamFreeInfo[] |
INTEGER |
|
systemRamFreeReports[].reportTime |
DATE_TIME |
Date and time the report was received |
lastEnrollmentTime |
DATE_TIME |
Date and time the device was last enrolled (Read-only) |
diskVolumeReports[] |
OBJECT |
|
diskVolumeReports[].volumeInfo[] |
OBJECT |
|
diskVolumeReports[].volumeInfo[].storageFree |
INTEGER |
Free disk space [in bytes] |
diskVolumeReports[].volumeInfo[].volumeId |
STRING |
Volume id |
diskVolumeReports[].volumeInfo[].storageTotal |
INTEGER |
Total disk space [in bytes] |
osVersion |
STRING |
Chromebook Os Version (Read-only) |
deviceFiles[] |
OBJECT |
|
deviceFiles[].name |
STRING |
File name |
deviceFiles[].createTime |
DATE_TIME |
Date and time the file was created |
deviceFiles[].downloadUrl |
STRING |
File download URL |
deviceFiles[].type |
STRING |
File type |
= Parameter name
= Format
|
meid STRING Contains either the Mobile Equipment identifier (MEID) or the International Mobile Equipment Identity (IMEI) for the 3G mobile card in the Chromebook (Read-only) |
|
model STRING Chromebook Model (Read-only) |
|
recentUsers[] OBJECT |
|
recentUsers[].email STRING Email address of the user. Present only if the user type is managed |
|
recentUsers[].type STRING The type of the user |
|
annotatedUser STRING User of the device |
|
manufactureDate STRING (Read-only) The date the device was manufactured in yyyy-mm-dd format |
|
annotatedLocation STRING Address or location of the device as noted by the administrator |
|
annotatedAssetId STRING AssetId specified during enrollment or through later annotation |
|
ethernetMacAddress0 STRING (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 |
|
status STRING status of the device (Read-only) |
|
orgUnitPath STRING OrgUnit of the device |
|
cpuStatusReports[] OBJECT |
|
cpuStatusReports[].reportTime DATE_TIME Date and time the report was received |
|
cpuStatusReports[].cpuTemperatureInfo[] OBJECT |
|
cpuStatusReports[].cpuTemperatureInfo[].label STRING CPU label |
|
cpuStatusReports[].cpuTemperatureInfo[].temperature INTEGER Temperature in Celsius degrees |
|
cpuStatusReports[].cpuUtilizationPercentageInfo[] INTEGER |
|
supportEndDate DATE_TIME Final date the device will be supported (Read-only) |
|
bootMode STRING Chromebook boot mode (Read-only) |
|
serialNumber STRING Chromebook serial number (Read-only) |
|
tpmVersionInfo OBJECT Trusted Platform Module (TPM) (Read-only) |
|
tpmVersionInfo.manufacturer STRING TPM manufacturer code |
|
tpmVersionInfo.firmwareVersion STRING TPM firmware version |
|
tpmVersionInfo.tpmModel STRING TPM model number |
|
tpmVersionInfo.family STRING TPM family |
|
tpmVersionInfo.specLevel STRING TPM specification level |
|
tpmVersionInfo.vendorSpecific STRING Vendor-specific information such as Vendor ID |
|
autoUpdateExpiration INTEGER (Read-only) The timestamp after which the device will stop receiving Chrome updates or support |
|
kind STRING Kind of resource this is |
|
systemRamTotal INTEGER Total RAM on the device [in bytes] (Read-only) |
|
platformVersion STRING Chromebook platform version (Read-only) |
|
dockMacAddress STRING (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 |
|
lastKnownNetwork[] OBJECT Information for an ip address |
|
lastKnownNetwork[].wanIpAddress STRING The WAN IP address |
|
lastKnownNetwork[].ipAddress STRING The IP address |
|
firmwareVersion STRING Chromebook firmware version (Read-only) |
|
activeTimeRanges[] OBJECT |
|
activeTimeRanges[].date DATE Date of usage |
|
activeTimeRanges[].activeTime INTEGER Duration in milliseconds |
|
macAddress STRING Chromebook Mac Address on wifi network interface (Read-only) |
|
ethernetMacAddress STRING Chromebook Mac Address on ethernet network interface (Read-only) |
|
orderNumber STRING Chromebook order number (Read-only) |
|
lastSync DATE_TIME Date and time the device was last synchronized with the policy settings in the G Suite administrator control panel (Read-only) |
|
etag STRING ETag of the resource |
|
notes STRING Notes added by the administrator |
|
willAutoRenew BOOLEAN Will Chromebook auto renew after support end date (Read-only) |
|
deviceId STRING Unique identifier of Chrome OS Device (Read-only) |
|
systemRamFreeReports[] OBJECT |
|
systemRamFreeReports[].systemRamFreeInfo[] INTEGER |
|
systemRamFreeReports[].reportTime DATE_TIME Date and time the report was received |
|
lastEnrollmentTime DATE_TIME Date and time the device was last enrolled (Read-only) |
|
diskVolumeReports[] OBJECT |
|
diskVolumeReports[].volumeInfo[] OBJECT |
|
diskVolumeReports[].volumeInfo[].storageFree INTEGER Free disk space [in bytes] |
|
diskVolumeReports[].volumeInfo[].volumeId STRING Volume id |
|
diskVolumeReports[].volumeInfo[].storageTotal INTEGER Total disk space [in bytes] |
|
osVersion STRING Chromebook Os Version (Read-only) |
|
deviceFiles[] OBJECT |
|
deviceFiles[].name STRING File name |
|
deviceFiles[].createTime DATE_TIME Date and time the file was created |
|
deviceFiles[].downloadUrl STRING File download URL |
|
deviceFiles[].type STRING File type |