1<html><body> 2<style> 3 4body, h1, h2, h3, div, span, p, pre, a { 5 margin: 0; 6 padding: 0; 7 border: 0; 8 font-weight: inherit; 9 font-style: inherit; 10 font-size: 100%; 11 font-family: inherit; 12 vertical-align: baseline; 13} 14 15body { 16 font-size: 13px; 17 padding: 1em; 18} 19 20h1 { 21 font-size: 26px; 22 margin-bottom: 1em; 23} 24 25h2 { 26 font-size: 24px; 27 margin-bottom: 1em; 28} 29 30h3 { 31 font-size: 20px; 32 margin-bottom: 1em; 33 margin-top: 1em; 34} 35 36pre, code { 37 line-height: 1.5; 38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; 39} 40 41pre { 42 margin-top: 0.5em; 43} 44 45h1, h2, h3, p { 46 font-family: Arial, sans serif; 47} 48 49h1, h2, h3 { 50 border-bottom: solid #CCC 1px; 51} 52 53.toc_element { 54 margin-top: 0.5em; 55} 56 57.firstline { 58 margin-left: 2 em; 59} 60 61.method { 62 margin-top: 1em; 63 border: solid 1px #CCC; 64 padding: 1em; 65 background: #EEE; 66} 67 68.details { 69 font-weight: bold; 70 font-size: 14px; 71} 72 73</style> 74 75<h1><a href="admin_directory_v1.html">Admin SDK API</a> . <a href="admin_directory_v1.chromeosdevices.html">chromeosdevices</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="#action">action(customerId, resourceId, body=None, x__xgafv=None)</a></code></p> 79<p class="firstline">Takes an action that affects a Chrome OS Device. This includes deprovisioning, disabling, and re-enabling devices. *Warning:* * Deprovisioning a device will stop device policy syncing and remove device-level printers. After a device is deprovisioned, it must be wiped before it can be re-enrolled. * Lost or stolen devices should use the disable action. * Re-enabling a disabled device will consume a device license. If you do not have sufficient licenses available when completing the re-enable action, you will receive an error. For more information about deprovisioning and disabling devices, visit the [help center](https://support.google.com/chrome/a/answer/3523633).</p> 80<p class="toc_element"> 81 <code><a href="#close">close()</a></code></p> 82<p class="firstline">Close httplib2 connections.</p> 83<p class="toc_element"> 84 <code><a href="#get">get(customerId, deviceId, projection=None, x__xgafv=None)</a></code></p> 85<p class="firstline">Retrieves a Chrome OS device's properties.</p> 86<p class="toc_element"> 87 <code><a href="#list">list(customerId, includeChildOrgunits=None, maxResults=None, orderBy=None, orgUnitPath=None, pageToken=None, projection=None, query=None, sortOrder=None, x__xgafv=None)</a></code></p> 88<p class="firstline">Retrieves a paginated list of Chrome OS devices within an account.</p> 89<p class="toc_element"> 90 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> 91<p class="firstline">Retrieves the next page of results.</p> 92<p class="toc_element"> 93 <code><a href="#moveDevicesToOu">moveDevicesToOu(customerId, orgUnitPath, body=None, x__xgafv=None)</a></code></p> 94<p class="firstline">Moves or inserts multiple Chrome OS devices to an organizational unit. You can move up to 50 devices at once.</p> 95<p class="toc_element"> 96 <code><a href="#patch">patch(customerId, deviceId, body=None, projection=None, x__xgafv=None)</a></code></p> 97<p class="firstline">Updates a device's updatable properties, such as `annotatedUser`, `annotatedLocation`, `notes`, `orgUnitPath`, or `annotatedAssetId`. This method supports [patch semantics](/admin-sdk/directory/v1/guides/performance#patch).</p> 98<p class="toc_element"> 99 <code><a href="#update">update(customerId, deviceId, body=None, projection=None, x__xgafv=None)</a></code></p> 100<p class="firstline">Updates a device's updatable properties, such as `annotatedUser`, `annotatedLocation`, `notes`, `orgUnitPath`, or `annotatedAssetId`.</p> 101<h3>Method Details</h3> 102<div class="method"> 103 <code class="details" id="action">action(customerId, resourceId, body=None, x__xgafv=None)</code> 104 <pre>Takes an action that affects a Chrome OS Device. This includes deprovisioning, disabling, and re-enabling devices. *Warning:* * Deprovisioning a device will stop device policy syncing and remove device-level printers. After a device is deprovisioned, it must be wiped before it can be re-enrolled. * Lost or stolen devices should use the disable action. * Re-enabling a disabled device will consume a device license. If you do not have sufficient licenses available when completing the re-enable action, you will receive an error. For more information about deprovisioning and disabling devices, visit the [help center](https://support.google.com/chrome/a/answer/3523633). 105 106Args: 107 customerId: string, The unique ID for the customer's Google Workspace account. As an account administrator, you can also use the `my_customer` alias to represent your account's `customerId`. The `customerId` is also returned as part of the [Users resource](/admin-sdk/directory/v1/reference/users). (required) 108 resourceId: string, The unique ID of the device. The `resourceId`s are returned in the response from the [chromeosdevices.list](/admin-sdk/directory/v1/reference/chromeosdevices/list) method. (required) 109 body: object, The request body. 110 The object takes the form of: 111 112{ 113 "action": "A String", # Action to be taken on the Chrome OS device. 114 "deprovisionReason": "A String", # Only used when the action is `deprovision`. With the `deprovision` action, this field is required. *Note*: The deprovision reason is audited because it might have implications on licenses for perpetual subscription customers. 115} 116 117 x__xgafv: string, V1 error format. 118 Allowed values 119 1 - v1 error format 120 2 - v2 error format 121</pre> 122</div> 123 124<div class="method"> 125 <code class="details" id="close">close()</code> 126 <pre>Close httplib2 connections.</pre> 127</div> 128 129<div class="method"> 130 <code class="details" id="get">get(customerId, deviceId, projection=None, x__xgafv=None)</code> 131 <pre>Retrieves a Chrome OS device's properties. 132 133Args: 134 customerId: string, The unique ID for the customer's Google Workspace account. As an account administrator, you can also use the `my_customer` alias to represent your account's `customerId`. The `customerId` is also returned as part of the [Users resource](/admin-sdk/directory/v1/reference/users). (required) 135 deviceId: string, The unique ID of the device. The `deviceId`s are returned in the response from the [chromeosdevices.list](/admin-sdk/directory/v1/reference/chromeosdevices/list) method. (required) 136 projection: string, Determines whether the response contains the full list of properties or only a subset. 137 Allowed values 138 BASIC - Includes only the basic metadata fields (e.g., deviceId, serialNumber, status, and user) 139 FULL - Includes all metadata fields 140 x__xgafv: string, V1 error format. 141 Allowed values 142 1 - v1 error format 143 2 - v2 error format 144 145Returns: 146 An object of the form: 147 148 { # Google Chrome devices run on the [Chrome OS](https://support.google.com/chromeos). For more information about common API tasks, see the [Developer's Guide](/admin-sdk/directory/v1/guides/manage-chrome-devices). 149 "activeTimeRanges": [ # List of active time ranges (Read-only). 150 { 151 "activeTime": 42, # Duration of usage in milliseconds. 152 "date": "A String", # Date of usage 153 }, 154 ], 155 "annotatedAssetId": "A String", # The asset identifier as noted by an administrator or specified during enrollment. 156 "annotatedLocation": "A String", # The address or location of the device as noted by the administrator. Maximum length is `200` characters. Empty values are allowed. 157 "annotatedUser": "A String", # The user of the device as noted by the administrator. Maximum length is 100 characters. Empty values are allowed. 158 "autoUpdateExpiration": "A String", # (Read-only) The timestamp after which the device will stop receiving Chrome updates or support 159 "bootMode": "A String", # The boot mode for the device. The possible values are: * `Verified`: The device is running a valid version of the Chrome OS. * `Dev`: The devices's developer hardware switch is enabled. When booted, the device has a command line shell. For an example of a developer switch, see the [Chromebook developer information](https://www.chromium.org/chromium-os/developer-information-for-chrome-os-devices/samsung-series-5-chromebook#TOC-Developer-switch). 160 "cpuInfo": [ # Information regarding CPU specs in the device. 161 { # CPU specs for a CPU. 162 "architecture": "A String", # The CPU architecture. 163 "logicalCpus": [ # Information for the Logical CPUs 164 { # Status of a single logical CPU. 165 "cStates": [ # C-States indicate the power consumption state of the CPU. For more information look at documentation published by the CPU maker. 166 { # Status of a single C-state. C-states are various modes the CPU can transition to in order to use more or less power. 167 "displayName": "A String", # Name of the state. 168 "sessionDuration": "A String", # Time spent in the state since the last reboot. 169 }, 170 ], 171 "currentScalingFrequencyKhz": 42, # Current frequency the CPU is running at. 172 "idleDuration": "A String", # Idle time since last boot. 173 "maxScalingFrequencyKhz": 42, # Maximum frequency the CPU is allowed to run at, by policy. 174 }, 175 ], 176 "maxClockSpeedKhz": 42, # The max CPU clock speed in kHz. 177 "model": "A String", # The CPU model name. 178 }, 179 ], 180 "cpuStatusReports": [ # Reports of CPU utilization and temperature (Read-only) 181 { 182 "cpuTemperatureInfo": [ # List of CPU temperature samples. 183 { 184 "label": "A String", # CPU label 185 "temperature": 42, # Temperature in Celsius degrees. 186 }, 187 ], 188 "cpuUtilizationPercentageInfo": [ 189 42, 190 ], 191 "reportTime": "A String", # Date and time the report was received. 192 }, 193 ], 194 "deviceFiles": [ # List of device files to download (Read-only) 195 { 196 "createTime": "A String", # Date and time the file was created 197 "downloadUrl": "A String", # File download URL 198 "name": "A String", # File name 199 "type": "A String", # File type 200 }, 201 ], 202 "deviceId": "A String", # The unique ID of the Chrome device. 203 "diskVolumeReports": [ # Reports of disk space and other info about mounted/connected volumes. 204 { 205 "volumeInfo": [ # Disk volumes 206 { 207 "storageFree": "A String", # Free disk space [in bytes] 208 "storageTotal": "A String", # Total disk space [in bytes] 209 "volumeId": "A String", # Volume id 210 }, 211 ], 212 }, 213 ], 214 "dockMacAddress": "A 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. 215 "etag": "A String", # ETag of the resource. 216 "ethernetMacAddress": "A String", # The device's MAC address on the ethernet network interface. 217 "ethernetMacAddress0": "A 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. 218 "firmwareVersion": "A String", # The Chrome device's firmware version. 219 "kind": "admin#directory#chromeosdevice", # The type of resource. For the Chromeosdevices resource, the value is `admin#directory#chromeosdevice`. 220 "lastEnrollmentTime": "A String", # Date and time the device was last enrolled (Read-only) 221 "lastKnownNetwork": [ # Contains last known network (Read-only) 222 { # Information for an ip address. 223 "ipAddress": "A String", # The IP address. 224 "wanIpAddress": "A String", # The WAN IP address. 225 }, 226 ], 227 "lastSync": "A String", # Date and time the device was last synchronized with the policy settings in the G Suite administrator control panel (Read-only) 228 "macAddress": "A String", # The device's wireless MAC address. If the device does not have this information, it is not included in the response. 229 "manufactureDate": "A String", # (Read-only) The date the device was manufactured in yyyy-mm-dd format. 230 "meid": "A String", # 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](/admin-sdk/directory/v1/guides/manage-chrome-devices.html#export_meid). 231 "model": "A String", # The device's model information. If the device does not have this information, this property is not included in the response. 232 "notes": "A String", # Notes about this device added by the administrator. This property can be [searched](https://support.google.com/chrome/a/answer/1698333) with the [list](/admin-sdk/directory/v1/reference/chromeosdevices/list) method's `query` parameter. Maximum length is 500 characters. Empty values are allowed. 233 "orderNumber": "A String", # The device's order number. Only devices directly purchased from Google have an order number. 234 "orgUnitId": "A String", # 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](/admin-sdk/directory/v1/guides/manage-chrome-devices#update_chrome_device) using the API, and this will be supported in the future. 235 "orgUnitPath": "A String", # 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, `/`. This property can be [updated](/admin-sdk/directory/v1/guides/manage-chrome-devices#update_chrome_device) using the API. For more information about how to create an organizational structure for your device, see the [administration help center](https://support.google.com/a/answer/182433). 236 "osVersion": "A String", # The Chrome device's operating system version. 237 "platformVersion": "A String", # The Chrome device's platform version. 238 "recentUsers": [ # List of recent device users, in descending order, by last login time. 239 { # List of recent device users, in descending order, by last login time. 240 "email": "A String", # The user's email address. This is only present if the user type is `USER_TYPE_MANAGED`. 241 "type": "A String", # The type of the user. 242 }, 243 ], 244 "screenshotFiles": [ # List of screenshot files to download. Type is always "SCREENSHOT_FILE". (Read-only) 245 { 246 "createTime": "A String", # Date and time the file was created 247 "downloadUrl": "A String", # File download URL 248 "name": "A String", # File name 249 "type": "A String", # File type 250 }, 251 ], 252 "serialNumber": "A String", # 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. 253 "status": "A String", # The status of the device. 254 "supportEndDate": "A String", # Final date the device will be supported (Read-only) 255 "systemRamFreeReports": [ # Reports of amounts of available RAM memory (Read-only) 256 { 257 "reportTime": "A String", # Date and time the report was received. 258 "systemRamFreeInfo": [ 259 "A String", 260 ], 261 }, 262 ], 263 "systemRamTotal": "A String", # Total RAM on the device [in bytes] (Read-only) 264 "tpmVersionInfo": { # Trusted Platform Module (TPM) (Read-only) 265 "family": "A String", # TPM family. We use the TPM 2.0 style encoding, e.g.: TPM 1.2: "1.2" -> 312e3200 TPM 2.0: "2.0" -> 322e3000 266 "firmwareVersion": "A String", # TPM firmware version. 267 "manufacturer": "A String", # TPM manufacturer code. 268 "specLevel": "A String", # TPM specification level. See Library Specification for TPM 2.0 and Main Specification for TPM 1.2. 269 "tpmModel": "A String", # TPM model number. 270 "vendorSpecific": "A String", # Vendor-specific information such as Vendor ID. 271 }, 272 "willAutoRenew": True or False, # Determines if the device will auto renew its support after the support end date. This is a read-only property. 273}</pre> 274</div> 275 276<div class="method"> 277 <code class="details" id="list">list(customerId, includeChildOrgunits=None, maxResults=None, orderBy=None, orgUnitPath=None, pageToken=None, projection=None, query=None, sortOrder=None, x__xgafv=None)</code> 278 <pre>Retrieves a paginated list of Chrome OS devices within an account. 279 280Args: 281 customerId: string, The unique ID for the customer's Google Workspace account. As an account administrator, you can also use the `my_customer` alias to represent your account's `customerId`. The `customerId` is also returned as part of the [Users resource](/admin-sdk/directory/v1/reference/users). (required) 282 includeChildOrgunits: boolean, Return devices from all child orgunits, as well as the specified org unit. If this is set to true 'orgUnitPath' must be provided. 283 maxResults: integer, Maximum number of results to return. 284 orderBy: string, Device property to use for sorting results. 285 Allowed values 286 annotatedLocation - Chrome device location as annotated by the administrator. 287 annotatedUser - Chromebook user as annotated by administrator. 288 lastSync - The date and time the Chrome device was last synchronized with the policy settings in the Admin console. 289 notes - Chrome device notes as annotated by the administrator. 290 serialNumber - The Chrome device serial number entered when the device was enabled. 291 status - Chrome device status. For more information, see the <a [chromeosdevices](/admin-sdk/directory/v1/reference/chromeosdevices.html). 292 supportEndDate - Chrome device support end date. This is applicable only for devices purchased directly from Google. 293 orgUnitPath: string, The full path of the organizational unit (minus the leading `/`) or its unique ID. 294 pageToken: string, The `pageToken` query parameter is used to request the next page of query results. The follow-on request's `pageToken` query parameter is the `nextPageToken` from your previous response. 295 projection: string, Restrict information returned to a set of selected fields. 296 Allowed values 297 BASIC - Includes only the basic metadata fields (e.g., deviceId, serialNumber, status, and user) 298 FULL - Includes all metadata fields 299 query: string, Search string in the format given at https://developers.google.com/admin-sdk/directory/v1/list-query-operators 300 sortOrder: string, Whether to return results in ascending or descending order. Must be used with the `orderBy` parameter. 301 Allowed values 302 ASCENDING - Ascending order. 303 DESCENDING - Descending order. 304 x__xgafv: string, V1 error format. 305 Allowed values 306 1 - v1 error format 307 2 - v2 error format 308 309Returns: 310 An object of the form: 311 312 { 313 "chromeosdevices": [ # List of Chrome OS Device objects. 314 { # Google Chrome devices run on the [Chrome OS](https://support.google.com/chromeos). For more information about common API tasks, see the [Developer's Guide](/admin-sdk/directory/v1/guides/manage-chrome-devices). 315 "activeTimeRanges": [ # List of active time ranges (Read-only). 316 { 317 "activeTime": 42, # Duration of usage in milliseconds. 318 "date": "A String", # Date of usage 319 }, 320 ], 321 "annotatedAssetId": "A String", # The asset identifier as noted by an administrator or specified during enrollment. 322 "annotatedLocation": "A String", # The address or location of the device as noted by the administrator. Maximum length is `200` characters. Empty values are allowed. 323 "annotatedUser": "A String", # The user of the device as noted by the administrator. Maximum length is 100 characters. Empty values are allowed. 324 "autoUpdateExpiration": "A String", # (Read-only) The timestamp after which the device will stop receiving Chrome updates or support 325 "bootMode": "A String", # The boot mode for the device. The possible values are: * `Verified`: The device is running a valid version of the Chrome OS. * `Dev`: The devices's developer hardware switch is enabled. When booted, the device has a command line shell. For an example of a developer switch, see the [Chromebook developer information](https://www.chromium.org/chromium-os/developer-information-for-chrome-os-devices/samsung-series-5-chromebook#TOC-Developer-switch). 326 "cpuInfo": [ # Information regarding CPU specs in the device. 327 { # CPU specs for a CPU. 328 "architecture": "A String", # The CPU architecture. 329 "logicalCpus": [ # Information for the Logical CPUs 330 { # Status of a single logical CPU. 331 "cStates": [ # C-States indicate the power consumption state of the CPU. For more information look at documentation published by the CPU maker. 332 { # Status of a single C-state. C-states are various modes the CPU can transition to in order to use more or less power. 333 "displayName": "A String", # Name of the state. 334 "sessionDuration": "A String", # Time spent in the state since the last reboot. 335 }, 336 ], 337 "currentScalingFrequencyKhz": 42, # Current frequency the CPU is running at. 338 "idleDuration": "A String", # Idle time since last boot. 339 "maxScalingFrequencyKhz": 42, # Maximum frequency the CPU is allowed to run at, by policy. 340 }, 341 ], 342 "maxClockSpeedKhz": 42, # The max CPU clock speed in kHz. 343 "model": "A String", # The CPU model name. 344 }, 345 ], 346 "cpuStatusReports": [ # Reports of CPU utilization and temperature (Read-only) 347 { 348 "cpuTemperatureInfo": [ # List of CPU temperature samples. 349 { 350 "label": "A String", # CPU label 351 "temperature": 42, # Temperature in Celsius degrees. 352 }, 353 ], 354 "cpuUtilizationPercentageInfo": [ 355 42, 356 ], 357 "reportTime": "A String", # Date and time the report was received. 358 }, 359 ], 360 "deviceFiles": [ # List of device files to download (Read-only) 361 { 362 "createTime": "A String", # Date and time the file was created 363 "downloadUrl": "A String", # File download URL 364 "name": "A String", # File name 365 "type": "A String", # File type 366 }, 367 ], 368 "deviceId": "A String", # The unique ID of the Chrome device. 369 "diskVolumeReports": [ # Reports of disk space and other info about mounted/connected volumes. 370 { 371 "volumeInfo": [ # Disk volumes 372 { 373 "storageFree": "A String", # Free disk space [in bytes] 374 "storageTotal": "A String", # Total disk space [in bytes] 375 "volumeId": "A String", # Volume id 376 }, 377 ], 378 }, 379 ], 380 "dockMacAddress": "A 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. 381 "etag": "A String", # ETag of the resource. 382 "ethernetMacAddress": "A String", # The device's MAC address on the ethernet network interface. 383 "ethernetMacAddress0": "A 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. 384 "firmwareVersion": "A String", # The Chrome device's firmware version. 385 "kind": "admin#directory#chromeosdevice", # The type of resource. For the Chromeosdevices resource, the value is `admin#directory#chromeosdevice`. 386 "lastEnrollmentTime": "A String", # Date and time the device was last enrolled (Read-only) 387 "lastKnownNetwork": [ # Contains last known network (Read-only) 388 { # Information for an ip address. 389 "ipAddress": "A String", # The IP address. 390 "wanIpAddress": "A String", # The WAN IP address. 391 }, 392 ], 393 "lastSync": "A String", # Date and time the device was last synchronized with the policy settings in the G Suite administrator control panel (Read-only) 394 "macAddress": "A String", # The device's wireless MAC address. If the device does not have this information, it is not included in the response. 395 "manufactureDate": "A String", # (Read-only) The date the device was manufactured in yyyy-mm-dd format. 396 "meid": "A String", # 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](/admin-sdk/directory/v1/guides/manage-chrome-devices.html#export_meid). 397 "model": "A String", # The device's model information. If the device does not have this information, this property is not included in the response. 398 "notes": "A String", # Notes about this device added by the administrator. This property can be [searched](https://support.google.com/chrome/a/answer/1698333) with the [list](/admin-sdk/directory/v1/reference/chromeosdevices/list) method's `query` parameter. Maximum length is 500 characters. Empty values are allowed. 399 "orderNumber": "A String", # The device's order number. Only devices directly purchased from Google have an order number. 400 "orgUnitId": "A String", # 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](/admin-sdk/directory/v1/guides/manage-chrome-devices#update_chrome_device) using the API, and this will be supported in the future. 401 "orgUnitPath": "A String", # 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, `/`. This property can be [updated](/admin-sdk/directory/v1/guides/manage-chrome-devices#update_chrome_device) using the API. For more information about how to create an organizational structure for your device, see the [administration help center](https://support.google.com/a/answer/182433). 402 "osVersion": "A String", # The Chrome device's operating system version. 403 "platformVersion": "A String", # The Chrome device's platform version. 404 "recentUsers": [ # List of recent device users, in descending order, by last login time. 405 { # List of recent device users, in descending order, by last login time. 406 "email": "A String", # The user's email address. This is only present if the user type is `USER_TYPE_MANAGED`. 407 "type": "A String", # The type of the user. 408 }, 409 ], 410 "screenshotFiles": [ # List of screenshot files to download. Type is always "SCREENSHOT_FILE". (Read-only) 411 { 412 "createTime": "A String", # Date and time the file was created 413 "downloadUrl": "A String", # File download URL 414 "name": "A String", # File name 415 "type": "A String", # File type 416 }, 417 ], 418 "serialNumber": "A String", # 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. 419 "status": "A String", # The status of the device. 420 "supportEndDate": "A String", # Final date the device will be supported (Read-only) 421 "systemRamFreeReports": [ # Reports of amounts of available RAM memory (Read-only) 422 { 423 "reportTime": "A String", # Date and time the report was received. 424 "systemRamFreeInfo": [ 425 "A String", 426 ], 427 }, 428 ], 429 "systemRamTotal": "A String", # Total RAM on the device [in bytes] (Read-only) 430 "tpmVersionInfo": { # Trusted Platform Module (TPM) (Read-only) 431 "family": "A String", # TPM family. We use the TPM 2.0 style encoding, e.g.: TPM 1.2: "1.2" -> 312e3200 TPM 2.0: "2.0" -> 322e3000 432 "firmwareVersion": "A String", # TPM firmware version. 433 "manufacturer": "A String", # TPM manufacturer code. 434 "specLevel": "A String", # TPM specification level. See Library Specification for TPM 2.0 and Main Specification for TPM 1.2. 435 "tpmModel": "A String", # TPM model number. 436 "vendorSpecific": "A String", # Vendor-specific information such as Vendor ID. 437 }, 438 "willAutoRenew": True or False, # Determines if the device will auto renew its support after the support end date. This is a read-only property. 439 }, 440 ], 441 "etag": "A String", # ETag of the resource. 442 "kind": "admin#directory#chromeosdevices", # Kind of resource this is. 443 "nextPageToken": "A String", # Token used to access the next page of this result. To access the next page, use this token's value in the `pageToken` query string of this request. 444}</pre> 445</div> 446 447<div class="method"> 448 <code class="details" id="list_next">list_next(previous_request, previous_response)</code> 449 <pre>Retrieves the next page of results. 450 451Args: 452 previous_request: The request for the previous page. (required) 453 previous_response: The response from the request for the previous page. (required) 454 455Returns: 456 A request object that you can call 'execute()' on to request the next 457 page. Returns None if there are no more items in the collection. 458 </pre> 459</div> 460 461<div class="method"> 462 <code class="details" id="moveDevicesToOu">moveDevicesToOu(customerId, orgUnitPath, body=None, x__xgafv=None)</code> 463 <pre>Moves or inserts multiple Chrome OS devices to an organizational unit. You can move up to 50 devices at once. 464 465Args: 466 customerId: string, Immutable ID of the Google Workspace account (required) 467 orgUnitPath: string, Full path of the target organizational unit or its ID (required) 468 body: object, The request body. 469 The object takes the form of: 470 471{ 472 "deviceIds": [ # Chrome OS devices to be moved to OU 473 "A String", 474 ], 475} 476 477 x__xgafv: string, V1 error format. 478 Allowed values 479 1 - v1 error format 480 2 - v2 error format 481</pre> 482</div> 483 484<div class="method"> 485 <code class="details" id="patch">patch(customerId, deviceId, body=None, projection=None, x__xgafv=None)</code> 486 <pre>Updates a device's updatable properties, such as `annotatedUser`, `annotatedLocation`, `notes`, `orgUnitPath`, or `annotatedAssetId`. This method supports [patch semantics](/admin-sdk/directory/v1/guides/performance#patch). 487 488Args: 489 customerId: string, The unique ID for the customer's Google Workspace account. As an account administrator, you can also use the `my_customer` alias to represent your account's `customerId`. The `customerId` is also returned as part of the [Users resource](/admin-sdk/directory/v1/reference/users). (required) 490 deviceId: string, The unique ID of the device. The `deviceId`s are returned in the response from the [chromeosdevices.list](/admin-sdk/v1/reference/chromeosdevices/list) method. (required) 491 body: object, The request body. 492 The object takes the form of: 493 494{ # Google Chrome devices run on the [Chrome OS](https://support.google.com/chromeos). For more information about common API tasks, see the [Developer's Guide](/admin-sdk/directory/v1/guides/manage-chrome-devices). 495 "activeTimeRanges": [ # List of active time ranges (Read-only). 496 { 497 "activeTime": 42, # Duration of usage in milliseconds. 498 "date": "A String", # Date of usage 499 }, 500 ], 501 "annotatedAssetId": "A String", # The asset identifier as noted by an administrator or specified during enrollment. 502 "annotatedLocation": "A String", # The address or location of the device as noted by the administrator. Maximum length is `200` characters. Empty values are allowed. 503 "annotatedUser": "A String", # The user of the device as noted by the administrator. Maximum length is 100 characters. Empty values are allowed. 504 "autoUpdateExpiration": "A String", # (Read-only) The timestamp after which the device will stop receiving Chrome updates or support 505 "bootMode": "A String", # The boot mode for the device. The possible values are: * `Verified`: The device is running a valid version of the Chrome OS. * `Dev`: The devices's developer hardware switch is enabled. When booted, the device has a command line shell. For an example of a developer switch, see the [Chromebook developer information](https://www.chromium.org/chromium-os/developer-information-for-chrome-os-devices/samsung-series-5-chromebook#TOC-Developer-switch). 506 "cpuInfo": [ # Information regarding CPU specs in the device. 507 { # CPU specs for a CPU. 508 "architecture": "A String", # The CPU architecture. 509 "logicalCpus": [ # Information for the Logical CPUs 510 { # Status of a single logical CPU. 511 "cStates": [ # C-States indicate the power consumption state of the CPU. For more information look at documentation published by the CPU maker. 512 { # Status of a single C-state. C-states are various modes the CPU can transition to in order to use more or less power. 513 "displayName": "A String", # Name of the state. 514 "sessionDuration": "A String", # Time spent in the state since the last reboot. 515 }, 516 ], 517 "currentScalingFrequencyKhz": 42, # Current frequency the CPU is running at. 518 "idleDuration": "A String", # Idle time since last boot. 519 "maxScalingFrequencyKhz": 42, # Maximum frequency the CPU is allowed to run at, by policy. 520 }, 521 ], 522 "maxClockSpeedKhz": 42, # The max CPU clock speed in kHz. 523 "model": "A String", # The CPU model name. 524 }, 525 ], 526 "cpuStatusReports": [ # Reports of CPU utilization and temperature (Read-only) 527 { 528 "cpuTemperatureInfo": [ # List of CPU temperature samples. 529 { 530 "label": "A String", # CPU label 531 "temperature": 42, # Temperature in Celsius degrees. 532 }, 533 ], 534 "cpuUtilizationPercentageInfo": [ 535 42, 536 ], 537 "reportTime": "A String", # Date and time the report was received. 538 }, 539 ], 540 "deviceFiles": [ # List of device files to download (Read-only) 541 { 542 "createTime": "A String", # Date and time the file was created 543 "downloadUrl": "A String", # File download URL 544 "name": "A String", # File name 545 "type": "A String", # File type 546 }, 547 ], 548 "deviceId": "A String", # The unique ID of the Chrome device. 549 "diskVolumeReports": [ # Reports of disk space and other info about mounted/connected volumes. 550 { 551 "volumeInfo": [ # Disk volumes 552 { 553 "storageFree": "A String", # Free disk space [in bytes] 554 "storageTotal": "A String", # Total disk space [in bytes] 555 "volumeId": "A String", # Volume id 556 }, 557 ], 558 }, 559 ], 560 "dockMacAddress": "A 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. 561 "etag": "A String", # ETag of the resource. 562 "ethernetMacAddress": "A String", # The device's MAC address on the ethernet network interface. 563 "ethernetMacAddress0": "A 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. 564 "firmwareVersion": "A String", # The Chrome device's firmware version. 565 "kind": "admin#directory#chromeosdevice", # The type of resource. For the Chromeosdevices resource, the value is `admin#directory#chromeosdevice`. 566 "lastEnrollmentTime": "A String", # Date and time the device was last enrolled (Read-only) 567 "lastKnownNetwork": [ # Contains last known network (Read-only) 568 { # Information for an ip address. 569 "ipAddress": "A String", # The IP address. 570 "wanIpAddress": "A String", # The WAN IP address. 571 }, 572 ], 573 "lastSync": "A String", # Date and time the device was last synchronized with the policy settings in the G Suite administrator control panel (Read-only) 574 "macAddress": "A String", # The device's wireless MAC address. If the device does not have this information, it is not included in the response. 575 "manufactureDate": "A String", # (Read-only) The date the device was manufactured in yyyy-mm-dd format. 576 "meid": "A String", # 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](/admin-sdk/directory/v1/guides/manage-chrome-devices.html#export_meid). 577 "model": "A String", # The device's model information. If the device does not have this information, this property is not included in the response. 578 "notes": "A String", # Notes about this device added by the administrator. This property can be [searched](https://support.google.com/chrome/a/answer/1698333) with the [list](/admin-sdk/directory/v1/reference/chromeosdevices/list) method's `query` parameter. Maximum length is 500 characters. Empty values are allowed. 579 "orderNumber": "A String", # The device's order number. Only devices directly purchased from Google have an order number. 580 "orgUnitId": "A String", # 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](/admin-sdk/directory/v1/guides/manage-chrome-devices#update_chrome_device) using the API, and this will be supported in the future. 581 "orgUnitPath": "A String", # 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, `/`. This property can be [updated](/admin-sdk/directory/v1/guides/manage-chrome-devices#update_chrome_device) using the API. For more information about how to create an organizational structure for your device, see the [administration help center](https://support.google.com/a/answer/182433). 582 "osVersion": "A String", # The Chrome device's operating system version. 583 "platformVersion": "A String", # The Chrome device's platform version. 584 "recentUsers": [ # List of recent device users, in descending order, by last login time. 585 { # List of recent device users, in descending order, by last login time. 586 "email": "A String", # The user's email address. This is only present if the user type is `USER_TYPE_MANAGED`. 587 "type": "A String", # The type of the user. 588 }, 589 ], 590 "screenshotFiles": [ # List of screenshot files to download. Type is always "SCREENSHOT_FILE". (Read-only) 591 { 592 "createTime": "A String", # Date and time the file was created 593 "downloadUrl": "A String", # File download URL 594 "name": "A String", # File name 595 "type": "A String", # File type 596 }, 597 ], 598 "serialNumber": "A String", # 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. 599 "status": "A String", # The status of the device. 600 "supportEndDate": "A String", # Final date the device will be supported (Read-only) 601 "systemRamFreeReports": [ # Reports of amounts of available RAM memory (Read-only) 602 { 603 "reportTime": "A String", # Date and time the report was received. 604 "systemRamFreeInfo": [ 605 "A String", 606 ], 607 }, 608 ], 609 "systemRamTotal": "A String", # Total RAM on the device [in bytes] (Read-only) 610 "tpmVersionInfo": { # Trusted Platform Module (TPM) (Read-only) 611 "family": "A String", # TPM family. We use the TPM 2.0 style encoding, e.g.: TPM 1.2: "1.2" -> 312e3200 TPM 2.0: "2.0" -> 322e3000 612 "firmwareVersion": "A String", # TPM firmware version. 613 "manufacturer": "A String", # TPM manufacturer code. 614 "specLevel": "A String", # TPM specification level. See Library Specification for TPM 2.0 and Main Specification for TPM 1.2. 615 "tpmModel": "A String", # TPM model number. 616 "vendorSpecific": "A String", # Vendor-specific information such as Vendor ID. 617 }, 618 "willAutoRenew": True or False, # Determines if the device will auto renew its support after the support end date. This is a read-only property. 619} 620 621 projection: string, Restrict information returned to a set of selected fields. 622 Allowed values 623 BASIC - Includes only the basic metadata fields (e.g., deviceId, serialNumber, status, and user) 624 FULL - Includes all metadata fields 625 x__xgafv: string, V1 error format. 626 Allowed values 627 1 - v1 error format 628 2 - v2 error format 629 630Returns: 631 An object of the form: 632 633 { # Google Chrome devices run on the [Chrome OS](https://support.google.com/chromeos). For more information about common API tasks, see the [Developer's Guide](/admin-sdk/directory/v1/guides/manage-chrome-devices). 634 "activeTimeRanges": [ # List of active time ranges (Read-only). 635 { 636 "activeTime": 42, # Duration of usage in milliseconds. 637 "date": "A String", # Date of usage 638 }, 639 ], 640 "annotatedAssetId": "A String", # The asset identifier as noted by an administrator or specified during enrollment. 641 "annotatedLocation": "A String", # The address or location of the device as noted by the administrator. Maximum length is `200` characters. Empty values are allowed. 642 "annotatedUser": "A String", # The user of the device as noted by the administrator. Maximum length is 100 characters. Empty values are allowed. 643 "autoUpdateExpiration": "A String", # (Read-only) The timestamp after which the device will stop receiving Chrome updates or support 644 "bootMode": "A String", # The boot mode for the device. The possible values are: * `Verified`: The device is running a valid version of the Chrome OS. * `Dev`: The devices's developer hardware switch is enabled. When booted, the device has a command line shell. For an example of a developer switch, see the [Chromebook developer information](https://www.chromium.org/chromium-os/developer-information-for-chrome-os-devices/samsung-series-5-chromebook#TOC-Developer-switch). 645 "cpuInfo": [ # Information regarding CPU specs in the device. 646 { # CPU specs for a CPU. 647 "architecture": "A String", # The CPU architecture. 648 "logicalCpus": [ # Information for the Logical CPUs 649 { # Status of a single logical CPU. 650 "cStates": [ # C-States indicate the power consumption state of the CPU. For more information look at documentation published by the CPU maker. 651 { # Status of a single C-state. C-states are various modes the CPU can transition to in order to use more or less power. 652 "displayName": "A String", # Name of the state. 653 "sessionDuration": "A String", # Time spent in the state since the last reboot. 654 }, 655 ], 656 "currentScalingFrequencyKhz": 42, # Current frequency the CPU is running at. 657 "idleDuration": "A String", # Idle time since last boot. 658 "maxScalingFrequencyKhz": 42, # Maximum frequency the CPU is allowed to run at, by policy. 659 }, 660 ], 661 "maxClockSpeedKhz": 42, # The max CPU clock speed in kHz. 662 "model": "A String", # The CPU model name. 663 }, 664 ], 665 "cpuStatusReports": [ # Reports of CPU utilization and temperature (Read-only) 666 { 667 "cpuTemperatureInfo": [ # List of CPU temperature samples. 668 { 669 "label": "A String", # CPU label 670 "temperature": 42, # Temperature in Celsius degrees. 671 }, 672 ], 673 "cpuUtilizationPercentageInfo": [ 674 42, 675 ], 676 "reportTime": "A String", # Date and time the report was received. 677 }, 678 ], 679 "deviceFiles": [ # List of device files to download (Read-only) 680 { 681 "createTime": "A String", # Date and time the file was created 682 "downloadUrl": "A String", # File download URL 683 "name": "A String", # File name 684 "type": "A String", # File type 685 }, 686 ], 687 "deviceId": "A String", # The unique ID of the Chrome device. 688 "diskVolumeReports": [ # Reports of disk space and other info about mounted/connected volumes. 689 { 690 "volumeInfo": [ # Disk volumes 691 { 692 "storageFree": "A String", # Free disk space [in bytes] 693 "storageTotal": "A String", # Total disk space [in bytes] 694 "volumeId": "A String", # Volume id 695 }, 696 ], 697 }, 698 ], 699 "dockMacAddress": "A 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. 700 "etag": "A String", # ETag of the resource. 701 "ethernetMacAddress": "A String", # The device's MAC address on the ethernet network interface. 702 "ethernetMacAddress0": "A 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. 703 "firmwareVersion": "A String", # The Chrome device's firmware version. 704 "kind": "admin#directory#chromeosdevice", # The type of resource. For the Chromeosdevices resource, the value is `admin#directory#chromeosdevice`. 705 "lastEnrollmentTime": "A String", # Date and time the device was last enrolled (Read-only) 706 "lastKnownNetwork": [ # Contains last known network (Read-only) 707 { # Information for an ip address. 708 "ipAddress": "A String", # The IP address. 709 "wanIpAddress": "A String", # The WAN IP address. 710 }, 711 ], 712 "lastSync": "A String", # Date and time the device was last synchronized with the policy settings in the G Suite administrator control panel (Read-only) 713 "macAddress": "A String", # The device's wireless MAC address. If the device does not have this information, it is not included in the response. 714 "manufactureDate": "A String", # (Read-only) The date the device was manufactured in yyyy-mm-dd format. 715 "meid": "A String", # 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](/admin-sdk/directory/v1/guides/manage-chrome-devices.html#export_meid). 716 "model": "A String", # The device's model information. If the device does not have this information, this property is not included in the response. 717 "notes": "A String", # Notes about this device added by the administrator. This property can be [searched](https://support.google.com/chrome/a/answer/1698333) with the [list](/admin-sdk/directory/v1/reference/chromeosdevices/list) method's `query` parameter. Maximum length is 500 characters. Empty values are allowed. 718 "orderNumber": "A String", # The device's order number. Only devices directly purchased from Google have an order number. 719 "orgUnitId": "A String", # 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](/admin-sdk/directory/v1/guides/manage-chrome-devices#update_chrome_device) using the API, and this will be supported in the future. 720 "orgUnitPath": "A String", # 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, `/`. This property can be [updated](/admin-sdk/directory/v1/guides/manage-chrome-devices#update_chrome_device) using the API. For more information about how to create an organizational structure for your device, see the [administration help center](https://support.google.com/a/answer/182433). 721 "osVersion": "A String", # The Chrome device's operating system version. 722 "platformVersion": "A String", # The Chrome device's platform version. 723 "recentUsers": [ # List of recent device users, in descending order, by last login time. 724 { # List of recent device users, in descending order, by last login time. 725 "email": "A String", # The user's email address. This is only present if the user type is `USER_TYPE_MANAGED`. 726 "type": "A String", # The type of the user. 727 }, 728 ], 729 "screenshotFiles": [ # List of screenshot files to download. Type is always "SCREENSHOT_FILE". (Read-only) 730 { 731 "createTime": "A String", # Date and time the file was created 732 "downloadUrl": "A String", # File download URL 733 "name": "A String", # File name 734 "type": "A String", # File type 735 }, 736 ], 737 "serialNumber": "A String", # 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. 738 "status": "A String", # The status of the device. 739 "supportEndDate": "A String", # Final date the device will be supported (Read-only) 740 "systemRamFreeReports": [ # Reports of amounts of available RAM memory (Read-only) 741 { 742 "reportTime": "A String", # Date and time the report was received. 743 "systemRamFreeInfo": [ 744 "A String", 745 ], 746 }, 747 ], 748 "systemRamTotal": "A String", # Total RAM on the device [in bytes] (Read-only) 749 "tpmVersionInfo": { # Trusted Platform Module (TPM) (Read-only) 750 "family": "A String", # TPM family. We use the TPM 2.0 style encoding, e.g.: TPM 1.2: "1.2" -> 312e3200 TPM 2.0: "2.0" -> 322e3000 751 "firmwareVersion": "A String", # TPM firmware version. 752 "manufacturer": "A String", # TPM manufacturer code. 753 "specLevel": "A String", # TPM specification level. See Library Specification for TPM 2.0 and Main Specification for TPM 1.2. 754 "tpmModel": "A String", # TPM model number. 755 "vendorSpecific": "A String", # Vendor-specific information such as Vendor ID. 756 }, 757 "willAutoRenew": True or False, # Determines if the device will auto renew its support after the support end date. This is a read-only property. 758}</pre> 759</div> 760 761<div class="method"> 762 <code class="details" id="update">update(customerId, deviceId, body=None, projection=None, x__xgafv=None)</code> 763 <pre>Updates a device's updatable properties, such as `annotatedUser`, `annotatedLocation`, `notes`, `orgUnitPath`, or `annotatedAssetId`. 764 765Args: 766 customerId: string, The unique ID for the customer's Google Workspace account. As an account administrator, you can also use the `my_customer` alias to represent your account's `customerId`. The `customerId` is also returned as part of the [Users resource](/admin-sdk/directory/v1/reference/users). (required) 767 deviceId: string, The unique ID of the device. The `deviceId`s are returned in the response from the [chromeosdevices.list](/admin-sdk/v1/reference/chromeosdevices/list) method. (required) 768 body: object, The request body. 769 The object takes the form of: 770 771{ # Google Chrome devices run on the [Chrome OS](https://support.google.com/chromeos). For more information about common API tasks, see the [Developer's Guide](/admin-sdk/directory/v1/guides/manage-chrome-devices). 772 "activeTimeRanges": [ # List of active time ranges (Read-only). 773 { 774 "activeTime": 42, # Duration of usage in milliseconds. 775 "date": "A String", # Date of usage 776 }, 777 ], 778 "annotatedAssetId": "A String", # The asset identifier as noted by an administrator or specified during enrollment. 779 "annotatedLocation": "A String", # The address or location of the device as noted by the administrator. Maximum length is `200` characters. Empty values are allowed. 780 "annotatedUser": "A String", # The user of the device as noted by the administrator. Maximum length is 100 characters. Empty values are allowed. 781 "autoUpdateExpiration": "A String", # (Read-only) The timestamp after which the device will stop receiving Chrome updates or support 782 "bootMode": "A String", # The boot mode for the device. The possible values are: * `Verified`: The device is running a valid version of the Chrome OS. * `Dev`: The devices's developer hardware switch is enabled. When booted, the device has a command line shell. For an example of a developer switch, see the [Chromebook developer information](https://www.chromium.org/chromium-os/developer-information-for-chrome-os-devices/samsung-series-5-chromebook#TOC-Developer-switch). 783 "cpuInfo": [ # Information regarding CPU specs in the device. 784 { # CPU specs for a CPU. 785 "architecture": "A String", # The CPU architecture. 786 "logicalCpus": [ # Information for the Logical CPUs 787 { # Status of a single logical CPU. 788 "cStates": [ # C-States indicate the power consumption state of the CPU. For more information look at documentation published by the CPU maker. 789 { # Status of a single C-state. C-states are various modes the CPU can transition to in order to use more or less power. 790 "displayName": "A String", # Name of the state. 791 "sessionDuration": "A String", # Time spent in the state since the last reboot. 792 }, 793 ], 794 "currentScalingFrequencyKhz": 42, # Current frequency the CPU is running at. 795 "idleDuration": "A String", # Idle time since last boot. 796 "maxScalingFrequencyKhz": 42, # Maximum frequency the CPU is allowed to run at, by policy. 797 }, 798 ], 799 "maxClockSpeedKhz": 42, # The max CPU clock speed in kHz. 800 "model": "A String", # The CPU model name. 801 }, 802 ], 803 "cpuStatusReports": [ # Reports of CPU utilization and temperature (Read-only) 804 { 805 "cpuTemperatureInfo": [ # List of CPU temperature samples. 806 { 807 "label": "A String", # CPU label 808 "temperature": 42, # Temperature in Celsius degrees. 809 }, 810 ], 811 "cpuUtilizationPercentageInfo": [ 812 42, 813 ], 814 "reportTime": "A String", # Date and time the report was received. 815 }, 816 ], 817 "deviceFiles": [ # List of device files to download (Read-only) 818 { 819 "createTime": "A String", # Date and time the file was created 820 "downloadUrl": "A String", # File download URL 821 "name": "A String", # File name 822 "type": "A String", # File type 823 }, 824 ], 825 "deviceId": "A String", # The unique ID of the Chrome device. 826 "diskVolumeReports": [ # Reports of disk space and other info about mounted/connected volumes. 827 { 828 "volumeInfo": [ # Disk volumes 829 { 830 "storageFree": "A String", # Free disk space [in bytes] 831 "storageTotal": "A String", # Total disk space [in bytes] 832 "volumeId": "A String", # Volume id 833 }, 834 ], 835 }, 836 ], 837 "dockMacAddress": "A 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. 838 "etag": "A String", # ETag of the resource. 839 "ethernetMacAddress": "A String", # The device's MAC address on the ethernet network interface. 840 "ethernetMacAddress0": "A 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. 841 "firmwareVersion": "A String", # The Chrome device's firmware version. 842 "kind": "admin#directory#chromeosdevice", # The type of resource. For the Chromeosdevices resource, the value is `admin#directory#chromeosdevice`. 843 "lastEnrollmentTime": "A String", # Date and time the device was last enrolled (Read-only) 844 "lastKnownNetwork": [ # Contains last known network (Read-only) 845 { # Information for an ip address. 846 "ipAddress": "A String", # The IP address. 847 "wanIpAddress": "A String", # The WAN IP address. 848 }, 849 ], 850 "lastSync": "A String", # Date and time the device was last synchronized with the policy settings in the G Suite administrator control panel (Read-only) 851 "macAddress": "A String", # The device's wireless MAC address. If the device does not have this information, it is not included in the response. 852 "manufactureDate": "A String", # (Read-only) The date the device was manufactured in yyyy-mm-dd format. 853 "meid": "A String", # 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](/admin-sdk/directory/v1/guides/manage-chrome-devices.html#export_meid). 854 "model": "A String", # The device's model information. If the device does not have this information, this property is not included in the response. 855 "notes": "A String", # Notes about this device added by the administrator. This property can be [searched](https://support.google.com/chrome/a/answer/1698333) with the [list](/admin-sdk/directory/v1/reference/chromeosdevices/list) method's `query` parameter. Maximum length is 500 characters. Empty values are allowed. 856 "orderNumber": "A String", # The device's order number. Only devices directly purchased from Google have an order number. 857 "orgUnitId": "A String", # 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](/admin-sdk/directory/v1/guides/manage-chrome-devices#update_chrome_device) using the API, and this will be supported in the future. 858 "orgUnitPath": "A String", # 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, `/`. This property can be [updated](/admin-sdk/directory/v1/guides/manage-chrome-devices#update_chrome_device) using the API. For more information about how to create an organizational structure for your device, see the [administration help center](https://support.google.com/a/answer/182433). 859 "osVersion": "A String", # The Chrome device's operating system version. 860 "platformVersion": "A String", # The Chrome device's platform version. 861 "recentUsers": [ # List of recent device users, in descending order, by last login time. 862 { # List of recent device users, in descending order, by last login time. 863 "email": "A String", # The user's email address. This is only present if the user type is `USER_TYPE_MANAGED`. 864 "type": "A String", # The type of the user. 865 }, 866 ], 867 "screenshotFiles": [ # List of screenshot files to download. Type is always "SCREENSHOT_FILE". (Read-only) 868 { 869 "createTime": "A String", # Date and time the file was created 870 "downloadUrl": "A String", # File download URL 871 "name": "A String", # File name 872 "type": "A String", # File type 873 }, 874 ], 875 "serialNumber": "A String", # 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. 876 "status": "A String", # The status of the device. 877 "supportEndDate": "A String", # Final date the device will be supported (Read-only) 878 "systemRamFreeReports": [ # Reports of amounts of available RAM memory (Read-only) 879 { 880 "reportTime": "A String", # Date and time the report was received. 881 "systemRamFreeInfo": [ 882 "A String", 883 ], 884 }, 885 ], 886 "systemRamTotal": "A String", # Total RAM on the device [in bytes] (Read-only) 887 "tpmVersionInfo": { # Trusted Platform Module (TPM) (Read-only) 888 "family": "A String", # TPM family. We use the TPM 2.0 style encoding, e.g.: TPM 1.2: "1.2" -> 312e3200 TPM 2.0: "2.0" -> 322e3000 889 "firmwareVersion": "A String", # TPM firmware version. 890 "manufacturer": "A String", # TPM manufacturer code. 891 "specLevel": "A String", # TPM specification level. See Library Specification for TPM 2.0 and Main Specification for TPM 1.2. 892 "tpmModel": "A String", # TPM model number. 893 "vendorSpecific": "A String", # Vendor-specific information such as Vendor ID. 894 }, 895 "willAutoRenew": True or False, # Determines if the device will auto renew its support after the support end date. This is a read-only property. 896} 897 898 projection: string, Restrict information returned to a set of selected fields. 899 Allowed values 900 BASIC - Includes only the basic metadata fields (e.g., deviceId, serialNumber, status, and user) 901 FULL - Includes all metadata fields 902 x__xgafv: string, V1 error format. 903 Allowed values 904 1 - v1 error format 905 2 - v2 error format 906 907Returns: 908 An object of the form: 909 910 { # Google Chrome devices run on the [Chrome OS](https://support.google.com/chromeos). For more information about common API tasks, see the [Developer's Guide](/admin-sdk/directory/v1/guides/manage-chrome-devices). 911 "activeTimeRanges": [ # List of active time ranges (Read-only). 912 { 913 "activeTime": 42, # Duration of usage in milliseconds. 914 "date": "A String", # Date of usage 915 }, 916 ], 917 "annotatedAssetId": "A String", # The asset identifier as noted by an administrator or specified during enrollment. 918 "annotatedLocation": "A String", # The address or location of the device as noted by the administrator. Maximum length is `200` characters. Empty values are allowed. 919 "annotatedUser": "A String", # The user of the device as noted by the administrator. Maximum length is 100 characters. Empty values are allowed. 920 "autoUpdateExpiration": "A String", # (Read-only) The timestamp after which the device will stop receiving Chrome updates or support 921 "bootMode": "A String", # The boot mode for the device. The possible values are: * `Verified`: The device is running a valid version of the Chrome OS. * `Dev`: The devices's developer hardware switch is enabled. When booted, the device has a command line shell. For an example of a developer switch, see the [Chromebook developer information](https://www.chromium.org/chromium-os/developer-information-for-chrome-os-devices/samsung-series-5-chromebook#TOC-Developer-switch). 922 "cpuInfo": [ # Information regarding CPU specs in the device. 923 { # CPU specs for a CPU. 924 "architecture": "A String", # The CPU architecture. 925 "logicalCpus": [ # Information for the Logical CPUs 926 { # Status of a single logical CPU. 927 "cStates": [ # C-States indicate the power consumption state of the CPU. For more information look at documentation published by the CPU maker. 928 { # Status of a single C-state. C-states are various modes the CPU can transition to in order to use more or less power. 929 "displayName": "A String", # Name of the state. 930 "sessionDuration": "A String", # Time spent in the state since the last reboot. 931 }, 932 ], 933 "currentScalingFrequencyKhz": 42, # Current frequency the CPU is running at. 934 "idleDuration": "A String", # Idle time since last boot. 935 "maxScalingFrequencyKhz": 42, # Maximum frequency the CPU is allowed to run at, by policy. 936 }, 937 ], 938 "maxClockSpeedKhz": 42, # The max CPU clock speed in kHz. 939 "model": "A String", # The CPU model name. 940 }, 941 ], 942 "cpuStatusReports": [ # Reports of CPU utilization and temperature (Read-only) 943 { 944 "cpuTemperatureInfo": [ # List of CPU temperature samples. 945 { 946 "label": "A String", # CPU label 947 "temperature": 42, # Temperature in Celsius degrees. 948 }, 949 ], 950 "cpuUtilizationPercentageInfo": [ 951 42, 952 ], 953 "reportTime": "A String", # Date and time the report was received. 954 }, 955 ], 956 "deviceFiles": [ # List of device files to download (Read-only) 957 { 958 "createTime": "A String", # Date and time the file was created 959 "downloadUrl": "A String", # File download URL 960 "name": "A String", # File name 961 "type": "A String", # File type 962 }, 963 ], 964 "deviceId": "A String", # The unique ID of the Chrome device. 965 "diskVolumeReports": [ # Reports of disk space and other info about mounted/connected volumes. 966 { 967 "volumeInfo": [ # Disk volumes 968 { 969 "storageFree": "A String", # Free disk space [in bytes] 970 "storageTotal": "A String", # Total disk space [in bytes] 971 "volumeId": "A String", # Volume id 972 }, 973 ], 974 }, 975 ], 976 "dockMacAddress": "A 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. 977 "etag": "A String", # ETag of the resource. 978 "ethernetMacAddress": "A String", # The device's MAC address on the ethernet network interface. 979 "ethernetMacAddress0": "A 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. 980 "firmwareVersion": "A String", # The Chrome device's firmware version. 981 "kind": "admin#directory#chromeosdevice", # The type of resource. For the Chromeosdevices resource, the value is `admin#directory#chromeosdevice`. 982 "lastEnrollmentTime": "A String", # Date and time the device was last enrolled (Read-only) 983 "lastKnownNetwork": [ # Contains last known network (Read-only) 984 { # Information for an ip address. 985 "ipAddress": "A String", # The IP address. 986 "wanIpAddress": "A String", # The WAN IP address. 987 }, 988 ], 989 "lastSync": "A String", # Date and time the device was last synchronized with the policy settings in the G Suite administrator control panel (Read-only) 990 "macAddress": "A String", # The device's wireless MAC address. If the device does not have this information, it is not included in the response. 991 "manufactureDate": "A String", # (Read-only) The date the device was manufactured in yyyy-mm-dd format. 992 "meid": "A String", # 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](/admin-sdk/directory/v1/guides/manage-chrome-devices.html#export_meid). 993 "model": "A String", # The device's model information. If the device does not have this information, this property is not included in the response. 994 "notes": "A String", # Notes about this device added by the administrator. This property can be [searched](https://support.google.com/chrome/a/answer/1698333) with the [list](/admin-sdk/directory/v1/reference/chromeosdevices/list) method's `query` parameter. Maximum length is 500 characters. Empty values are allowed. 995 "orderNumber": "A String", # The device's order number. Only devices directly purchased from Google have an order number. 996 "orgUnitId": "A String", # 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](/admin-sdk/directory/v1/guides/manage-chrome-devices#update_chrome_device) using the API, and this will be supported in the future. 997 "orgUnitPath": "A String", # 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, `/`. This property can be [updated](/admin-sdk/directory/v1/guides/manage-chrome-devices#update_chrome_device) using the API. For more information about how to create an organizational structure for your device, see the [administration help center](https://support.google.com/a/answer/182433). 998 "osVersion": "A String", # The Chrome device's operating system version. 999 "platformVersion": "A String", # The Chrome device's platform version. 1000 "recentUsers": [ # List of recent device users, in descending order, by last login time. 1001 { # List of recent device users, in descending order, by last login time. 1002 "email": "A String", # The user's email address. This is only present if the user type is `USER_TYPE_MANAGED`. 1003 "type": "A String", # The type of the user. 1004 }, 1005 ], 1006 "screenshotFiles": [ # List of screenshot files to download. Type is always "SCREENSHOT_FILE". (Read-only) 1007 { 1008 "createTime": "A String", # Date and time the file was created 1009 "downloadUrl": "A String", # File download URL 1010 "name": "A String", # File name 1011 "type": "A String", # File type 1012 }, 1013 ], 1014 "serialNumber": "A String", # 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. 1015 "status": "A String", # The status of the device. 1016 "supportEndDate": "A String", # Final date the device will be supported (Read-only) 1017 "systemRamFreeReports": [ # Reports of amounts of available RAM memory (Read-only) 1018 { 1019 "reportTime": "A String", # Date and time the report was received. 1020 "systemRamFreeInfo": [ 1021 "A String", 1022 ], 1023 }, 1024 ], 1025 "systemRamTotal": "A String", # Total RAM on the device [in bytes] (Read-only) 1026 "tpmVersionInfo": { # Trusted Platform Module (TPM) (Read-only) 1027 "family": "A String", # TPM family. We use the TPM 2.0 style encoding, e.g.: TPM 1.2: "1.2" -> 312e3200 TPM 2.0: "2.0" -> 322e3000 1028 "firmwareVersion": "A String", # TPM firmware version. 1029 "manufacturer": "A String", # TPM manufacturer code. 1030 "specLevel": "A String", # TPM specification level. See Library Specification for TPM 2.0 and Main Specification for TPM 1.2. 1031 "tpmModel": "A String", # TPM model number. 1032 "vendorSpecific": "A String", # Vendor-specific information such as Vendor ID. 1033 }, 1034 "willAutoRenew": True or False, # Determines if the device will auto renew its support after the support end date. This is a read-only property. 1035}</pre> 1036</div> 1037 1038</body></html>