Method: customers.reports.countChromeDevicesReachingAutoExpirationDate
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
선택한 기간 동안 매월 만료되는 기기 수에 관한 보고서를 생성합니다. 기기는 자동 업데이트 만료일 및 모델별로 그룹화됩니다. 자세한 내용은 여기를 참고하세요.
HTTP 요청
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeDevicesReachingAutoExpirationDate
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 |
customer |
string
필수 항목입니다. 고객 ID 또는 'my_customer' 'customers/'로 시작됩니다.
|
쿼리 매개변수
매개변수 |
orgUnitId |
string
선택사항입니다. 조직 단위 ID를 생략하면 모든 조직 단위의 데이터가 반환됩니다.
|
minAueDate |
string
선택사항입니다. UTC 시간대로 yyyy-mm-dd 형식의 최대 만료일입니다. 포함할 경우 이미 만료된 모든 기기와 자동 만료일이 최소 날짜 이후인 기기를 반환합니다.
|
maxAueDate |
string
선택사항입니다. UTC 시간대로 yyyy-mm-dd 형식의 최대 만료일입니다. 포함할 경우 이미 만료된 모든 기기와 자동 만료일이 최대 날짜와 같거나 그 이전인 기기를 반환합니다.
|
응답 본문
선택한 기간 동안 매월 만료되는 기기 목록이 포함된 응답입니다. 개수는 모델 및 자동 업데이트 만료일별로 그룹화됩니다.
성공할 경우 응답 본문에 다음 구조의 데이터가 포함됩니다.
필드 |
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)
자동 업데이트 만료일에 해당하는 연도의 Int 값(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월입니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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. |"]]