Method: customers.reports.countChromeDevicesReachingAutoExpirationDate

Generate report of the number of devices expiring in each month of the selected time frame. Devices are grouped by auto update expiration date and model. Further information can be found here.

HTTP request

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeDevicesReachingAutoExpirationDate

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 organizational unit ID, if omitted, will return data for all organizational units.

minAueDate

string

Optional. Maximum expiration date in format yyyy-mm-dd in UTC timezone. If included returns all devices that have already expired and devices with auto expiration date equal to or later than the minimum date.

maxAueDate

string

Optional. Maximum expiration date in format yyyy-mm-dd in UTC timezone. If included returns all devices that have already expired and devices with auto expiration date equal to or earlier than the maximum date.

Request body

The request body must be empty.

Response body

Response containing a list of devices expiring in each month of a selected time frame. Counts are grouped by model and Auto Update Expiration date.

If successful, the response body contains data with the following structure:

JSON representation
{
  "deviceAueCountReports": [
    {
      object (DeviceAueCountReport)
    }
  ]
}
Fields
deviceAueCountReports[]

object (DeviceAueCountReport)

The list of reports sorted by auto update expiration date in ascending order.

Authorization scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/chrome.management.reports.readonly

DeviceAueCountReport

Report for CountChromeDevicesPerAueDateResponse, contains the count of devices of a specific model and auto update expiration range.

JSON representation
{
  "model": string,
  "count": string,
  "aueMonth": enum (Month),
  "aueYear": string,
  "expired": boolean
}
Fields
model

string

Public model name of the devices.

count

string (int64 format)

Count of devices of this model.

aueMonth

enum (Month)

Enum value of month corresponding to the auto update expiration date in UTC time zone. If the device is already expired, this field is empty.

aueYear

string (int64 format)

Int value of year corresponding to the Auto Update Expiration date in UTC time zone. If the device is already expired, this field is empty.

expired

boolean

Boolean value for whether or not the device has already expired.

Month

Represents a month in the Gregorian calendar.

Enums
MONTH_UNSPECIFIED The unspecified month.
JANUARY The month of January.
FEBRUARY The month of February.
MARCH The month of March.
APRIL The month of April.
MAY The month of May.
JUNE The month of June.
JULY The month of July.
AUGUST The month of August.
SEPTEMBER The month of September.
OCTOBER The month of October.
NOVEMBER The month of November.
DECEMBER The month of December.