Method: projects.locations.collections.engines.sessions.list

按父级 DataStore 列出所有会话。

HTTP 请求

GET https://discoveryengine.googleapis.com/v1beta/{parent=projects/*/locations/*/collections/*/engines/*}/sessions

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。数据存储区资源名称。格式：projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStoreId}

查询参数

参数
pageSize

integer

页面中结果的数量上限。如果未指定，则默认为 50。允许的最大值为 1000。
pageToken

string

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

string

要过滤的字段的逗号分隔列表，采用 EBNF 语法。

支持的字段包括：

  • user_pseudo_id
  • state
  • display_name
  • starred
  • is_pinned
  • labels
  • create_time
  • update_time

示例：

  • user_pseudo_id = some_id
  • display_name = "some_name"
  • starred = true
  • is_pinned=true AND (NOT labels:hidden)
  • create_time > "1970-01-01T12:00:00Z"
orderBy

string

以英文逗号分隔的排序依据字段列表，按升序排序。在字段名称后使用“desc”表示降序。

支持的字段：

  • update_time
  • create_time
  • session_name
  • is_pinned

示例：

  • update_time desc
  • create_time
  • is_pinned desc,update_time desc：先按 is_pinned 列出会议，然后按 update_time 列出会议。

请求正文

请求正文必须为空。

响应正文

如果成功，则响应正文包含一个 ListSessionsResponse 实例。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite

如需了解详情，请参阅 Authentication Overview。

IAM 权限

需要拥有 parent 资源的以下 IAM 权限：

  • discoveryengine.sessions.list

如需了解详情，请参阅 IAM 文档。