Method: customers.reports.countChromeDevicesReachingAutoExpirationDate
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Genera un report sul numero di dispositivi in scadenza ogni mese dell'intervallo di tempo selezionato. I dispositivi sono raggruppati in base alla data di scadenza degli aggiornamenti automatici e al modello. Qui sono disponibili ulteriori informazioni.
Richiesta HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeDevicesReachingAutoExpirationDate
L'URL utilizza la sintassi di transcodifica gRPC.
Parametri del percorso
Parametri |
customer |
string
Obbligatorio. L'ID cliente o "mio_cliente" preceduto dal prefisso "customers/".
|
Parametri di query
Parametri |
orgUnitId |
string
(Facoltativo) L'ID unità organizzativa, se omesso, restituirà i dati per tutte le unità organizzative.
|
minAueDate |
string
(Facoltativo) Data di scadenza massima nel formato aaaa-mm-gg nel fuso orario UTC. Se viene incluso, vengono restituiti tutti i dispositivi già scaduti e i dispositivi con data di scadenza automatica uguale o successiva alla data minima.
|
maxAueDate |
string
(Facoltativo) Data di scadenza massima nel formato aaaa-mm-gg nel fuso orario UTC. Se incluso, vengono restituiti tutti i dispositivi già scaduti e i dispositivi con data di scadenza automatica uguale o precedente alla data massima.
|
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
Risposta contenente un elenco di dispositivi in scadenza ogni mese di un periodo di tempo selezionato. I conteggi sono raggruppati per modello e per data di scadenza degli aggiornamenti automatici.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Campi |
deviceAueCountReports[] |
object (DeviceAueCountReport )
L'elenco dei report ordinati in base alla data di scadenza degli aggiornamenti automatici in ordine crescente.
|
Ambiti di autorizzazione
Richiede il seguente ambito OAuth:
https://www.googleapis.com/auth/chrome.management.reports.readonly
DeviceAueCountReport
Report per CountChromeDevicesPerAueDateResponse, contiene il conteggio dei dispositivi di un modello specifico e l'intervallo di scadenza degli aggiornamenti automatici.
Rappresentazione JSON |
{
"model": string,
"count": string,
"aueMonth": enum (Month ),
"aueYear": string,
"expired": boolean
} |
Campi |
model |
string
Nome del modello pubblico dei dispositivi.
|
count |
string (int64 format)
Conteggio di dispositivi di questo modello.
|
aueMonth |
enum (Month )
Valore enum del mese corrispondente alla data di scadenza degli aggiornamenti automatici nel fuso orario UTC. Se il dispositivo è già scaduto, il campo è vuoto.
|
aueYear |
string (int64 format)
Valore Int dell'anno corrispondente alla data di scadenza degli aggiornamenti automatici nel fuso orario UTC. Se il dispositivo è già scaduto, il campo è vuoto.
|
expired |
boolean
Valore booleano che indica se il dispositivo è già scaduto o meno.
|
Mese
Rappresenta un mese del calendario gregoriano.
Enum |
MONTH_UNSPECIFIED |
Il mese non specificato. |
JANUARY |
Il mese di gennaio. |
FEBRUARY |
Il mese di febbraio. |
MARCH |
Il mese di marzo. |
APRIL |
Il mese di aprile. |
MAY |
Il mese di maggio. |
JUNE |
Il mese di giugno. |
JULY |
Il mese di luglio. |
AUGUST |
Il mese di agosto. |
SEPTEMBER |
Il mese di settembre. |
OCTOBER |
Il mese di ottobre. |
NOVEMBER |
Il mese di novembre. |
DECEMBER |
Il mese di dicembre. |
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 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. |"]]