- HTTP request
- Path parameters
- Query parameters
- Request body
- Response body
- Authorization scopes
- Try it!
Lists Chrome browser profiles of a customer based on the given search and sorting criteria.
HTTP request
GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/profiles
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters | |
|---|---|
parent
|
Required. Format: customers/{customer_id} |
Query parameters
pageSize
integer
Optional. The maximum number of profiles to return. The default page size is 100 if pageSize is unspecified, and the maximum page size allowed is 200.
pageToken
string
Optional. The page token used to retrieve a specific page of the listing request.
filter
string
Optional. The filter used to filter profiles. The following fields can be used in the filter:
- profileId
- displayName
- userEmail
- lastActivityTime
- lastPolicySyncTime
- lastStatusReportTime
- firstEnrollmentTime
- osPlatformType
- osVersion
- browserVersion
- browserChannel
- policyCount
- extensionCount
- identityProvider
- affiliationState
- osPlatformVersion
- ouId
Any of the above fields can be used to specify a filter, and filtering by multiple fields is supported with AND operator. String type fields and enum type fields support '=' and '!=' operators. The integer type and the timestamp type fields support '=', '!=', '<', '>', '<=' and '>=' operators. Timestamps expect an RFC-3339 formatted string (e.g. 2012-04-21T11:30:00-04:00). Wildcard '*' can be used with a string type field filter. In addition, string literal filtering is also supported, for example, 'ABC' as a filter maps to a filter that checks if any of the filterable string type fields contains 'ABC'.
Organization unit number can be used as a filtering criteria here by specifying 'ouId = ${your_org_unit_id}', please note that only single OU ID matching is supported.
orderBy
string
Optional. The fields used to specify the ordering of the results. The supported fields are:
- profileId
- displayName
- userEmail
- lastActivityTime
- lastPolicySyncTime
- lastStatusReportTime
- firstEnrollmentTime
- osPlatformType
- osVersion
- browserVersion
- browserChannel
- policyCount
- extensionCount
- identityProvider
- affiliationState
- osPlatformVersion
By default, sorting is in ascending order, to specify descending order for a field, a suffix " desc" should be added to the field name. The default ordering is the descending order of lastStatusReportTime.
Request body
The request body must be empty.
Response body
Response to profiles.list method.
If successful, the response body contains data with the following structure:
| JSON representation |
|---|
{
"chromeBrowserProfiles"
:
[
{
object (
|
| Fields | |
|---|---|
chromeBrowserProfiles[]
|
The list of profiles returned. |
nextPageToken
|
The pagination token that can be used to list the next page. |
totalSize
|
Total size represents an estimated number of resources returned. Not guaranteed to be accurate above 10k profiles. |
Authorization scopes
Requires one of the following OAuth scopes:
-
https://www.googleapis.com/auth/chrome.management.profiles.readonly -
https://www.googleapis.com/auth/chrome.management.profiles
