Method: customers.reports.countChromeVersions
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeVersions
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 |
customer |
string
必要欄位。客戶 ID 或「my_customer」使用與提出要求之帳戶相關聯的客戶。
|
查詢參數
參數 |
orgUnitId |
string
機構單位的 ID。
|
pageSize |
integer
要傳回的結果數上限。最大值和預設值為 100。
|
pageToken |
string
用於指定待傳回要求頁面的權杖。
|
filter |
string
篩選結果的查詢字串,以及採用 EBNF 語法的「AND」分隔欄位。 注意:這個篩選器不支援 OR 作業。 支援的篩選器欄位:
|
回應主體
回應包含要求的瀏覽器版本詳情和計數。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
{
"browserVersions": [
{
object (BrowserVersion )
}
],
"nextPageToken": string,
"totalSize": integer
} |
欄位 |
browserVersions[] |
object (BrowserVersion )
所有瀏覽器版本的清單和安裝計數。
|
nextPageToken |
string
用於指定要求下一頁的權杖。
|
totalSize |
integer
與要求相符的瀏覽器版本總數。
|
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/chrome.management.reports.readonly
BrowserVersion
JSON 表示法 |
{
"version": string,
"count": string,
"channel": enum (ReleaseChannel ),
"system": enum (DeviceSystem ),
"deviceOsVersion": string
} |
欄位 |
version |
string
僅供輸出。已安裝瀏覽器的完整版本。
|
count |
string (int64 format)
僅供輸出。按 device_system 和主要版本分組的數量
|
channel |
enum (ReleaseChannel )
僅供輸出。已安裝瀏覽器的發布版本。
|
system |
enum (DeviceSystem )
僅供輸出。裝置作業系統。
|
deviceOsVersion |
string
僅供輸出。系統指定的作業系統版本。
|
ReleaseChannel
列舉 |
RELEASE_CHANNEL_UNSPECIFIED |
未指定發布版本。 |
CANARY |
Canary 發布版本。 |
DEV |
開發人員發布版本。 |
BETA |
Beta 版發布版本。 |
STABLE |
穩定版發布版本。 |
DeviceSystem
列舉 |
DEVICE_SYSTEM_UNSPECIFIED |
未指定作業系統。 |
SYSTEM_OTHER |
其他作業系統。 |
SYSTEM_ANDROID |
Android 作業系統。 |
SYSTEM_IOS |
Apple iOS 作業系統。 |
SYSTEM_CROS |
ChromeOS 作業系統。 |
SYSTEM_WINDOWS |
Microsoft Windows 作業系統。 |
SYSTEM_MAC |
Apple macOS 作業系統。 |
SYSTEM_LINUX |
適用於 Linux 作業系統 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[[["\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. |"]]