Method: customers.profiles.list

根据给定的搜索和排序条件列出客户的 Chrome 浏览器个人资料。

HTTP 请求

GET https://chromemanagement.googleapis.com/v1/{parent=customers/*}/profiles

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。格式：customers/{customer_id}

查询参数

参数
pageSize

integer

可选。要返回的个人资料数量上限。如果未指定 pageSize，则默认页面大小为 100，允许的最大页面大小为 200。
pageToken

string

可选。用于检索商家信息请求的特定页面的页面令牌。
filter

string

可选。用于过滤配置文件的过滤条件。过滤条件中可以使用以下字段：

  • profileId
  • displayName
  • userEmail
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • firstEnrollmentTime
  • osPlatformType
  • osVersion
  • browserVersion
  • browserChannel
  • policyCount
  • extensionCount
  • identityProvider
  • affiliationState
  • osPlatformVersion
  • ouId

上述任一字段都可以用来指定过滤条件，并且支持使用 AND 运算符按多个字段进行过滤。字符串类型字段和枚举类型字段支持“=”和“!=”运算符。整数类型和时间戳类型字段支持“=”、“!=”“<”“>”“<=”和“>=”运算符。时间戳应采用 RFC-3339 格式的字符串（例如 2012-04-21T11:30:00-04:00）。通配符“*”可与字符串类型字段过滤条件搭配使用。此外，还支持字符串字面量过滤，例如，将“ABC”用作过滤条件会映射到一个过滤条件，用于检查任何可过滤的字符串类型字段是否包含“ABC”。

您可以通过指定“ouId = ${your_org_unit_id}”将组织部门编号用作过滤条件，请注意，系统仅支持匹配单个 OU ID。
orderBy

string

可选。用于指定结果排序的字段。支持的字段包括：

  • profileId
  • displayName
  • userEmail
  • lastActivityTime
  • lastPolicySyncTime
  • lastStatusReportTime
  • firstEnrollmentTime
  • osPlatformType
  • osVersion
  • browserVersion
  • browserChannel
  • policyCount
  • extensionCount
  • identityProvider
  • affiliationState
  • osPlatformVersion

默认情况下，排序为升序；如需将字段指定为降序，应在字段名称中添加后缀“desc”。默认排序是按 lastStatusReportTime 降序排序。

请求正文

请求正文必须为空。

响应正文

对 profiles.list 方法的响应。

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

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

object (ChromeBrowserProfile)

返回的配置文件列表。
nextPageToken

string

可用于列出下一页的分页令牌。
totalSize

string (int64 format)

总大小表示返回的资源的估算数量。超过 1 万个配置文件时，不保证准确无误。

授权范围

需要以下 OAuth 范围之一：

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