Method: customers.reports.countChromeDevicesReachingAutoExpirationDate

產生報告，顯示自動更新期限在指定時間範圍內各個月份到期的裝置數量。裝置會依自動更新期限和型號分組。如需更多資訊，請參閱這篇文章。

HTTP 要求

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countChromeDevicesReachingAutoExpirationDate

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
customer

string

必要欄位。客戶 ID 或「my_customer」，開頭為「customers/」。

查詢參數

參數
orgUnitId

string

選用設定。如果省略機構單位 ID，系統會傳回所有機構單位的資料。
minAueDate

string

選用設定。最長到期日為 yyyy-mm-dd (世界標準時間)。如果包含，則會傳回所有已過期的裝置，以及自動到期日等於或晚於最低日期的裝置。
maxAueDate

string

選用設定。以世界標準時間 (UTC) 為準的最大到期日，格式為 yyyy-mm-dd。如果納入，則會傳回已過期的所有裝置，且自動到期日等於或早於最長日期的裝置。

要求主體

要求主體必須為空白。

回應主體

回應包含指定時間範圍內，每月到期的裝置清單。計數會依型號和自動更新到期日分組。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "deviceAueCountReports": [
    {
      object (DeviceAueCountReport)
    }
  ]
}
欄位
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)

月份的列舉值，對應到世界標準時間時區的自動更新到期日。如果裝置已過期，這個欄位會留空。
aueYear

string (int64 format)

對應於世界標準時間時區的一年整數值。如果裝置已過期，這個欄位會留空。
expired

boolean

表示裝置是否已過期的布林值。

月

代表公曆中的一個月。

列舉
MONTH_UNSPECIFIED 未指定的月份。
JANUARY 1 月。
FEBRUARY 2 月。
MARCH 三月。
APRIL 四月。
MAY 五月。
JUNE 6 月。
JULY 七月。
AUGUST 八月。
SEPTEMBER 九月。
OCTOBER 10 月。
NOVEMBER 11 月。
DECEMBER 12 月。