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 月。