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 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-25 (שעון UTC)."],[[["\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`"]]