- HTTP 请求
- 路径参数
- 查询参数
- 请求正文
- 响应正文
- 授权范围
- InstalledApp
- AppInstallType
- AppSource
- RiskAssessmentData
- RiskAssessmentEntry
- RiskAssessmentProvider
- RiskAssessment
- RiskLevel
- 试试看!
生成应用安装报告。
HTTP 请求
GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:countInstalledApps
网址采用 gRPC 转码语法。
路径参数
参数 | |
---|---|
customer |
必需。客户 ID 或“my_customer”,用于使用与发出请求的账号关联的客户。 |
查询参数
参数 | |
---|---|
orgUnitId |
组织部门的 ID。 |
pageSize |
返回的结果数上限。最大值和默认值均为 100。 |
pageToken |
用于指定要返回的请求页面的令牌。 |
filter |
用于过滤结果的查询字符串,采用 EBNF 语法,字段之间用“AND”分隔。 注意:此过滤条件不支持 OR 运算。 支持的过滤条件字段:
|
orderBy |
用于对结果进行排序的字段。 支持的排序字段:
|
请求正文
请求正文必须为空。
响应正文
包含查询的已安装应用的详细信息的响应。
如果成功,响应正文将包含结构如下的数据:
JSON 表示法 |
---|
{
"installedApps": [
{
object ( |
字段 | |
---|---|
installedApps[] |
与请求匹配的已安装应用的列表。 |
nextPageToken |
用于指定请求的下一页的令牌。 |
totalSize |
与请求匹配的已安装应用的总数。 |
授权范围
需要以下 OAuth 范围:
https://www.googleapis.com/auth/chrome.management.reports.readonly
InstalledApp
描述已安装的应用。
JSON 表示法 |
---|
{ "appId": string, "appType": enum ( |
字段 | |
---|---|
appId |
仅限输出。应用的唯一标识符。对于 Chrome 应用和扩展程序,为 32 个字符的 ID(例如 ehoadneljpdggcbbknedodolkkjodefl)。对于 Android 应用,请提供软件包名称(例如 com.evernote)。 |
appType |
仅限输出。应用类型。 |
browserDeviceCount |
仅限输出。已安装此应用的浏览器设备的数量。 |
osUserCount |
仅限输出。已安装此应用的 ChromeOS 用户数。 |
appInstallType |
仅限输出。应用的安装方式。 |
disabled |
仅限输出。应用是否已停用。 |
appSource |
仅限输出。已安装应用的来源。 |
displayName |
仅限输出。已安装应用的名称。 |
description |
仅限输出。已安装应用的说明。 |
homepageUri |
仅限输出。已安装应用的首页 URI。 |
permissions[] |
仅限输出。已安装应用的权限。 |
riskAssessment |
仅限输出。与此扩展程序相关的风险评估数据(如果有)。 |
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 ( |
字段 | |
---|---|
entries[] |
个别风险评估。 |
overallRiskLevel |
所有条目的整体评估风险级别。这是所有条目的最高风险级别。 |
RiskAssessmentEntry
一条风险评估条目。
JSON 表示法 |
---|
{ "provider": enum ( |
字段 | |
---|---|
provider |
此条目的来源风险评估提供商。 |
riskAssessment |
提供商的风险评估详情。 |
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 |
扩展程序的风险评估。目前,这是一个数值,其解读因风险评估提供商而异。 |
detailsUrl |
用户可以访问的网址,以详细了解风险评估。 |
version |
此评估适用的扩展程序版本。 |
RiskLevel
扩展程序/应用的分桶风险级别。
枚举 | |
---|---|
RISK_LEVEL_UNSPECIFIED |
未指定风险等级。 |
RISK_LEVEL_LOW |
风险较低的扩展程序。 |
RISK_LEVEL_MEDIUM |
表示中等风险的扩展程序。 |
RISK_LEVEL_HIGH |
存在高风险的扩展程序。 |