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)
النتائج فقط. يتم تجميع العدد حسب الجهاز، والإصدار الرئيسي.
|
channel |
enum (ReleaseChannel)
النتائج فقط. قناة إصدار المتصفِّح المثبَّت
|
system |
enum (DeviceSystem)
النتائج فقط. نظام تشغيل الجهاز
|
deviceOsVersion |
string
النتائج فقط. إصدار نظام التشغيل المحدّد من النظام
|
ReleaseChannel
قناة إصدار المتصفِّح المثبَّت
| عمليات التعداد |
RELEASE_CHANNEL_UNSPECIFIED |
لم يتم تحديد أي قناة إصدار. |
CANARY |
قناة إصدار Canary |
DEV |
قناة إصدار مطوّري البرامج |
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. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 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. |"]]
