Method: customers.reports.countChromeDevicesReachingAutoExpirationDate
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
สร้างรายงานจำนวนอุปกรณ์ที่หมดอายุในแต่ละเดือนในช่วงเวลาที่เลือก ระบบจัดกลุ่มอุปกรณ์ตามวันสิ้นสุดการอัปเดตอัตโนมัติและรุ่น ดูข้อมูลเพิ่มเติมได้ที่นี่
คำขอ HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeDevicesReachingAutoExpirationDate
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ |
customer |
string
ต้องระบุ รหัสลูกค้าหรือ "my_customer" ขึ้นต้นด้วย "customers/"
|
พารามิเตอร์การค้นหา
พารามิเตอร์ |
orgUnitId |
string
ไม่บังคับ รหัสหน่วยขององค์กร (หากไม่มีการระบุไว้) จะแสดงข้อมูลของหน่วยขององค์กรทั้งหมด
|
minAueDate |
string
ไม่บังคับ วันที่หมดอายุสูงสุดในรูปแบบ ปปปป-ดด-วว ในเขตเวลา UTC หาก "รวม" จะแสดงผลอุปกรณ์ทั้งหมดที่หมดอายุแล้วและอุปกรณ์ที่มีวันที่หมดอายุอัตโนมัติเท่ากับหรือมากกว่าวันที่ขั้นต่ำ
|
maxAueDate |
string
ไม่บังคับ วันที่หมดอายุสูงสุดในรูปแบบ ปปปป-ดด-วว ในเขตเวลา UTC หาก "รวม" จะแสดงผลอุปกรณ์ทั้งหมดที่หมดอายุแล้วและอุปกรณ์ที่มีวันที่หมดอายุอัตโนมัติเท่ากับหรือเร็วกว่าวันที่สิ้นสุดสูงสุด
|
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
คำตอบที่มีรายการอุปกรณ์ที่หมดอายุในแต่ละเดือนในช่วงเวลาที่เลือก จำนวนจะจัดกลุ่มตามรุ่นและวันสิ้นสุดการอัปเดตอัตโนมัติ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
ช่อง |
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 )
ค่า enum ของเดือนที่ตรงกับวันที่หมดอายุของการอัปเดตอัตโนมัติในเขตเวลา UTC หากอุปกรณ์หมดอายุแล้ว ช่องนี้จะว่างเปล่า
|
aueYear |
string (int64 format)
ค่า Int ของปีที่สอดคล้องกับวันสิ้นสุดการอัปเดตอัตโนมัติในเขตเวลา UTC หากอุปกรณ์หมดอายุแล้ว ช่องนี้จะว่างเปล่า
|
expired |
boolean
ค่าบูลีนที่ระบุว่าอุปกรณ์หมดอายุแล้วหรือไม่
|
เดือน
แสดงเดือนในปฏิทินเกรกอเรียน
Enum |
MONTH_UNSPECIFIED |
เดือนที่ไม่ได้ระบุ |
JANUARY |
เดือนมกราคม |
FEBRUARY |
เดือนกุมภาพันธ์ |
MARCH |
มีนาคม |
APRIL |
เดือนเมษายน |
MAY |
เดือนพฤษภาคม |
JUNE |
เดือนมิถุนายน |
JULY |
เดือนกรกฎาคม |
AUGUST |
เดือนสิงหาคม |
SEPTEMBER |
เดือนกันยายน |
OCTOBER |
เดือนตุลาคม |
NOVEMBER |
เดือนพฤศจิกายน |
DECEMBER |
เดือนธันวาคม |
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-25 UTC
[null,null,["อัปเดตล่าสุด 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. |"]]