Method: customers.reports.countChromeDevicesReachingAutoExpirationDate
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Générez un rapport sur le nombre d'appareils arrivant à expiration pour chaque mois de la période sélectionnée. Les appareils sont regroupés par date d'expiration de la mise à jour automatique et par modèle. Pour en savoir plus, cliquez ici.
Requête HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeDevicesReachingAutoExpirationDate
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres |
customer |
string
Obligatoire. Numéro client ou "my_customer" précédé de "customers/".
|
Paramètres de requête
Paramètres |
orgUnitId |
string
Facultatif. S'il est omis, l'ID d'unité organisationnelle renvoie les données de toutes les unités organisationnelles.
|
minAueDate |
string
Facultatif. Date d'expiration maximale au format aaaa-mm-jj dans le fuseau horaire UTC. Si elle est incluse, elle renvoie tous les appareils qui sont déjà arrivés à expiration, ainsi que les appareils dont la date d'expiration automatique est ultérieure ou égale à la date minimale.
|
maxAueDate |
string
Facultatif. Date d'expiration maximale au format aaaa-mm-jj dans le fuseau horaire UTC. Si elle est incluse, elle renvoie tous les appareils qui sont déjà arrivés à expiration, ainsi que les appareils dont la date d'expiration automatique est identique ou antérieure à la date maximale.
|
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Réponse contenant la liste des appareils arrivant à expiration pour chaque mois de la période sélectionnée. Les nombres sont regroupés par modèle et par date d'expiration de la mise à jour automatique.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Champs |
deviceAueCountReports[] |
object (DeviceAueCountReport )
Liste des rapports triés par date d'expiration de la mise à jour automatique, dans l'ordre croissant.
|
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/chrome.management.reports.readonly
DeviceAueCountReport
Rapport pour CountChromeDevicesPerAueDateResponse, qui contient le nombre d'appareils d'un modèle spécifique et la plage d'expiration des mises à jour automatiques.
Représentation JSON |
{
"model": string,
"count": string,
"aueMonth": enum (Month ),
"aueYear": string,
"expired": boolean
} |
Champs |
model |
string
Nom de modèle public des appareils.
|
count |
string (int64 format)
Nombre d'appareils de ce modèle.
|
aueMonth |
enum (Month )
Valeur d'énumération du mois correspondant à la date d'expiration de la mise à jour automatique dans le fuseau horaire UTC. Si l'appareil a déjà expiré, ce champ est vide.
|
aueYear |
string (int64 format)
Valeur entière de l'année correspondant à la date d'expiration de la mise à jour automatique dans le fuseau horaire UTC. Si l'appareil a déjà expiré, ce champ est vide.
|
expired |
boolean
Valeur booléenne indiquant si l'appareil est déjà arrivé à expiration.
|
Mois
Représente un mois dans le calendrier grégorien.
Enums |
MONTH_UNSPECIFIED |
Mois non spécifié. |
JANUARY |
Janvier |
FEBRUARY |
Février. |
MARCH |
Le mois de mars. |
APRIL |
Le mois d'avril. |
MAY |
Le mois de mai. |
JUNE |
Le mois de juin. |
JULY |
Juillet. |
AUGUST |
Le mois d'août. |
SEPTEMBER |
Le mois de septembre. |
OCTOBER |
Le mois d'octobre. |
NOVEMBER |
Le mois de novembre. |
DECEMBER |
Le mois de décembre. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 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. |"]]