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
orderBy

string

用于对结果进行排序的字段。

支持按字段排序:

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

请求正文

请求正文必须为空。

响应正文

包含所查询的已安装应用的详细信息的响应。

如果成功,响应正文将包含结构如下的数据:

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

仅限输出。应用的唯一标识符。对于 Chrome 应用和扩展程序,此 ID 由 32 个字符组成(例如 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 商店应用。