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

仅限输出。应用的唯一标识符。对于 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 表示高风险的扩展程序。