Method: customers.reports.findInstalledAppDevices

針對已安裝指定應用程式的受管理 Chrome 瀏覽器裝置,產生報表。

HTTP 要求

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

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

路徑參數

參數
customer

string

必要欄位。客戶 ID 或「my_customer」:可使用與提出要求之帳戶相關聯的客戶。

查詢參數

參數
orgUnitId

string

機構單位 ID。

appId

string

應用程式的專屬 ID。如果是 Chrome 應用程式和擴充功能,則為 32 個字元的 ID (例如 ehoadneljpdggcbbknedodolkkjodefl)。如果是 Android 應用程式,套件名稱 (例如 com.evernote)。

appType

enum (AppType)

應用程式類型。

pageSize

integer

要傳回的結果數上限。最大值和預設值為 100。

pageToken

string

用於指定要傳回的要求頁面的符記。

orderBy

string

用於排序結果的欄位。

支援的欄位順序:

  • 機器
  • deviceId
filter

string

用於篩選結果的查詢字串,以 EBNF 語法中的 AND 分隔欄位。

注意:這個篩選器不支援 OR 作業。

支援的篩選器欄位:

  • last_active_date

要求主體

要求主體必須為空白。

回應主體

回應內容包含已安裝查詢應用程式的裝置清單。

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

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

object (Device)

已安裝該應用程式的裝置清單。在 Device.machine 欄位中按遞增順序排序。

nextPageToken

string

用於指定要求下一頁的權杖。

totalSize

integer

符合要求的裝置總數。

授權範圍

需要下列 OAuth 範圍:

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

裝置

說明裝置回報 Chrome 瀏覽器資訊。

JSON 表示法
{
  "deviceId": string,
  "machine": string
}
欄位
deviceId

string

僅供輸出。回報這項 Chrome 瀏覽器資訊的裝置 ID。

machine

string

僅供輸出。本機網路中的電腦名稱。