Directory API: Chrome devices

Retrieve all Chrome devices for an account Export a MEID list Retrieve a Chrome device Update a Chrome device Take action on a Chrome device Move Chrome devices to Organization Unit

Note: All of the API operations support delegated administrators and Google authorized resellers. However, in this version of the API, the Chrome and mobile device operations do not support remote administrative access for Google authorized resellers.

Note: Unlike the rest of the AdminSDK, batch requests for ChromeOS devices with N elements count as 1 for quota.

Retrieve all Chrome devices for an account

To return a list of all Chrome devices assigned to an account, use the following GET request and include the authorization described in Authorize requests. For readability, this code sample has line returns:

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/
devices/chromeos?projection={BASIC|FULL}&query=query
&orderBy=orderBy category&sortOrder={ASCENDING|DESCENDING}
&pageToken=token for next results page, if applicable
&maxResults=max number of results per page

• The customerId is a unique identifier of the customer's Google account.
• As an account administrator, you can also use the string my_customer which represents your account's customerId. Another way to get the customerId value is to use the Retrieve a user operation. Use your administrator email address or your administrator unique user id value in the operation's userKey path parameter.

For the query strings, request, and response properties, see the API Reference.

Example: Filter devices by user

This example searches for a specific user by using query=user:help desk. The response contains a single chromeosdevice resource, where the annotatedUser is help desk:

JSON request

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
chromeos?projection=FULL&query=user:help desk&orderBy=status
&sortOrder=ASCENDING&maxResults=100

JSON response

{
  "kind": "directory#chromeosdevices",
  "chromeosdevices": [
     {
       "kind": "directory#chromeosdevice",
       "etag": "1234567890"
       "deviceId": "def456",
       "serialNumber": "234567",
       "status": "ACTIVE",
       "lastSync": "2013-03-05T17:30:04.325Z",
       "supportEndDate": "2014-04-05T17:30:04.325Z",
       "annotatedUser": "help desk",
       "annotatedLocation": "Mountain View help desk Chromebook",
       "annotatedAssetId": "1234567890",
       "notes": "Loaned from support",
       "orderNumber": "1234",
       "willAutoRenew": true,
       "osVersion": "Browser Version 18.0",
       "platformVersion": "Platform Version 1415.2.0",
       "firmwareVersion": "Firmware Version 1.2.3.4",
       "bootMode": "validated",
       "lastEnrollmentTime": "2012-04-05T17:30:04.325Z",
       "orgUnitPath": "corp/engineering",
       "recentUsers": [
         {
           "type": "USER_TYPE_MANAGED",
           "email": "[e-mail]"
         }
       ],
       "activeTimeRanges": [
         {
           "date": "2012-04-05",
           "activeTime": "3600000"
         }
       ],
     }
  ],
  "nextPageToken": "abcdefghijkl123"
}

Example: Filter devices by serial number

This example searches for a specific serial number by using query=id:123456, where 123456 is the device's serial number. The response shown below contains a single matching reply, where the serialNumber property matches the search value.

JSON request

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
chromeos?projection=FULL&query=id:123456&orderBy=status
&sortOrder=ASCENDING&maxResults=100

JSON response

{
  "kind": "directory#chromeosdevices",
  "chromeosdevices": [
     {
       "kind": "directory#chromeosdevice",
       "deviceId": "abc123",
       "serialNumber": "123456",
       "status": "SHIPPED",
       "supportEndDate": "1404457200000",
       "model": "model_value",
       "meid": "meid_value",
       "macAddress": "mac_address_value",
       "orderNumber": "1234",
       "willAutoRenew": true
     }
  ],
  "nextPageToken": "abcdefghijkl123"
}

This response example includes the model, meid, and macAddress properties. If a device does not have these properties, they are not included in the response. For full details, see the Chromeosdevices resource representation.

Export a MEID list

The meid is Mobile Equipment Identifier (MEID) for the 3G mobile card in a Chrome device. A MEID is typically used when adding a device to a wireless carrier's post-pay service plan. To export the MEID list, use the following GET request and the nextPageToken values to retrieve the full list of MEIDs. For readability, this code sample has line returns:

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/
devices/chromeos?fields=nextPageToken,chromeosdevices(meid)

Retrieve a Chrome device

To retrieve a Chrome device's properties, use the following GET request and include the authorization described in Authorize requests. For readability, this code sample has line returns:

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/
devices/chromeos/deviceId?projection={FULL|BASIC}

• The customerId is a unique identifier of the customer's Google account.
• As an account administrator, you can also use the string my_customer which represents your account's customerId. Another way to get the customerId value is to use the Retrieve a user operation. Use your administrator email address or your administrator unique user id value in the operation's userKey path parameter.
• The deviceId is a unique identifier for a device and is found in the response of the Retrieve all Chrome devices operation.

For the query strings, request, and response properties, see the API Reference.

JSON request

An example request. For readability, this code sample has line returns:

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
chromeos/deviceId?projection=full

JSON response

A successful request returns an HTTP 200 status code. Along with the status code, the response returns the Chrome device properties:

{
  "kind": "directory#chromeosdevice",
  "deviceId": "device_id_value",
  "serialNumber": "device_serial_number",
  "status": "ACTIVE",
  "lastSync": "2012-04-05T17:30:04.325Z",
  "supportEndDate": "2014-04-05T17:30:04.325Z",
  "annotatedUser": "help desk",
  "annotatedLocation": "Mountain View help desk Chromebook",
  "annotatedAssetId": "12345667890",
  "notes": "Loaned from support",
  "orderNumber": "123456",
  "willAutoRenew": true,
  "osVersion": "Browser Version 18.0",
  "platformVersion": "Platform Version 1415.2.0",
  "firmwareVersion": "Firmware Version 1.2.3.4",
  "bootMode": "validated"
  "lastEnrollmentTime": "2012-04-05T17:30:04.325Z",
  "orgUnitPath": "corp/engineering"
}

Update a Chrome device

To update a Chrome device, use the following PUT request and include the authorization described in Authorize requests. For readability, this code sample has line returns:

PUT https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/
devices/chromeos/deviceId?projection={FULL|BASIC}

• The customerId is a unique identifier of the customer's Google account.
• As an account administrator, you can also use the string my_customer which represents your account's customerId. Another way to get the customerId value is to use the Retrieve a user operation. Use your administrator email address or your administrator unique user id value in the operation's userKey path parameter.
• The deviceId is a unique identifier for a device and is found in the response of the Retrieve all Chrome devices operation.

For the query strings, request, and response properties, see the API Reference.

Note: The API also supports the patch semantics.

JSON request

The following example JSON request updates a Chrome device's annotatedUser, annotatedLocation, annotatedAssetId, notes, and orgUnitPath properties. For readability, this code sample has line returns:

PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos/deviceId?projection=full

The request body example:

{
  "deviceId": "device_id_value",
  "annotatedUser": "help desk",
  "annotatedLocation": "Mountain View help desk Chromebook",
  "annotatedAssetId": "1234567890",
  "notes": "Loaned from support",
  "orgUnitPath": "/corp/sales"
}

For an update request, only include the properties with updated values in your request.

Note: The API can only update the annotatedUser, annotatedLocation, annotatedAssetId, notes, and orgUnitPath properties.

A successful request returns an HTTP 200 status code. Along with the status code, the response returns the properties for the updated Chrome device.

Deprovisioning or disabling Chrome devices

Warning:

• Deprovisioning a device stops device policy syncing and removes device-level printers. Once a device is deprovisioned, you must wipe it before it can be re-enrolled.
• Lost or stolen devices should be disabled.
• Re-enabling a disabled device consumes a device license. An error results if you don't have sufficient licenses available when re-enabling a device.

For more information about deprovisioning and disabling devices, visit the help center.

To deprovision or disable Chrome devices, use the following POST request and include the authorization described in Authorize requests. For readability, this code sample has line returns:

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer or customerId/
devices/chromeos:batchChangeStatus

• The customerId is a unique identifier of the customer's Google account.
• As an account administrator, you can also use the string my_customer which represents your account's customerId. Another way to get the customerId value is to use the Retrieve a user operation. Use your administrator email address or your administrator unique user id value in the operation's userKey path parameter.

For the request and response properties, see the API Reference.

JSON request

The following JSON request shows a sample request to deprovision and disable Chrome devices:

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos:batchChangeStatus

The request body for a sample deprovision is:

{
  "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"],
  "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION",
  "deprovisionReason": "DEPROVISION_REASON_RETIRING_DEVICE"
}

The request body for disable is:

  {
    "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"],
    "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE",
  }

A successful request returns an HTTP 200 status code.

Move Chrome devices to Organization Unit

To move up to 50 Chrome devices to an Organization Unit, use the following POST request and include the authorization described in Authorize requests. For readability, this code sample has line returns:

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos/moveDevicesToOu?orgUnitPath=/SomeOuName

• The customerId is a unique identifier of the customer's Google account.
• As an account administrator, you can also use the string my_customer which represents your account's customerId. Another way to get the customerId value is to use the Retrieve a user operation. Use your administrator email address or your administrator unique user id value in the operation's userKey path parameter.

For the request and response properties, see the API Reference.

JSON request

The following JSON request shows a sample request to move 3 Chrome devices to an Organization Unit named /Marketing:

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos/chromeos/moveDevicesToOu?orgUnitPath=/Marketing

The request body for the device move is:

{
  "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"]
}

A successful request returns an HTTP 200 status code.