Method: customers.reports.countChromeDevicesThatNeedAttention

  • This page describes how to retrieve counts of ChromeOS devices that require attention using a GET HTTP request.

  • Devices needing attention include those that haven't synced policies or had user activity in 28 days, are outdated, or are non-compliant.

  • The request requires a customer ID as a path parameter and can optionally include an organizational unit ID and a read mask as query parameters.

  • The response body will contain counts for different categories of devices needing attention, such as those with no recent policy sync, no recent user activity, pending updates, non-compliant OS versions, and unsupported policies.

  • The request requires authorization using the https://www.googleapis.com/auth/chrome.management.reports.readonly OAuth scope.

Counts 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 https://support.google.com/chrome/a/answer/10564947

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