Method: customers.reports.countChromeDevicesReachingAutoExpirationDate
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Gere um relatório do número de dispositivos que expiram em cada mês do período selecionado. Os dispositivos são agrupados por modelo e data de validade da atualização automática. Confira mais informações neste link.
Solicitação HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeDevicesReachingAutoExpirationDate
O URL usa a sintaxe de transcodificação gRPC.
Parâmetros de caminho
Parâmetros |
customer |
string
Obrigatório. O ID de cliente ou "my_customer" com o prefixo "customers/".
|
Parâmetros de consulta
Parâmetros |
orgUnitId |
string
Opcional. O ID da unidade organizacional, se omitido, retornará dados de todas as unidades organizacionais.
|
minAueDate |
string
Opcional. Data de validade máxima no formato aaaa-mm-dd no fuso horário UTC. Se incluído, retorna todos os dispositivos que já expiraram e os dispositivos com data de expiração automática igual ou posterior à data mínima.
|
maxAueDate |
string
Opcional. Data de validade máxima no formato aaaa-mm-dd no fuso horário UTC. Se incluído, retorna todos os dispositivos que já expiraram e aqueles com data de expiração automática igual ou anterior à data máxima.
|
Corpo da solicitação
O corpo da solicitação precisa estar vazio.
Corpo da resposta
Resposta com uma lista de dispositivos que expiram em cada mês de um período selecionado. As contagens são agrupadas por modelo e data de expiração da atualização automática.
Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:
Campos |
deviceAueCountReports[] |
object (DeviceAueCountReport )
A lista de relatórios classificada por data de validade da atualização automática em ordem crescente.
|
Escopos de autorização
Requer o seguinte escopo OAuth:
https://www.googleapis.com/auth/chrome.management.reports.readonly
DeviceAueCountReport
O relatório de CountChromeDevicesPerAueDateResponse contém o número de dispositivos de um modelo específico e o período de expiração da atualização automática.
Representação JSON |
{
"model": string,
"count": string,
"aueMonth": enum (Month ),
"aueYear": string,
"expired": boolean
} |
Campos |
model |
string
Nome do modelo público dos dispositivos.
|
count |
string (int64 format)
Contagem de dispositivos deste modelo.
|
aueMonth |
enum (Month )
Valor de enumeração do mês correspondente à data de expiração da atualização automática no fuso horário UTC. Se o dispositivo já tiver expirado, este campo estará vazio.
|
aueYear |
string (int64 format)
Valor inteiro do ano correspondente à data de expiração da atualização automática no fuso horário UTC. Se o dispositivo já tiver expirado, este campo estará vazio.
|
expired |
boolean
Valor booleano que indica se o dispositivo já expirou.
|
Mês
Representa um mês do calendário gregoriano.
Enums |
MONTH_UNSPECIFIED |
O mês não especificado. |
JANUARY |
O mês de janeiro. |
FEBRUARY |
Fevereiro. |
MARCH |
O mês de março. |
APRIL |
O mês de abril. |
MAY |
O mês de maio. |
JUNE |
O mês de junho. |
JULY |
O mês de julho. |
AUGUST |
O mês de agosto. |
SEPTEMBER |
O mês de setembro. |
OCTOBER |
O mês de outubro. |
NOVEMBER |
O mês de novembro. |
DECEMBER |
O mês de dezembro. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 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. |"]]