Method: chromeosdevices.list

Retrieves a paginated list of Chrome OS devices within an account.

HTTP request

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
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.

Query parameters

Parameters
maxResults

integer

Maximum number of results to return.
orderBy

enum (OrderBy)

Device property to use for sorting results.
orgUnitPath

string

The full path of the organizational unit or its unique ID.
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.
projection

enum (Projection)

Restrict information returned to a set of selected fields.
query

string

Search string in the format given at https://developers.google.com/admin-sdk/directory/v1/list-query-operators
sortOrder

enum (SortOrder)

Whether to return results in ascending or descending order. Must be used with the orderBy parameter.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

JSON representation 
{
  "kind": string,
  "etag": string,
  "chromeosdevices": [
    {
      object (ChromeOsDevice)
    }
  ],
  "nextPageToken": string
}
Fields
kind

string

Kind of resource this is.
etag

string

ETag of the resource.
chromeosdevices[]

object (ChromeOsDevice)

asps.list of Chrome OS Device objects.
nextPageToken

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.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/admin.directory.device.chromeos
  • https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly

For more information, see the OAuth 2.0 Overview.

OrderBy

Enums
ORDER_BY_UNDEFINED
ANNOTATED_LOCATION Chrome device location as annotated by the administrator.
ANNOTATED_USER Chromebook user as annotated by administrator.
LAST_SYNC The date and time the Chrome device was last synchronized with the policy settings in the Admin console.
NOTES Chrome device notes as annotated by the administrator.
SERIAL_NUMBER The Chrome device serial number entered when the device was enabled.
STATUS Chrome device status. For more information, see the <a chromeosdevices.
SUPPORT_END_DATE Chrome device support end date. This is applicable only for devices purchased directly from Google.

Projection

Enums
PROJECTION_UNDEFINED
BASIC Includes only the basic metadata fields (e.g., deviceId, serialNumber, status, and user)
FULL Includes all metadata fields

SortOrder

Enums
SORT_ORDER_UNDEFINED
ASCENDING Ascending order.
DESCENDING Descending order.