Method: customers.reports.countChromeDevicesReachingAutoExpirationDate

針對指定時間範圍內每個月到期的裝置產生報表。裝置會依自動更新期限和型號分類。詳情請參閱這裡。

HTTP 要求

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

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

路徑參數

參數
customer

string

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

查詢參數

參數
orgUnitId

string

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

string

選用設定。到期日上限，格式為 yyyy-mm-dd (世界標準時間)。如果納入指定屬性，系統會傳回所有已過期的裝置，以及自動到期日等於或晚於最短日期的裝置。
maxAueDate

string

選用設定。到期日上限，格式為 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 3 月。
APRIL 4 月。
MAY 5 月。
JUNE 6 月。
JULY 7 月。
AUGUST 8 月。
SEPTEMBER 9 月。
OCTOBER 10 月。
NOVEMBER 11 月。
DECEMBER 12 月。