Method: customers.reports.countChromeDevicesReachingAutoExpirationDate
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Buat laporan jumlah perangkat yang masa berlakunya akan habis di setiap bulan dalam jangka waktu yang dipilih. Perangkat dikelompokkan menurut model dan tanggal habis masa berlaku update otomatis. Informasi lebih lanjut dapat ditemukan di sini.
Permintaan HTTP
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeDevicesReachingAutoExpirationDate
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter |
customer |
string
Wajib diisi. ID pelanggan atau "my_customer" diawali dengan "customers/".
|
Parameter kueri
Parameter |
orgUnitId |
string
Opsional. ID unit organisasi, jika dihilangkan, akan menampilkan data untuk semua unit organisasi.
|
minAueDate |
string
Opsional. Tanggal habis masa berlaku maksimum dalam format yyyy-mm-dd dalam zona waktu UTC. Jika disertakan, tampilkan semua perangkat yang telah habis masa berlakunya dan perangkat dengan tanggal habis masa berlaku otomatis yang sama dengan atau lebih lama dari tanggal minimum.
|
maxAueDate |
string
Opsional. Tanggal habis masa berlaku maksimum dalam format yyyy-mm-dd dalam zona waktu UTC. Jika disertakan, tampilkan semua perangkat yang telah habis masa berlakunya dan perangkat dengan tanggal habis masa berlaku otomatis yang sama dengan atau lebih awal dari tanggal maksimum.
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Respons berisi daftar perangkat yang masa berlakunya akan habis di setiap bulan selama jangka waktu yang dipilih. Jumlah dikelompokkan menurut model dan tanggal Batas Akhir Update Otomatis.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Kolom |
deviceAueCountReports[] |
object (DeviceAueCountReport )
Daftar laporan diurutkan berdasarkan tanggal habis masa berlaku update otomatis dalam urutan menaik.
|
Cakupan otorisasi
Memerlukan cakupan OAuth berikut:
https://www.googleapis.com/auth/chrome.management.reports.readonly
DeviceAueCountReport
Laporan untuk CountChromeDevicesPerAueDateResponse, berisi jumlah perangkat model tertentu dan rentang habis masa berlaku update otomatisnya.
Representasi JSON |
{
"model": string,
"count": string,
"aueMonth": enum (Month ),
"aueYear": string,
"expired": boolean
} |
Kolom |
model |
string
Nama model publik perangkat.
|
count |
string (int64 format)
Jumlah perangkat model ini.
|
aueMonth |
enum (Month )
Nilai enum bulan yang sesuai dengan tanggal habis masa berlaku update otomatis dalam zona waktu UTC. Jika masa berlaku perangkat sudah berakhir, kolom ini kosong.
|
aueYear |
string (int64 format)
Nilai tahun yang sesuai dengan tanggal Batas Akhir Update Otomatis dalam zona waktu UTC. Jika masa berlaku perangkat sudah berakhir, kolom ini kosong.
|
expired |
boolean
Nilai Boolean untuk mengetahui apakah perangkat telah kedaluwarsa atau belum.
|
Bulan
Mewakili bulan dalam kalender Gregorian.
Enum |
MONTH_UNSPECIFIED |
Bulan yang tidak ditentukan. |
JANUARY |
Bulan Januari. |
FEBRUARY |
Bulan Februari. |
MARCH |
Bulan Maret. |
APRIL |
Bulan April. |
MAY |
Bulan Mei. |
JUNE |
Bulan Juni. |
JULY |
Bulan Juli. |
AUGUST |
Bulan Agustus. |
SEPTEMBER |
Bulan September. |
OCTOBER |
Bulan Oktober. |
NOVEMBER |
Bulan November. |
DECEMBER |
Bulan Desember. |
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 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. |"]]