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

選用設定。最長到期日為 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 月。