Method: users.sections.items.list

列出某个版块中的内容。

目前，只有空间可以作为部分项目。如需了解详情，请参阅在 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/*}/items

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。父级，即拥有相应部分商品集合的部分资源名称。仅支持列出调用用户的版块内容。

格式：users/{user}/sections/{section}

查询参数

参数
pageSize

integer

可选。要返回的版块项目数量上限。服务返回的值可能小于此值。

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

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

负值会返回 INVALID_ARGUMENT 错误。
pageToken

string

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

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

string

可选。查询过滤条件。

目前仅支持按空间进行过滤。

例如 space = spaces/{space}。

无效查询会被拒绝，并显示 INVALID_ARGUMENT 错误。

请求正文

请求正文必须为空。

响应正文

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

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

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

object (SectionItem)

指定版块中的版块项。
nextPageToken

string

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

授权范围

需要以下 OAuth 范围之一：

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

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