Method: customers.reports.countChromeDevicesThatNeedAttention
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
طلب HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeDevicesThatNeedAttention
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
| المعلمات |
customer |
string
مطلوب. الرقم التعريفي للعميل أو "my_customer" مسبوقة بـ "customers/".
|
معامِلات طلب البحث
| المعلمات |
orgUnitId |
string
اختياريّ. رقم تعريف الوحدة التنظيمية. وفي حال حذفها، سيتم عرض جميع البيانات.
|
readMask |
string (FieldMask format)
مطلوب. قناع الحقول التي يجب ملؤها في التقرير المعروض. هذه قائمة مفصولة بفواصل تضم أسماء الحقول المؤهلة بالكامل. مثال: "user.displayName,photo"
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
ردّ يتضمّن أعداد الأجهزة التي تستدعي الانتباه
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"noRecentPolicySyncCount": string,
"noRecentUserActivityCount": string,
"pendingUpdate": string,
"osVersionNotCompliantCount": string,
"unsupportedPolicyCount": string
} |
| الحقول |
noRecentPolicySyncCount |
string (int64 format)
عدد أجهزة ChromeOS التي لم تتم مزامنة السياسات فيها خلال آخر 28 يومًا
|
noRecentUserActivityCount |
string (int64 format)
عدد أجهزة ChromeOS التي لم تشهد أي نشاط مستخدم خلال آخر 28 يومًا
|
pendingUpdate |
string (int64 format)
عدد الأجهزة التي تنتظر تحديث نظام التشغيل.
|
osVersionNotCompliantCount |
string (int64 format)
عدد الأجهزة التي لا يتوافق إصدار نظام التشغيل معها.
|
unsupportedPolicyCount |
string (int64 format)
عدد الأجهزة التي يتعذّر عليها تطبيق سياسة بسبب عدم تطابق إصدار نظام التشغيل
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/chrome.management.reports.readonly
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eCounts ChromeOS devices that need attention, such as those with outdated OS, lacking recent policy sync or user activity.\u003c/p\u003e\n"],["\u003cp\u003eProvides device counts based on criteria like no recent policy sync, user activity, pending updates, OS version compliance, and unsupported policies.\u003c/p\u003e\n"],["\u003cp\u003eUses an HTTP GET request with specific path and query parameters to retrieve the device counts.\u003c/p\u003e\n"],["\u003cp\u003eRequires \u003ccode\u003ehttps://www.googleapis.com/auth/chrome.management.reports.readonly\u003c/code\u003e authorization scope for access.\u003c/p\u003e\n"],["\u003cp\u003eReturns counts as a JSON response with fields detailing the number of devices for each category.\u003c/p\u003e\n"]]],[],null,["# Method: customers.reports.countChromeDevicesThatNeedAttention\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.CountChromeDevicesThatNeedAttentionResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCounts of ChromeOS devices that have not synced policies or have lacked user activity in the past 28 days, are out of date, or are not complaint. 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:countChromeDevicesThatNeedAttention`\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\" prefixed with \"customers/\". |\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 counts for devices that need attention.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"noRecentPolicySyncCount\": string, \"noRecentUserActivityCount\": string, \"pendingUpdate\": string, \"osVersionNotCompliantCount\": string, \"unsupportedPolicyCount\": string } ``` |\n\n| Fields ||\n|------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `noRecentPolicySyncCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Number of ChromeOS devices have not synced policies in the past 28 days. |\n| `noRecentUserActivityCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Number of ChromeOS devices that have not seen any user activity in the past 28 days. |\n| `pendingUpdate` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Number of devices that are pending an OS update. |\n| `osVersionNotCompliantCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Number of devices whose OS version is not compliant. |\n| `unsupportedPolicyCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Number of devices that are unable to apply a policy due to an OS version mismatch. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chrome.management.reports.readonly`"]]
