Method: customers.reports.countChromeDevicesReachingAutoExpirationDate
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
گزارشی از تعداد دستگاه هایی که در هر ماه از بازه زمانی انتخاب شده منقضی می شوند، ایجاد کنید. دستگاه ها بر اساس تاریخ انقضا و مدل به روز رسانی خودکار گروه بندی می شوند. اطلاعات بیشتر را می توان در اینجا یافت.
درخواست HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeDevicesReachingAutoExpirationDate
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
| پارامترها |
|---|
customer | string مورد نیاز. شناسه مشتری یا "my_customer" با پیشوند "customers/". |
پارامترهای پرس و جو
| پارامترها |
|---|
orgUnitId | string اختیاری. شناسه واحد سازمانی، اگر حذف شود، داده‌های همه واحدهای سازمانی را برمی‌گرداند. |
minAueDate | string اختیاری. حداکثر تاریخ انقضا در قالب yyyy-mm-dd در منطقه زمانی UTC. اگر گنجانده شود، همه دستگاه‌هایی که قبلاً منقضی شده‌اند و دستگاه‌هایی با تاریخ انقضای خودکار برابر یا دیرتر از حداقل تاریخ را برمی‌گرداند. |
maxAueDate | string اختیاری. حداکثر تاریخ انقضا در قالب yyyy-mm-dd در منطقه زمانی 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 ) مقدار تعداد ماه مربوط به تاریخ انقضای به‌روزرسانی خودکار در منطقه زمانی UTC. اگر دستگاه قبلا منقضی شده باشد، این قسمت خالی است. |
aueYear | string ( int64 format) مقدار واقعی سال مربوط به تاریخ انقضای به‌روزرسانی خودکار در منطقه زمانی UTC. اگر دستگاه قبلا منقضی شده باشد، این قسمت خالی است. |
expired | boolean مقدار بولی برای اینکه آیا دستگاه قبلا منقضی شده است یا خیر. |
ماه
نشان دهنده یک ماه در تقویم میلادی است.
| Enums |
|---|
MONTH_UNSPECIFIED | ماه نامشخص |
JANUARY | ماه ژانویه. |
FEBRUARY | ماه فوریه. |
MARCH | ماه مارس. |
APRIL | ماه آوریل. |
MAY | ماه می. |
JUNE | ماه ژوئن. |
JULY | ماه جولای. |
AUGUST | ماه آگوست. |
SEPTEMBER | ماه سپتامبر. |
OCTOBER | ماه اکتبر. |
NOVEMBER | ماه نوامبر. |
DECEMBER | ماه دسامبر. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-07-25 بهوقت ساعت هماهنگ جهانی."],[[["\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. |"]]
