Method: customers.reports.findSaasUsage

根据给定的搜索和排序条件查找客户的 SaaS 使用情况报告。

HTTP 请求

GET https://chromemanagement.googleapis.com/v1/{customer=customers/*}/reports:findSaasUsage

网址采用 gRPC 转码语法。

路径参数

参数
customer

string

必需。以“customers/C”或“customers/my_customer”为前缀的混淆客户 ID。

查询参数

参数
pageSize

integer

可选。要返回的报告数量上限。服务返回的值可能小于此值。如果未指定，则最多返回 100 份报告。最大值为 200；大于 200 的值将被强制转换为 200。
pageToken

string

可选。从之前的 FindSaasUsageReports 调用接收的页面令牌。利用其进行后续页面检索。

进行分页时，提供给 FindSaasUsageReports 的所有其他参数必须与提供页面令牌的调用匹配。
filter

string

可选。用于缩小要返回的 SaaS 报告范围的过滤表达式。支持的运算符有：=、!=、<、<=、>、>=、:。支持逻辑运算符 AND、OR 和 NOT。

支持的字段：

  • 应用
  • orgUnitId
  • firstNavigationTime
  • lastNavigationTime
  • 类别
  • 组织
  • foundedYear
  • 总部
  • primaryDomain
  • 网域
  • encryptionProtocols
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

示例：(firstNavigationTime < "2026-01-31T00:00:00Z" AND lastNavigationTime > "2026-01-01T00:00:00Z") AND visitsCount > 100
orderBy

string

可选。用于对 SaaS 报告进行排序的排序依据表达式。

支持的字段：

  • 应用
  • 类别
  • 组织
  • foundedYear
  • 总部
  • primaryDomain
  • visitsCount
  • distinctUsersCount
  • distinctBrowsersCount
  • contentTransferCount

默认顺序为升序。如需将字段指定为降序排序，请附加“desc”。

示例：visitsCount desc

请求正文

请求正文必须为空。

响应正文

对 reports.findSaasUsage 方法的响应。

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

JSON 表示法 
{
  "saasReports": [
    {
      object (SaasUsageReport)
    }
  ],
  "nextPageToken": string,
  "totalSize": string
}
字段
saasReports[]

object (SaasUsageReport)

SaaS 使用情况报告的列表。
nextPageToken

string

可作为 pageToken 发送并用于检索下一页的令牌。如果省略此字段，则不存在后续页面。
totalSize

string (int64 format)

与请求匹配的 SaaS 用量报告总数。

授权范围

需要以下 OAuth 范围：

  • https://www.googleapis.com/auth/chrome.management.reports.readonly

SaasUsageReport

表示单个 SaaS 报告条目。

JSON 表示法 
{
  "app": string,
  "orgUnitId": string,
  "category": string,
  "organization": string,
  "foundedYear": integer,
  "headquarters": string,
  "primaryDomain": string,
  "domains": [
    string
  ],
  "encryptionProtocols": [
    string
  ],
  "visitsCount": string,
  "distinctUsersCount": string,
  "distinctBrowsersCount": string,
  "contentTransferDetails": {
    object (ContentTransferDetails)
  },
  "firstNavigationTime": string,
  "lastNavigationTime": string
}
字段
app

string

仅限输出。应用名称。
orgUnitId

string

仅限输出。组织部门的 ID。
category

string

仅限输出。应用的类别。
organization

string

仅限输出。开发相应应用的组织。
foundedYear

integer

仅限输出。组织成立的年份。
headquarters

string

仅限输出。组织的总部所在地。
primaryDomain

string

仅限输出。应用的主网域。
domains[]

string

仅限输出。与应用关联的网域和子网域的列表。
encryptionProtocols[]

string

仅限输出。用于访问应用的加密协议的列表。
visitsCount

string (int64 format)

仅限输出。应用的总访问次数。
distinctUsersCount

string (int64 format)

仅限输出。访问过相应应用的去重用户数。
distinctBrowsersCount

string (int64 format)

仅限输出。访问过相应应用的去重浏览器数量。
contentTransferDetails

object (ContentTransferDetails)

仅限输出。提供有关内容转移事件的信息（如有）。
firstNavigationTime

string (Timestamp format)

仅限输出。首次导航到应用时的时间戳。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
lastNavigationTime

string (Timestamp format)

仅限输出。上次导航到应用时的时间戳。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不进行“Z”归一化处理的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。

ContentTransferDetails

提供有关内容转移事件的信息（如有）。

JSON 表示法 
{
  "contentTransferCount": string
}
字段
contentTransferCount

string (int64 format)

仅限输出。与应用关联的内容转移总数。