Method: customers.reports.countChromeDevicesReachingAutoExpirationDate

针对所选时间范围内即将到期的设备数量生成报告。设备按自动更新到期日期和型号分组。如需了解更多信息,请点击此处

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
customer

string

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

查询参数

参数
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 一月。
FEBRUARY 二月。
MARCH 三月。
APRIL 四月份。
MAY 五月。
JUNE 六月。
JULY 7 月份。
AUGUST 8 月份。
SEPTEMBER 9 月份。
OCTOBER 10 月份。
NOVEMBER 11 月份。
DECEMBER 12 月份。