Method: spaces.threads.list

列出一对一应用私信聊天室中的消息串。

支持以下类型的身份验证:

  • 具有以下授权范围的应用身份验证:
    • https://www.googleapis.com/auth/chat.bot

仅在 1:1 应用私信聊天室中受支持。在其他类型的聊天室中或使用用户身份验证进行调用会返回错误。

HTTP 请求

GET https://chat.googleapis.com/v1/{parent=spaces/*}/threads

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。要列出其中话题的空间的资源名称。格式:spaces/{space}

查询参数

参数
pageSize

integer

可选。要返回的会话数量上限。服务返回的值可能小于此值。如果未指定,则最多返回 50 个会话。最大值为 1,000;大于 1,000 的值将被强制转换为 1,000。

pageToken

string

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

请求正文

请求正文必须为空。

响应正文

针对 threads.list 的响应消息。

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

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

object (Thread)

会话串列表。根据会话创建时间戳按时间倒序排列。

nextPageToken

string

可以作为 pageToken 发送的令牌可用于检索下一页结果。如果为空,则表示没有后续页面。

授权范围

需要以下 OAuth 范围:

  • https://www.googleapis.com/auth/chat.bot

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