Method: users.sections.list

列出 Chat 用户可用的部分。版块可帮助用户对对话进行分组，并自定义 Chat 导航面板中显示的聊天室列表。如需了解详情，请参阅在 Google Chat 中创建和整理版块。

需要使用以下授权范围进行用户身份验证：

  • https://www.googleapis.com/auth/chat.users.sections
  • https://www.googleapis.com/auth/chat.users.sections.readonly

HTTP 请求

GET https://chat.googleapis.com/v1/{parent=users/*}/sections

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。父级，即拥有此版块集合的用户资源名称。仅支持列出调用用户的部分。如需引用调用用户，请设置以下任一值：

  • me 别名。例如 users/me。

  • 其 Workspace 电子邮件地址。例如 users/user@example.com。

  • 相应用户的 ID。例如 users/123456789。

格式：users/{user}

查询参数

参数
pageSize

integer

可选。要返回的部分数量上限。服务返回的值可能小于此值。

如果未指定，则最多返回 10 个部分。

最大值为 100。如果您使用的值超过 100，系统会自动将其更改为 100。

负值会返回 INVALID_ARGUMENT 错误。
pageToken

string

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

进行分页时，提供的所有其他参数应与提供页面令牌的调用相一致。向其他参数传递不同的值可能会导致意外结果。

请求正文

请求正文必须为空。

响应正文

用于列出版块的响应消息。

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

JSON 表示法 
{
  "sections": [
    {
      object (Section)
    }
  ],
  "nextPageToken": string
}
字段
sections[]

object (Section)

指定用户的部分内容。
nextPageToken

string

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

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/chat.users.sections
  • https://www.googleapis.com/auth/chat.users.sections.readonly

如需了解详情，请参阅授权指南。