Method: customers.reports.countChromeDevicesReachingAutoExpirationDate
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Wygeneruj raport z liczbą urządzeń, które tracą ważność każdego miesiąca w wybranym okresie. Urządzenia są pogrupowane według daty zakończenia automatycznych aktualizacji i modelu. Więcej informacji znajdziesz tutaj.
Żądanie HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeDevicesReachingAutoExpirationDate
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
| Parametry |
customer |
string
Wymagane. Identyfikator klienta lub „my_customer” poprzedzony ciągiem „customers/”.
|
Parametry zapytania
| Parametry |
orgUnitId |
string
Opcjonalnie: Jeśli identyfikator jednostki organizacyjnej jest pominięty, zwracane są dane ze wszystkich jednostek organizacyjnych.
|
minAueDate |
string
Opcjonalnie: Maksymalna data ważności w formacie rrrr-mm-dd w strefie czasowej UTC. Jeśli ta opcja jest włączona, zwracane są wszystkie urządzenia, które utraciły ważność, oraz urządzenia z automatyczną datą ważności równą lub późniejszą niż data minimalna.
|
maxAueDate |
string
Opcjonalnie: Maksymalna data ważności w formacie rrrr-mm-dd w strefie czasowej UTC. Jeśli uwzględnione, zwracane są wszystkie urządzenia, które utraciły ważność, oraz urządzenia z automatyczną datą ważności równą lub wcześniejszej niż maksymalna data.
|
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Odpowiedź zawierająca listę urządzeń, które tracą ważność każdego miesiąca w wybranym okresie. Liczby są pogrupowane według modelu i daty zakończenia automatycznych aktualizacji.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
| Pola |
deviceAueCountReports[] |
object (DeviceAueCountReport)
Lista raportów posortowana według daty zakończenia automatycznych aktualizacji w kolejności rosnącej.
|
Zakresy autoryzacji
Wymaga następującego zakresu OAuth:
https://www.googleapis.com/auth/chrome.management.reports.readonly
DeviceAueCountReport
Raport dotyczący CountChromeDevicesPerAueDateResponse, który zawiera liczbę urządzeń dla określonego modelu i zakres dat automatycznych aktualizacji.
| Zapis JSON |
{
"model": string,
"count": string,
"aueMonth": enum (Month),
"aueYear": string,
"expired": boolean
} |
| Pola |
model |
string
Publiczna nazwa modelu urządzeń.
|
count |
string (int64 format)
Liczba urządzeń tego modelu.
|
aueMonth |
enum (Month)
Wartość wyliczeniowa miesiąca odpowiadająca dacie zakończenia automatycznych aktualizacji w strefie czasowej UTC. Jeśli urządzenie utraciło ważność, to pole jest puste.
|
aueYear |
string (int64 format)
Wartość całkowita określająca rok odpowiadający dacie zakończenia automatycznych aktualizacji w strefie czasowej UTC. Jeśli urządzenie utraciło ważność, to pole jest puste.
|
expired |
boolean
Wartość logiczna wskazująca, czy urządzenie już utraciło ważność.
|
Miesiąc
Reprezentuje miesiąc w kalendarzu gregoriańskim.
| Wartości w polu enum |
MONTH_UNSPECIFIED |
Nieokreślony miesiąc. |
JANUARY |
Styczeń. |
FEBRUARY |
Luty. |
MARCH |
Marzec. |
APRIL |
Kwiecień. |
MAY |
Maj. |
JUNE |
Czerwiec. |
JULY |
Lipiec. |
AUGUST |
Sierpień. |
SEPTEMBER |
Wrzesień. |
OCTOBER |
Październik. |
NOVEMBER |
Listopad. |
DECEMBER |
Grudzień. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 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. |"]]
