Method: customers.apps.fetchDevicesRequestingExtension

取得已要求安裝擴充功能的裝置清單。

HTTP 要求

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/apps:fetchDevicesRequestingExtension

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

路徑參數

參數
customer

string

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

查詢參數

參數
extensionId

string

必要欄位。用來尋找要求裝置的擴充功能。

pageSize

integer

選用設定。要傳回的結果數上限。最大值和預設值為 50。系統會將大小超過 50 的頁面強制轉換為 50。

pageToken

string

選用設定。指定要傳回要求頁面的權杖。權杖會在 1 天後失效。

orgUnitId

string

機構單位的 ID。只考量直接隸屬於這個機構單位的裝置,例如子機構單位不列入計算。如果省略,系統會傳回所有資料。

要求主體

要求主體必須為空白。

回應主體

回應中包含要求查詢的擴充功能的裝置清單。

如果成功,回應主體即會包含具有以下結構的資料:

JSON 表示法
{
  "deviceDetails": [
    {
      object (DeviceRequestingExtensionDetails)
    }
  ],
  "totalSize": integer,
  "nextPageToken": string
}
欄位
deviceDetails[]

object (DeviceRequestingExtensionDetails)

要求查詢擴充功能的裝置詳細資料。

totalSize

integer

選用設定。回應的裝置總數。

nextPageToken

string

選用設定。用於指定清單中下一頁的符記。權杖會在 1 天後失效。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/chrome.management.appdetails.readonly

DeviceRequestingExtensionDetails

要求延長使用期限的裝置詳細資料,包括裝置名稱和要求的理由。

JSON 表示法
{
  "deviceName": string,
  "justification": string
}
欄位
deviceName

string

要求擴充功能的裝置名稱。

justification

string

使用者輸入的要求理由。