Method: customers.reports.countChromeDevicesReachingAutoExpirationDate
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Bericht mit der Anzahl der Geräte erstellen, deren Laufzeit in den einzelnen Monaten des ausgewählten Zeitraums abläuft. Die Geräte sind nach Ablaufdatum und Modell der automatischen Updates gruppiert. Weitere Informationen
HTTP-Anfrage
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeDevicesReachingAutoExpirationDate
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter |
customer |
string
Erforderlich. Die Kundennummer oder „my_customer“ mit dem Präfix „customers/“.
|
Abfrageparameter
Parameter |
orgUnitId |
string
Optional. Wenn Sie die ID der Organisationseinheit weglassen, werden Daten für alle Organisationseinheiten zurückgegeben.
|
minAueDate |
string
Optional. Maximales Ablaufdatum im Format jjjj-mm-tt in der UTC-Zeitzone. Wenn angegeben, werden alle Geräte zurückgegeben, die bereits abgelaufen sind, sowie Geräte, deren automatisches Ablaufdatum dem Mindestdatum entspricht oder danach liegt.
|
maxAueDate |
string
Optional. Maximales Ablaufdatum im Format jjjj-mm-tt in der UTC-Zeitzone. Wenn angegeben, werden alle Geräte zurückgegeben, die bereits abgelaufen sind, sowie Geräte, deren automatisches Ablaufdatum dem maximalen Datum entspricht oder davor liegt.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwort mit einer Liste von Geräten, die in den einzelnen Monaten des ausgewählten Zeitraums ablaufen. Die Anzahl wird nach Modell und dem Ende der automatischen Updates gruppiert.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
Felder |
deviceAueCountReports[] |
object (DeviceAueCountReport )
Die Liste der Berichte, sortiert in aufsteigender Reihenfolge nach dem Ende der automatischen Updates.
|
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/chrome.management.reports.readonly
DeviceAueCountReport
Bericht für CountChromeDevicePerAueDateResponse enthält die Anzahl der Geräte eines bestimmten Modells und den Ablaufbereich der automatischen Updates.
JSON-Darstellung |
{
"model": string,
"count": string,
"aueMonth": enum (Month ),
"aueYear": string,
"expired": boolean
} |
Felder |
model |
string
Öffentlicher Modellname der Geräte.
|
count |
string (int64 format)
Anzahl der Geräte dieses Modells.
|
aueMonth |
enum (Month )
Enum-Wert des Monats, der dem Ablaufdatum der automatischen Updates in UTC entspricht Wenn das Gerät bereits abgelaufen ist, ist dieses Feld leer.
|
aueYear |
string (int64 format)
Ganzer Wert des Jahres, der dem Ende der automatischen Updates entspricht, in der Zeitzone UTC. Wenn das Gerät bereits abgelaufen ist, ist dieses Feld leer.
|
expired |
boolean
Boolescher Wert, der angibt, ob das Gerät bereits abgelaufen ist.
|
Monat
Steht für einen Monat im gregorianischen Kalender.
Enums |
MONTH_UNSPECIFIED |
Der nicht angegebene Monat. |
JANUARY |
Der Monat Januar. |
FEBRUARY |
Der Monat Februar. |
MARCH |
Der Monat März. |
APRIL |
Der Monat April. |
MAY |
Der Monat Mai. |
JUNE |
Der Monat Juni. |
JULY |
Der Monat Juli. |
AUGUST |
Der Monat August. |
SEPTEMBER |
Der Monat September. |
OCTOBER |
Der Monat Oktober. |
NOVEMBER |
Der Monat November. |
DECEMBER |
Der Monat Dezember. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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. |"]]