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 語法中的 AND 分隔欄位。

注意：這個篩選器不支援 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。

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 代表高風險的擴充功能。