Method: customers.reports.findInstalledAppDevices

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

HTTP 要求

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

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

路徑參數

參數
customer

string

必要欄位。「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

僅供輸出。區域網路中的機器名稱。