Method: customers.reports.countChromeDevicesReachingAutoExpirationDate

生成报告，显示自动更新期限在所选时间范围内到期的设备数量（按月统计）。设备会按自动更新到期日期和型号分组。如需了解详情，请点击此处。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
customer

string

必需。客户 ID 或前缀为“customers/”的“my_customer”。

查询参数

参数
orgUnitId

string

可选。如果不指定组织部门 ID，系统会返回所有组织部门的数据。
minAueDate

string

可选。以 yyyy-mm-dd 格式表示的 UTC 时区最大到期日期。如果包含，则返回所有已过期的设备，以及自动到期日期等于或晚于最小日期的设备。
maxAueDate

string

可选。最长失效日期，格式为 yyyy-mm-dd（UTC 时区）。如果包含此字段，则系统会返回所有已过期的设备，以及自动到期日期等于或早于最晚日期的设备。

请求正文

请求正文必须为空。

响应正文

包含一系列将在选定时间范围的每月到期的设备的响应。计数会按型号和自动更新到期日期分组。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "deviceAueCountReports": [
    {
      object (DeviceAueCountReport)
    }
  ]
}
字段
deviceAueCountReports[]

object (DeviceAueCountReport)

按自动更新到期日期（从低到高）排序的报告列表。

授权范围

需要以下 OAuth 范围：

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

DeviceAueCountReport

CountChromeDevicesPerAueDateResponse 报告包含特定型号设备的数量和自动更新到期日期。

JSON 表示法 
{
  "model": string,
  "count": string,
  "aueMonth": enum (Month),
  "aueYear": string,
  "expired": boolean
}
字段
model

string

设备的公开型号名称。
count

string (int64 format)

此型号设备的数量。
aueMonth

enum (Month)

与世界协调时间 (UTC) 时区中的自动更新到期日期对应的月份枚举值。如果设备已过期，则此字段为空。
aueYear

string (int64 format)

与世界协调时间 (UTC) 时区中的自动更新到期日期对应的年份的整数值。如果设备已过期，则此字段为空。
expired

boolean

表示设备是否已过期的布尔值。

月

表示公历中的月份。

枚举
MONTH_UNSPECIFIED 未指定的月份。
JANUARY 1 月。
FEBRUARY 2 月。
MARCH 3 月。
APRIL 4 月。
MAY 5 月份。
JUNE 6 月。
JULY 7 月。
AUGUST 8 月。
SEPTEMBER 9 月份。
OCTOBER 10 月。
NOVEMBER 11 月。
DECEMBER 12 月。