Method: customers.reports.countChromeDevicesReachingAutoExpirationDate
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tạo báo cáo về số lượng thiết bị hết hạn trong mỗi tháng thuộc khung thời gian đã chọn. Các thiết bị được nhóm theo mẫu và ngày hết hạn tự động cập nhật. Bạn có thể xem thêm thông tin tại đây.
Yêu cầu HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeDevicesReachingAutoExpirationDate
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Tham số |
customer |
string
Bắt buộc. Mã khách hàng hoặc "my_customer" có tiền tố là "customer/".
|
Tham số truy vấn
| Tham số |
orgUnitId |
string
Không bắt buộc. Nếu bạn bỏ qua mã này, mã đơn vị tổ chức sẽ trả về dữ liệu của tất cả các đơn vị tổ chức.
|
minAueDate |
string
Không bắt buộc. Ngày hết hạn tối đa ở định dạng yyyy-mm-dd theo múi giờ UTC. Nếu thuộc tính này được đưa vào, thì hệ thống sẽ trả về tất cả thiết bị đã hết hạn và các thiết bị có ngày hết hạn tự động bằng hoặc sau ngày tối thiểu.
|
maxAueDate |
string
Không bắt buộc. Ngày hết hạn tối đa ở định dạng yyyy-mm-dd theo múi giờ UTC. Nếu thuộc tính này được đưa vào, thì hệ thống sẽ trả về tất cả thiết bị đã hết hạn và các thiết bị có ngày hết hạn tự động bằng hoặc sớm hơn ngày tối đa.
|
Nội dung yêu cầu
Nội dung yêu cầu phải trống.
Nội dung phản hồi
Câu trả lời chứa danh sách các thiết bị sẽ hết hạn sau mỗi tháng trong khung thời gian đã chọn. Số lượng được nhóm theo kiểu máy và Ngày hết hạn tự động cập nhật.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
| Trường |
deviceAueCountReports[] |
object (DeviceAueCountReport)
Danh sách báo cáo được sắp xếp theo ngày hết hạn tự động cập nhật theo thứ tự tăng dần.
|
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/chrome.management.reports.readonly
DeviceAueCountReport
Báo cáo cho CountChromeDevicesPerAueDateResponse, chứa số lượng thiết bị thuộc một mẫu cụ thể và phạm vi ngày hết hạn tự động cập nhật.
| Biểu diễn dưới dạng JSON |
{
"model": string,
"count": string,
"aueMonth": enum (Month),
"aueYear": string,
"expired": boolean
} |
| Trường |
model |
string
Tên mẫu công khai của thiết bị.
|
count |
string (int64 format)
Số lượng thiết bị thuộc mẫu này.
|
aueMonth |
enum (Month)
Giá trị enum của tháng tương ứng với ngày hết hạn tự động cập nhật theo múi giờ UTC. Nếu thiết bị đã hết hạn, trường này sẽ trống.
|
aueYear |
string (int64 format)
Giá trị số nguyên của năm tương ứng với Ngày hết hạn tự động cập nhật theo múi giờ UTC. Nếu thiết bị đã hết hạn, trường này sẽ trống.
|
expired |
boolean
Giá trị boolean cho biết thiết bị đã hết hạn hay chưa.
|
Tháng
Đại diện cho một tháng trong Dương lịch.
| Enum |
MONTH_UNSPECIFIED |
Tháng chưa chỉ định. |
JANUARY |
Tháng 1. |
FEBRUARY |
Tháng Hai. |
MARCH |
Tháng 3. |
APRIL |
Tháng 4. |
MAY |
Tháng 5. |
JUNE |
Tháng 6. |
JULY |
Tháng 7. |
AUGUST |
Tháng 8. |
SEPTEMBER |
Tháng 9. |
OCTOBER |
Tháng 10. |
NOVEMBER |
Tháng 11. |
DECEMBER |
Tháng 12. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eGenerates a report of Chrome devices nearing or past their Auto Update Expiration (AUE) date.\u003c/p\u003e\n"],["\u003cp\u003eDevices are categorized by model and AUE date, with counts provided for each group.\u003c/p\u003e\n"],["\u003cp\u003eReport data can be filtered by organizational unit and AUE date range.\u003c/p\u003e\n"],["\u003cp\u003eUtilizes the \u003ccode\u003ecountChromeDevicesReachingAutoExpirationDate\u003c/code\u003e endpoint with specified path and query parameters.\u003c/p\u003e\n"],["\u003cp\u003eRequires the \u003ccode\u003echrome.management.reports.readonly\u003c/code\u003e OAuth scope for authorization.\u003c/p\u003e\n"]]],[],null,["# Method: customers.reports.countChromeDevicesReachingAutoExpirationDate\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.CountChromeDevicesReachingAutoExpirationDateResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [DeviceAueCountReport](#DeviceAueCountReport)\n - [JSON representation](#DeviceAueCountReport.SCHEMA_REPRESENTATION)\n- [Month](#Month)\n- [Try it!](#try-it)\n\nGenerate report of the number of devices expiring in each month of the selected time frame. Devices are grouped by auto update expiration date and model. Further information can be found [here](https://support.google.com/chrome/a/answer/10564947).\n\n### HTTP request\n\n`GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeDevicesReachingAutoExpirationDate`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|---------------------------------------------------------------------------------|\n| `customer` | `string` Required. The customer ID or \"my_customer\" prefixed with \"customers/\". |\n\n### Query parameters\n\n| Parameters ||\n|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `orgUnitId` | `string` Optional. The organizational unit ID, if omitted, will return data for all organizational units. |\n| `minAueDate` | `string` Optional. Maximum expiration date in format yyyy-mm-dd in UTC timezone. If included returns all devices that have already expired and devices with auto expiration date equal to or later than the minimum date. |\n| `maxAueDate` | `string` Optional. Maximum expiration date in format yyyy-mm-dd in UTC timezone. If included returns all devices that have already expired and devices with auto expiration date equal to or earlier than the maximum date. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nResponse containing a list of devices expiring in each month of a selected time frame. Counts are grouped by model and Auto Update Expiration date.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"deviceAueCountReports\": [ { object (/chrome/management/reference/rest/v1/customers.reports/countChromeDevicesReachingAutoExpirationDate#DeviceAueCountReport) } ] } ``` |\n\n| Fields ||\n|---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `deviceAueCountReports[]` | `object (`[DeviceAueCountReport](/chrome/management/reference/rest/v1/customers.reports/countChromeDevicesReachingAutoExpirationDate#DeviceAueCountReport)`)` The list of reports sorted by auto update expiration date in ascending order. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/chrome.management.reports.readonly`\n\nDeviceAueCountReport\n--------------------\n\nReport for CountChromeDevicesPerAueDateResponse, contains the count of devices of a specific model and auto update expiration range.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"model\": string, \"count\": string, \"aueMonth\": enum (/chrome/management/reference/rest/v1/customers.reports/countChromeDevicesReachingAutoExpirationDate#Month), \"aueYear\": string, \"expired\": boolean } ``` |\n\n| Fields ||\n|------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `model` | `string` Public model name of the devices. |\n| `count` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Count of devices of this model. |\n| `aueMonth` | `enum (`[Month](/chrome/management/reference/rest/v1/customers.reports/countChromeDevicesReachingAutoExpirationDate#Month)`)` Enum value of month corresponding to the auto update expiration date in UTC time zone. If the device is already expired, this field is empty. |\n| `aueYear` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Int value of year corresponding to the Auto Update Expiration date in UTC time zone. If the device is already expired, this field is empty. |\n| `expired` | `boolean` Boolean value for whether or not the device has already expired. |\n\nMonth\n-----\n\nRepresents a month in the Gregorian calendar.\n\n| Enums ||\n|---------------------|-------------------------|\n| `MONTH_UNSPECIFIED` | The unspecified month. |\n| `JANUARY` | The month of January. |\n| `FEBRUARY` | The month of February. |\n| `MARCH` | The month of March. |\n| `APRIL` | The month of April. |\n| `MAY` | The month of May. |\n| `JUNE` | The month of June. |\n| `JULY` | The month of July. |\n| `AUGUST` | The month of August. |\n| `SEPTEMBER` | The month of September. |\n| `OCTOBER` | The month of October. |\n| `NOVEMBER` | The month of November. |\n| `DECEMBER` | The month of December. |"]]
