Method: customers.reports.countChromeDevicesThatNeedAttention
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
HTTP 要求
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeDevicesThatNeedAttention
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 |
customer |
string
必要欄位。客戶 ID 或「my_customer」開頭為「customers/」。
|
查詢參數
| 參數 |
orgUnitId |
string
選用設定。機構單位的 ID。如果省略此引數，系統會傳回所有資料。
|
readMask |
string (FieldMask format)
必要欄位。應填入傳回的報表中的欄位遮罩。 這是以半形逗號分隔的完整欄位名稱清單。範例："user.displayName,photo"。
|
回應主體
回應包含需要處理的裝置數量。
如果成功，回應主體會含有以下結構的資料：
| JSON 表示法 |
{
"noRecentPolicySyncCount": string,
"noRecentUserActivityCount": string,
"pendingUpdate": string,
"osVersionNotCompliantCount": string,
"unsupportedPolicyCount": string
} |
| 欄位 |
noRecentPolicySyncCount |
string (int64 format)
過去 28 天內未同步處理政策的 ChromeOS 裝置數量。
|
noRecentUserActivityCount |
string (int64 format)
過去 28 天內從未出現任何使用者活動的 ChromeOS 裝置數量。
|
pendingUpdate |
string (int64 format)
尚待 OS 更新的裝置數量。
|
osVersionNotCompliantCount |
string (int64 format)
OS 版本不符合規定的裝置數量。
|
unsupportedPolicyCount |
string (int64 format)
因為 OS 版本不符而無法套用政策的裝置數量。
|
授權範圍
需要下列 OAuth 範圍：
https://www.googleapis.com/auth/chrome.management.reports.readonly
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 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`"]]
