针对所选时间范围内即将到期的设备数量生成报告。设备按自动更新到期日期和型号分组。如需了解更多信息,请点击此处。
HTTP 请求
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeDevicesReachingAutoExpirationDate
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
customer |
必需。客户 ID 或“my_customer”,前缀为“customers/”。 |
查询参数
参数 | |
---|---|
orgUnitId |
可选。组织部门 ID(如果省略)将返回所有组织部门的数据。 |
minAueDate |
可选。到期日期,格式为 yyyy-mm-dd(世界协调时间 [UTC] 时区)。如果包含,系统会返回所有已过期的设备以及自动到期日期不早于最短日期的设备。 |
maxAueDate |
可选。到期日期,格式为 yyyy-mm-dd(世界协调时间 [UTC] 时区)。如果包含,系统会返回所有已过期的设备,以及自动到期日期不早于最晚日期的设备。 |
请求正文
请求正文必须为空。
响应正文
包含一系列会在选定时间范围内到期的设备的列表的响应。计数按型号和自动更新到期日期分组。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"deviceAueCountReports": [
{
object ( |
字段 | |
---|---|
deviceAueCountReports[] |
按自动更新到期日期升序排序的报告列表。 |
授权范围
需要以下 OAuth 作用域:
https://www.googleapis.com/auth/chrome.management.reports.readonly
DeviceAueCountReport
CountChromeDevicesPerAueDateResponse 报告,包含特定型号设备的数量和自动更新到期日期。
JSON 表示法 |
---|
{
"model": string,
"count": string,
"aueMonth": enum ( |
字段 | |
---|---|
model |
设备的公开型号名称。 |
count |
此型号的设备的数量。 |
aueMonth |
与自动更新到期日期(UTC 时区)对应的月份的枚举值。如果设备已过期,则此字段为空。 |
aueYear |
与自动更新到期日期(UTC 时区)对应的年份整数值。如果设备已过期,则此字段为空。 |
expired |
表示设备是否已过期的布尔值。 |
月份
表示公历中的月份。
枚举 | |
---|---|
MONTH_UNSPECIFIED |
未指定的月份。 |
JANUARY |
一月。 |
FEBRUARY |
二月。 |
MARCH |
三月。 |
APRIL |
四月份。 |
MAY |
五月。 |
JUNE |
六月。 |
JULY |
7 月份。 |
AUGUST |
8 月份。 |
SEPTEMBER |
9 月份。 |
OCTOBER |
10 月份。 |
NOVEMBER |
11 月份。 |
DECEMBER |
12 月份。 |