Method: customers.reports.countInstalledApps

產生應用程式安裝次數報表。

HTTP 要求

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

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

路徑參數

參數
customer

string

必填。客戶 ID 或「my_customer」，用於與提出要求的帳戶相關聯的客戶。

查詢參數

參數
orgUnitId

string

組織單位的 ID。
pageSize

integer

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

string

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

string

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

注意：這個篩選器不支援 OR 運算。

支援的篩選器欄位：

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

string

用於排序結果的欄位。

支援的排序依據欄位：

  • app_name
  • appType
  • install_type
  • number_of_permissions
  • total_install_count
  • appId
  • manifest_versions
  • risk_score

要求主體

要求主體必須為空白。

回應主體

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

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

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
  ],
  "riskAssessment": {
    object (RiskAssessmentData)
  }
}
欄位
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

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

object (RiskAssessmentData)

僅供輸出。這項擴充功能的風險評估資料 (如有)。

AppInstallType

應用程式的安裝方式。如果此安裝版應用程式並非全部都屬於同一種安裝類型，則安裝類型為 MULTIPLE。

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

AppSource

安裝版應用程式的來源。

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

RiskAssessmentData

擴充功能/應用程式的風險評估資料。

JSON 表示法 
{
  "entries": [
    {
      object (RiskAssessmentEntry)
    }
  ],
  "overallRiskLevel": enum (RiskLevel)
}
欄位
entries[]

object (RiskAssessmentEntry)

個別風險評估。
overallRiskLevel

enum (RiskLevel)

所有項目評估的整體風險等級。這是所有項目中最高的風險等級。

RiskAssessmentEntry

一筆風險評估資料。

JSON 表示法 
{
  "provider": enum (RiskAssessmentProvider),
  "riskAssessment": {
    object (RiskAssessment)
  },
  "riskLevel": enum (RiskLevel)
}
欄位
provider

enum (RiskAssessmentProvider)

僅供輸出。這個項目的風險評估提供者。
riskAssessment

object (RiskAssessment)

僅供輸出。供應商風險評估的詳細資料。
riskLevel

enum (RiskLevel)

僅供輸出。風險評估的風險等級。

RiskAssessmentProvider

風險評估供應商。

列舉
RISK_ASSESSMENT_PROVIDER_UNSPECIFIED 未指定供應商時的預設值。
RISK_ASSESSMENT_PROVIDER_CRXCAVATOR CRXcavator。
RISK_ASSESSMENT_PROVIDER_SPIN_AI Spin.Ai。
RISK_ASSESSMENT_PROVIDER_LAYERX LayerX Security。
RISK_ASSESSMENT_PROVIDER_SPIN_AI_V2 Spin.AI V2。

RiskAssessment

Chrome 擴充功能的風險評估。

JSON 表示法 
{
  "assessment": string,
  "detailsUrl": string,
  "version": string
}
欄位
assessment

string

擴充功能的風險評估。目前這是數值，解讀方式因風險評估供應商而異。
detailsUrl

string

使用者可前往此網址，進一步瞭解風險評估。
version

string

這項評估適用的擴充功能版本。

RiskLevel

擴充功能/應用程式的風險等級。

列舉
RISK_LEVEL_UNSPECIFIED 未指定風險等級。
RISK_LEVEL_LOW 代表低風險的擴充功能。
RISK_LEVEL_MEDIUM 代表中等風險的擴充功能。
RISK_LEVEL_HIGH 代表高風險的擴充功能。