Method: customers.reports.countInstalledApps

產生應用程式安裝報表。

HTTP 要求

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

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

路徑參數

參數
customer

string

必要欄位。「my_customer」以使用與提出要求帳戶相關聯的客戶。

查詢參數

參數
orgUnitId

string

機構單位的 ID。
pageSize

integer

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

string

指定要傳回要求頁面的權杖。
filter

string

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

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

支援的篩選器欄位：

  • app_name
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • latest_profile_active_date
  • permission_name
  • appId
orderBy

string

用於排序結果的欄位。

支援的順序 (依欄位區分)：

  • app_name
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • appId

要求主體

要求主體必須為空白。

回應主體

包含查詢已安裝應用程式詳細資料的回應。

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

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

object (InstalledApp)

符合要求的已安裝應用程式清單。
nextPageToken

string

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

integer

已安裝的應用程式總數與要求相符。

授權範圍

需要下列 OAuth 範圍：

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

InstalledApp

說明已安裝的應用程式。

JSON 表示法 
{
  "appId": string,
  "appType": enum (AppType),
  "browserDeviceCount": string,
  "osUserCount": string,
  "appInstallType": enum (AppInstallType),
  "disabled": boolean,
  "appSource": enum (AppSource),
  "displayName": string,
  "description": string,
  "homepageUri": string,
  "permissions": [
    string
  ]
}
欄位
appId

string

僅供輸出。應用程式的專屬 ID。如果是 Chrome 應用程式和擴充功能，則可使用 32 個字元的 ID (例如 ehoadneljpdggcbbknedodolkkjodefl)。Android 應用程式則是套件名稱 (例如 com.evernote)。
appType

enum (AppType)

僅供輸出。應用程式類型。
browserDeviceCount

string (int64 format)

僅供輸出。已安裝這個應用程式的瀏覽器裝置數量。
osUserCount

string (int64 format)

僅供輸出。已安裝這個應用程式的 ChromeOS 使用者人數。
appInstallType

enum (AppInstallType)

僅供輸出。應用程式的安裝方式。
disabled

boolean

僅供輸出。應用程式是否已停用。
appSource

enum (AppSource)

僅供輸出。已安裝應用程式的來源。
displayName

string

僅供輸出。已安裝應用程式的名稱。
description

string

僅供輸出。已安裝應用程式的說明。
homepageUri

string

僅供輸出。已安裝應用程式的首頁 URI。
permissions[]

string

僅供輸出。已安裝應用程式的權限。

AppInstallType

應用程式的安裝方式。如果已安裝的應用程式並非全都具有相同的安裝類型，則安裝類型為 MULTIPLE。

列舉
APP_INSTALL_TYPE_UNSPECIFIED 未指定應用程式安裝類型。
MULTIPLE 多種應用程式安裝類型。
NORMAL 一般應用程式安裝類型。
ADMIN 管理員應用程式安裝類型。
DEVELOPMENT 開發應用程式安裝類型。
SIDELOAD 側載的應用程式安裝類型。
OTHER 其他應用程式安裝類型。

AppSource

已安裝應用程式的來源。

列舉
APP_SOURCE_UNSPECIFIED 未指定應用程式來源。
CHROME_WEBSTORE 通常用於擴充功能和 Chrome 應用程式。
PLAY_STORE Play 商店應用程式。