Method: customers.reports.findSaasUsageProfiles

根据给定的搜索和排序条件，查找按个人资料分组的客户 SaaS 用量报告。

HTTP 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
customer

string

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

查询参数

参数
app

string

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

integer

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

string

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

string

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

支持的字段：

  • 电子邮件
  • orgUnitId
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime
orderBy

string

可选。用于对 SaaS 配置文件报告进行排序的 order by 表达式。

支持的字段：

  • 电子邮件
  • osPlatform
  • firstNavigationTime
  • lastNavigationTime

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

请求正文

请求正文必须为空。

响应正文

对 reports.findSaasUsageProfiles 方法的响应。

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

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

object (SaasUsageProfileReport)

SaaS 用量概况报告的列表。
nextPageToken

string

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

string (int64 format)

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

授权范围

需要以下 OAuth 范围：

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

SaasUsageProfileReport

表示按个人资料分组的单个 SaaS 报告条目。

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

string

仅限输出。用户的电子邮件地址。
profilePermanentId

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

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