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
УстройствоAueCountReport
Отчет для 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 Логическое значение, указывающее, истек ли срок действия устройства. |
Месяц
Представляет месяц в григорианском календаре.
Перечисления |
---|
MONTH_UNSPECIFIED | Неуказанный месяц. |
JANUARY | Месяц январь. |
FEBRUARY | Месяц февраль. |
MARCH | Месяц март. |
APRIL | Месяц апрель. |
MAY | Месяц май. |
JUNE | Месяц июнь. |
JULY | Июль месяц. |
AUGUST | Месяц август. |
SEPTEMBER | Месяц сентябрь. |
OCTOBER | Месяц октябрь. |
NOVEMBER | Месяц ноябрь. |
DECEMBER | Месяц декабрь. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. 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. |"]]