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

選用設定。以世界標準時間 (UTC) 為準的最大到期日，格式為 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 4 月。
MAY 五月。
JUNE 六月。
JULY 7 月。
AUGUST 八月。
SEPTEMBER 九月。
OCTOBER 十月。
NOVEMBER 11 月。
DECEMBER 12 月。