Method: customers.reports.countChromeDevicesThatNeedAttention
Stay organized with collections
Save and categorize content based on your preferences.
HTTP request
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeDevicesThatNeedAttention
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
customer |
string
Required. The customer ID or "my_customer" prefixed with "customers/".
|
Query parameters
| Parameters |
orgUnitId |
string
Optional. The ID of the organizational unit. If omitted, all data will be returned.
|
readMask |
string (FieldMask 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".
|
Request body
The request body must be empty.
Response body
Response containing counts for devices that need attention.
If successful, the response body contains data with the following structure:
| JSON representation |
{
"noRecentPolicySyncCount": string,
"noRecentUserActivityCount": string,
"pendingUpdate": string,
"osVersionNotCompliantCount": string,
"unsupportedPolicyCount": string
} |
| Fields |
noRecentPolicySyncCount |
string (int64 format)
Number of ChromeOS devices have not synced policies in the past 28 days.
|
noRecentUserActivityCount |
string (int64 format)
Number of ChromeOS devices that have not seen any user activity in the past 28 days.
|
pendingUpdate |
string (int64 format)
Number of devices that are pending an OS update.
|
osVersionNotCompliantCount |
string (int64 format)
Number of devices whose OS version is not compliant.
|
unsupportedPolicyCount |
string (int64 format)
Number of devices that are unable to apply a policy due to an OS version mismatch.
|
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/chrome.management.reports.readonly
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-06-23 UTC.
[null,null,["Last updated 2025-06-23 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`"]]
