Method: customers.reports.countChromeVersions
Stay organized with collections
Save and categorize content based on your preferences.
Generate report of installed Chrome versions.
HTTP request
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeVersions
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
customer |
string
Required. Customer id or "my_customer" to use the customer associated to the account making the request.
|
Query parameters
| Parameters |
orgUnitId |
string
The ID of the organizational unit.
|
pageSize |
integer
Maximum number of results to return. Maximum and default are 100.
|
pageToken |
string
Token to specify the page of the request to be returned.
|
filter |
string
Query string to filter results, AND-separated fields in EBNF syntax. Note: OR operations are not supported in this filter. Supported filter fields:
|
Request body
The request body must be empty.
Response body
Response containing requested browser versions details and counts.
If successful, the response body contains data with the following structure:
| JSON representation |
{
"browserVersions": [
{
object (BrowserVersion)
}
],
"nextPageToken": string,
"totalSize": integer
} |
| Fields |
browserVersions[] |
object (BrowserVersion)
List of all browser versions and their install counts.
|
nextPageToken |
string
Token to specify the next page of the request.
|
totalSize |
integer
Total number browser versions matching request.
|
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/chrome.management.reports.readonly
BrowserVersion
Describes a browser version and its install count.
| JSON representation |
{
"version": string,
"count": string,
"channel": enum (ReleaseChannel),
"system": enum (DeviceSystem),
"deviceOsVersion": string
} |
| Fields |
version |
string
Output only. The full version of the installed browser.
|
count |
string (int64 format)
Output only. Count grouped by device_system and major version
|
channel |
enum (ReleaseChannel)
Output only. The release channel of the installed browser.
|
system |
enum (DeviceSystem)
Output only. The device operating system.
|
deviceOsVersion |
string
Output only. Version of the system-specified operating system.
|
ReleaseChannel
The release channel of the installed browser.
| Enums |
RELEASE_CHANNEL_UNSPECIFIED |
No release channel specified. |
CANARY |
Canary release channel. |
DEV |
Dev release channel. |
BETA |
Beta release channel. |
STABLE |
Stable release channel. |
DeviceSystem
The device operating system.
| Enums |
DEVICE_SYSTEM_UNSPECIFIED |
No operating system specified. |
SYSTEM_OTHER |
Other operating system. |
SYSTEM_ANDROID |
Android operating system. |
SYSTEM_IOS |
Apple iOS operating system. |
SYSTEM_CROS |
ChromeOS operating system. |
SYSTEM_WINDOWS |
Microsoft Windows operating system. |
SYSTEM_MAC |
Apple macOS operating system. |
SYSTEM_LINUX |
Linux operating system. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-06-23 UTC.
[null,null,["Last updated 2025-06-23 UTC."],[[["\u003cp\u003eGenerate a report of installed Chrome versions across a customer's organization, grouped by browser version, release channel, and operating system.\u003c/p\u003e\n"],["\u003cp\u003eFilter results by organizational unit and last active date using query parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe response includes the browser version, install count, release channel, operating system, and system version for each entry.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.reports.readonly\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"],["\u003cp\u003eUse the provided HTTP request to retrieve the report data.\u003c/p\u003e\n"]]],[],null,["# Method: customers.reports.countChromeVersions\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.CountChromeVersionsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [BrowserVersion](#BrowserVersion)\n - [JSON representation](#BrowserVersion.SCHEMA_REPRESENTATION)\n- [ReleaseChannel](#ReleaseChannel)\n- [DeviceSystem](#DeviceSystem)\n- [Try it!](#try-it)\n\nGenerate report of installed Chrome versions.\n\n### HTTP request\n\n`GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeVersions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|-------------------------------------------------------------------------------------------------------------------|\n| `customer` | `string` Required. Customer id or \"my_customer\" to use the customer associated to the account making the request. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `orgUnitId` | `string` The ID of the organizational unit. |\n| `pageSize` | `integer` Maximum number of results to return. Maximum and default are 100. |\n| `pageToken` | `string` Token to specify the page of the request to be returned. |\n| `filter` | `string` Query string to filter results, AND-separated fields in EBNF syntax. Note: OR operations are not supported in this filter. Supported filter fields: - last_active_date |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse containing requested browser versions details and counts.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"browserVersions\": [ { object (/chrome/management/reference/rest/v1/customers.reports/countChromeVersions#BrowserVersion) } ], \"nextPageToken\": string, \"totalSize\": integer } ``` |\n\n| Fields ||\n|---------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `browserVersions[]` | `object (`[BrowserVersion](/chrome/management/reference/rest/v1/customers.reports/countChromeVersions#BrowserVersion)`)` List of all browser versions and their install counts. |\n| `nextPageToken` | `string` Token to specify the next page of the request. |\n| `totalSize` | `integer` Total number browser versions matching request. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chrome.management.reports.readonly`\n\nBrowserVersion\n--------------\n\nDescribes a browser version and its install count.\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"version\": string, \"count\": string, \"channel\": enum (/chrome/management/reference/rest/v1/customers.reports/countChromeVersions#ReleaseChannel), \"system\": enum (/chrome/management/reference/rest/v1/customers.reports/countChromeVersions#DeviceSystem), \"deviceOsVersion\": string } ``` |\n\n| Fields ||\n|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `version` | `string` Output only. The full version of the installed browser. |\n| `count` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. Count grouped by device_system and major version |\n| `channel` | `enum (`[ReleaseChannel](/chrome/management/reference/rest/v1/customers.reports/countChromeVersions#ReleaseChannel)`)` Output only. The release channel of the installed browser. |\n| `system` | `enum (`[DeviceSystem](/chrome/management/reference/rest/v1/customers.reports/countChromeVersions#DeviceSystem)`)` Output only. The device operating system. |\n| `deviceOsVersion` | `string` Output only. Version of the system-specified operating system. |\n\nReleaseChannel\n--------------\n\nThe release channel of the installed browser.\n\n| Enums ||\n|-------------------------------|-------------------------------|\n| `RELEASE_CHANNEL_UNSPECIFIED` | No release channel specified. |\n| `CANARY` | Canary release channel. |\n| `DEV` | Dev release channel. |\n| `BETA` | Beta release channel. |\n| `STABLE` | Stable release channel. |\n\nDeviceSystem\n------------\n\nThe device operating system.\n\n| Enums ||\n|-----------------------------|-------------------------------------|\n| `DEVICE_SYSTEM_UNSPECIFIED` | No operating system specified. |\n| `SYSTEM_OTHER` | Other operating system. |\n| `SYSTEM_ANDROID` | Android operating system. |\n| `SYSTEM_IOS` | Apple iOS operating system. |\n| `SYSTEM_CROS` | ChromeOS operating system. |\n| `SYSTEM_WINDOWS` | Microsoft Windows operating system. |\n| `SYSTEM_MAC` | Apple macOS operating system. |\n| `SYSTEM_LINUX` | Linux operating system. |"]]
