Method: customers.reports.countChromeHardwareFleetDevices
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
طلب HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeHardwareFleetDevices
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات |
customer |
string
مطلوب. رقم تعريف العميل أو "my_customer".
|
معامِلات طلب البحث
المعلمات |
orgUnitId |
string
اختياريّ. رقم تعريف الوحدة التنظيمية. وفي حال حذفها، سيتم عرض جميع البيانات.
|
readMask |
string (FieldMask format)
مطلوب. قناع الحقول التي يجب ملؤها في التقرير المعروض. هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
استجابة تحتوي على قائمة بالأجهزة التي تتضمّن نوع محدّد من مواصفات الأجهزة من نوع الأجهزة المطلوب.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
الحقول |
modelReports[] |
object (DeviceHardwareCountReport )
تشير هذه السمة إلى DeviceDeviceCountReport لنوع طراز الجهاز (على سبيل المثال Acer C7 Chromebook).
|
cpuReports[] |
object (DeviceHardwareCountReport )
تشير هذه السمة إلى DeviceDeviceCountReport لنوع وحدة المعالجة المركزية (CPU) للجهاز (على سبيل المثال، Intel(R) Core(TM) i7-10610U CPU @ 1.80GHz).
|
storageReports[] |
object (DeviceHardwareCountReport )
DeviceDeviceCountReport لمقدار مساحة التخزين للجهاز بالجيجابايت (على سبيل المثال 128).
|
memoryReports[] |
object (DeviceHardwareCountReport )
DeviceDeviceCountReport لحجم ذاكرة الجهاز بالجيجابايت (على سبيل المثال 16).
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/chrome.management.reports.readonly
DeviceHardwareCountReport
يحتوي تقرير CountChromeDevicesPerDeviceSpecResponse، على عدد الأجهزة التي تتوفّر لها مواصفات فريدة.
تمثيل JSON |
{
"bucket": string,
"count": string
} |
الحقول |
bucket |
string
الاسم العلني لمواصفات الأجهزة.
|
count |
string (int64 format)
عدد الأجهزة التي تتوفّر لها مواصفات أجهزة فريدة
|
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eCounts devices based on hardware specifications like model, CPU, storage, and memory.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003eGET\u003c/code\u003e request to the specified endpoint with \u003ccode\u003ecustomer\u003c/code\u003e, \u003ccode\u003eorgUnitId\u003c/code\u003e, and \u003ccode\u003ereadMask\u003c/code\u003e parameters.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes hardware reports categorized by model, CPU, storage, and memory, each with a bucket and device count.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes the \u003ccode\u003echrome.management.reports.readonly\u003c/code\u003e authorization scope for access.\u003c/p\u003e\n"],["\u003cp\u003eProvides further information via a support link regarding hardware specification details.\u003c/p\u003e\n"]]],[],null,["# Method: customers.reports.countChromeHardwareFleetDevices\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.CountChromeHardwareFleetDevicesResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [DeviceHardwareCountReport](#DeviceHardwareCountReport)\n - [JSON representation](#DeviceHardwareCountReport.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nCounts of devices with a specific hardware specification from the requested hardware type (for example model name, processor type). Further information can be found here \u003chttps://support.google.com/chrome/a/answer/10564947\u003e\n\n### HTTP request\n\n`GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeHardwareFleetDevices`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|------------------------------------------------------|\n| `customer` | `string` Required. The customer ID or \"my_customer\". |\n\n### Query parameters\n\n| Parameters ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `orgUnitId` | `string` Optional. The ID of the organizational unit. If omitted, all data will be returned. |\n| `readMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Required. Mask of the fields that should be populated in the returned report. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse containing a list of devices with a specific type of hardware specification from the requested hardware type.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"modelReports\": [ { object (/chrome/management/reference/rest/v1/customers.reports/countChromeHardwareFleetDevices#DeviceHardwareCountReport) } ], \"cpuReports\": [ { object (/chrome/management/reference/rest/v1/customers.reports/countChromeHardwareFleetDevices#DeviceHardwareCountReport) } ], \"storageReports\": [ { object (/chrome/management/reference/rest/v1/customers.reports/countChromeHardwareFleetDevices#DeviceHardwareCountReport) } ], \"memoryReports\": [ { object (/chrome/management/reference/rest/v1/customers.reports/countChromeHardwareFleetDevices#DeviceHardwareCountReport) } ] } ``` |\n\n| Fields ||\n|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `modelReports[]` | `object (`[DeviceHardwareCountReport](/chrome/management/reference/rest/v1/customers.reports/countChromeHardwareFleetDevices#DeviceHardwareCountReport)`)` The DeviceHardwareCountReport for device model type (for example Acer C7 Chromebook). |\n| `cpuReports[]` | `object (`[DeviceHardwareCountReport](/chrome/management/reference/rest/v1/customers.reports/countChromeHardwareFleetDevices#DeviceHardwareCountReport)`)` The DeviceHardwareCountReport for device cpu type (for example Intel(R) Core(TM) i7-10610U CPU @ 1.80GHz). |\n| `storageReports[]` | `object (`[DeviceHardwareCountReport](/chrome/management/reference/rest/v1/customers.reports/countChromeHardwareFleetDevices#DeviceHardwareCountReport)`)` The DeviceHardwareCountReport for device storage amount in gigabytes (for example 128). |\n| `memoryReports[]` | `object (`[DeviceHardwareCountReport](/chrome/management/reference/rest/v1/customers.reports/countChromeHardwareFleetDevices#DeviceHardwareCountReport)`)` The DeviceHardwareCountReport for device memory amount in gigabytes (for example 16). |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chrome.management.reports.readonly`\n\nDeviceHardwareCountReport\n-------------------------\n\nReport for CountChromeDevicesPerHardwareSpecResponse, contains the count of devices with a unique hardware specification.\n\n| JSON representation |\n|-----------------------------------------------|\n| ``` { \"bucket\": string, \"count\": string } ``` |\n\n| Fields ||\n|----------|--------------------------------------------------------------------------------------------------------------------------------------------|\n| `bucket` | `string` Public name of the hardware specification. |\n| `count` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Count of devices with a unique hardware specification. |"]]