Method: customers.reports.findSaasUsageBrowsers

根据给定的搜索和排序条件，查找按浏览器分组的客户 SaaS 用量报告。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
customer

string

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

查询参数

参数
app

string

必需。SaaS 应用的名称（例如 ChatGPT、Gemini）。
pageSize

integer

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

string

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

string

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

支持的字段：

  • 机器
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
  • orgUnitId
orderBy

string

可选。用于对 SaaS 浏览器报告进行排序的 order by 表达式。

支持的字段：

  • 机器
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

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

请求正文

请求正文必须为空。

响应正文

对 reports.findSaasUsageBrowsers 方法的响应。

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

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

object (SaasUsageBrowser)

SaaS 用量浏览器报告的列表。
nextPageToken

string

可作为 pageToken 发送并用于检索下一页的令牌。
totalSize

string (int64 format)

与请求匹配的 SaaS 使用情况浏览器报告的总数。

授权范围

需要以下 OAuth 范围：

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

SaasUsageBrowser

SaaS 用量浏览器的详细信息。

JSON 表示法 
{
  "machine": string,
  "devicePermanentId": string,
  "firstNavigationTime": string,
  "lastNavigationTime": string,
  "orgUnitId": string,
  "osPlatform": enum (DeviceSystem),
  "osVersion": string
}
字段
machine

string

仅限输出。计算机名称。
devicePermanentId

string

仅限输出。设备永久 ID。
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"。
orgUnitId

string

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

enum (DeviceSystem)

仅限输出。操作系统平台。
osVersion

string

仅限输出。操作系统版本。