Method: customers.reports.countChromeDevicesReachingAutoExpirationDate
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
選択した期間の各月に期限切れになるデバイスの数に関するレポートを生成します。デバイスは、自動更新の有効期限とモデル別に分類されています。詳しくはこちらをご覧ください。
HTTP リクエスト
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeDevicesReachingAutoExpirationDate
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ |
customer |
string
必須。お客様 ID または「my_customer」先頭に「customers/」が付きます。
|
クエリ パラメータ
パラメータ |
orgUnitId |
string
省略可。組織部門 ID を省略すると、すべての組織部門のデータが返されます。
|
minAueDate |
string
省略可。最大有効期限(UTC タイムゾーンの yyyy-mm-dd 形式)。これを含めると、すでに有効期限が切れているすべてのデバイスと、自動有効期限が最小日付以上のデバイスが返されます。
|
maxAueDate |
string
省略可。最大有効期限(UTC タイムゾーンの yyyy-mm-dd 形式)。これを含めると、すでに有効期限が切れているすべてのデバイスと、自動有効期限が最長日以前のデバイスが返されます。
|
リクエスト本文
リクエストの本文は空にする必要があります。
レスポンスの本文
選択した期間の各月に期限切れとなるデバイスのリストを含むレスポンス。数は、モデルと自動更新の有効期限別にグループ化されます。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
フィールド |
deviceAueCountReports[] |
object (DeviceAueCountReport )
自動更新の有効期限の昇順で並べ替えられたレポートのリスト。
|
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/chrome.management.reports.readonly
DeviceAueCountReport
CountChromeDevicesPerAueDateResponse のレポートに、特定のモデルのデバイス数と自動更新の有効期限が含まれます。
JSON 表現 |
{
"model": string,
"count": string,
"aueMonth": enum (Month ),
"aueYear": string,
"expired": boolean
} |
フィールド |
model |
string
デバイスの公開モデル名。
|
count |
string (int64 format)
このモデルのデバイス数。
|
aueMonth |
enum (Month )
自動更新の有効期限に対応する月の列挙値(UTC タイムゾーン)。デバイスの有効期限が切れている場合、このフィールドは空です。
|
aueYear |
string (int64 format)
自動更新の有効期限に対応する年の int 値(UTC タイムゾーン)。デバイスの有効期限が切れている場合、このフィールドは空です。
|
expired |
boolean
デバイスの有効期限が切れているかどうかを示すブール値。
|
月
列挙型 |
MONTH_UNSPECIFIED |
指定されていない月。 |
JANUARY |
1 月。 |
FEBRUARY |
2 月。 |
MARCH |
3 月。 |
APRIL |
4 月。 |
MAY |
5 月。 |
JUNE |
6 月。 |
JULY |
7 月。 |
AUGUST |
8 月。 |
SEPTEMBER |
9 月。 |
OCTOBER |
10 月。 |
NOVEMBER |
11 月。 |
DECEMBER |
12 月。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-07-25 UTC。
[null,null,["最終更新日 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. |"]]