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。

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 风险高的扩展程序。