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 1 月。
FEBRUARY 2 月。
MARCH 3 月。
APRIL 4 月。
MAY 5 月。
JUNE 6 月。
JULY 7 月。
AUGUST 8 月。
SEPTEMBER 9 月。
OCTOBER 10 月。
NOVEMBER 11 月。
DECEMBER 12 月。