Method: customers.reports.countChromeVersions
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tạo báo cáo về các phiên bản Chrome đã cài đặt.
Yêu cầu HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeVersions
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số |
customer |
string
Bắt buộc. Mã khách hàng hoặc "my_customer" để sử dụng khách hàng liên kết với tài khoản đưa ra yêu cầu.
|
Tham số truy vấn
Tham số |
orgUnitId |
string
Mã của đơn vị tổ chức.
|
pageSize |
integer
Số kết quả tối đa cần trả về. Tối đa và mặc định là 100.
|
pageToken |
string
Mã thông báo để chỉ định trang của yêu cầu cần được trả về.
|
filter |
string
Chuỗi truy vấn để lọc kết quả, các trường được phân tách bằng dấu AND bằng cú pháp EBNF. Lưu ý: Bộ lọc này không hỗ trợ phép toán OR. Các trường bộ lọc được hỗ trợ:
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Phản hồi chứa thông tin chi tiết và số lượng phiên bản trình duyệt được yêu cầu.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
{
"browserVersions": [
{
object (BrowserVersion )
}
],
"nextPageToken": string,
"totalSize": integer
} |
Trường |
browserVersions[] |
object (BrowserVersion )
Danh sách tất cả phiên bản trình duyệt và số lượt cài đặt.
|
nextPageToken |
string
Mã thông báo để chỉ định trang tiếp theo của yêu cầu.
|
totalSize |
integer
Tổng số phiên bản trình duyệt phù hợp với yêu cầu.
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/chrome.management.reports.readonly
BrowserVersion
Mô tả một phiên bản trình duyệt và số lượt cài đặt của phiên bản đó.
Biểu diễn dưới dạng JSON |
{
"version": string,
"count": string,
"channel": enum (ReleaseChannel ),
"system": enum (DeviceSystem ),
"deviceOsVersion": string
} |
Trường |
version |
string
Chỉ có đầu ra. Phiên bản đầy đủ của trình duyệt đã cài đặt.
|
count |
string (int64 format)
Chỉ có đầu ra. Số lượng được nhóm theo device_system và phiên bản chính
|
channel |
enum (ReleaseChannel )
Chỉ có đầu ra. Kênh phát hành của trình duyệt đã cài đặt.
|
system |
enum (DeviceSystem )
Chỉ có đầu ra. Hệ điều hành của thiết bị.
|
deviceOsVersion |
string
Chỉ có đầu ra. Phiên bản của hệ điều hành do hệ thống chỉ định.
|
ReleaseChannel
Kênh phát hành của trình duyệt đã cài đặt.
Enum |
RELEASE_CHANNEL_UNSPECIFIED |
Chưa chỉ định kênh phát hành. |
CANARY |
Kênh phát hành Canary. |
DEV |
Kênh phát hành dành cho nhà phát triển. |
BETA |
Kênh phát hành beta. |
STABLE |
Kênh phát hành ổn định. |
DeviceSystem
Hệ điều hành của thiết bị.
Enum |
DEVICE_SYSTEM_UNSPECIFIED |
Chưa chỉ định hệ điều hành nào. |
SYSTEM_OTHER |
Hệ điều hành khác. |
SYSTEM_ANDROID |
Hệ điều hành Android. |
SYSTEM_IOS |
Hệ điều hành iOS của Apple. |
SYSTEM_CROS |
Hệ điều hành ChromeOS. |
SYSTEM_WINDOWS |
Hệ điều hành Microsoft Windows. |
SYSTEM_MAC |
Hệ điều hành Apple macOS. |
SYSTEM_LINUX |
Hệ điều hành Linux. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 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. |"]]