Method: customers.reports.countChromeVersions
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
יצירת דוח של גרסאות Chrome מותקנות.
בקשת HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeVersions
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
פרמטרים של נתיב
| פרמטרים |
customer |
string
חובה. מספר לקוח או 'my_customer' כדי להשתמש בלקוח שמשויך לחשבון שממנו נשלחה הבקשה.
|
פרמטרים של שאילתה
| פרמטרים |
orgUnitId |
string
המזהה של היחידה הארגונית.
|
pageSize |
integer
מספר התוצאות המקסימלי שיש להחזיר. הערך המקסימלי וברירת המחדל הוא 100.
|
pageToken |
string
אסימון שמציין את הדף של הבקשה להחזרה.
|
filter |
string
מחרוזת שאילתה לסינון התוצאות, ושדות שמופרדים באמצעות AND בתחביר EBNF. הערה: המסנן הזה לא תומך בפעולות 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
ערוץ ההפצה של הדפדפן המותקן.
| טיפוסים בני מנייה (enum) |
RELEASE_CHANNEL_UNSPECIFIED |
לא צוין ערוץ הפצה. |
CANARY |
ערוץ ההפצה של Canary |
DEV |
ערוץ הפצה למפתחים. |
BETA |
ערוץ הפצה בטא. |
STABLE |
ערוץ הפצה יציב. |
DeviceSystem
| טיפוסים בני מנייה (enum) |
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. |
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-25 (שעון UTC).
[null,null,["עדכון אחרון: 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. |"]]
