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

用于过滤结果的查询字符串，以 AND 分隔的字段（采用 EBNF 语法）。

注意：此过滤条件不支持 OR 运算。

支持的过滤条件字段：

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

string

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

支持的字段顺序：

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

请求正文

请求正文必须为空。

响应正文

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

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

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 应用和扩展程序，则为 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

仅供输出。已安装应用的权限。

AppInstallType

应用的安装方式。如果这个安装式应用的所有实例并非都具有相同的安装类型，则安装类型为“MULTIPLE”。

枚举
APP_INSTALL_TYPE_UNSPECIFIED 未指定应用安装类型。
MULTIPLE 多种应用安装类型。
NORMAL 常规应用安装类型。
ADMIN 管理员应用安装类型。
DEVELOPMENT 开发类应用安装类型。
SIDELOAD 旁加载的应用安装类型。
OTHER 其他应用安装类型。

AppSource

已安装应用的来源。

枚举
APP_SOURCE_UNSPECIFIED 未指定应用来源。
CHROME_WEBSTORE 通常适用于扩展程序和 Chrome 应用。
PLAY_STORE Play 商店应用。