Method: projects.locations.conversations.messages.list

列出给定对话的所有消息。

HTTP 请求

GET https://geminidataanalytics.googleapis.com/v1beta/{parent=projects/*/locations/*/conversations/*}/messages

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。要列出其消息的对话。格式：projects/{project}/locations/{location}/conversations/{conversationId}

查询参数

参数
pageSize

integer

可选。请求的页面大小。 服务器返回的项可能要比请求的少。最大页面大小为 100。所有更大的页面大小都将强制转换为 100。如果未指定，服务器将选择 50 作为合适的默认值。
pageToken

string

可选。标识服务器应返回的结果页面的令牌。
filter

string

可选。过滤结果。 如需了解语法，请参阅 AIP-160。

messages.list 允许按以下条件进行过滤：* createTime（例如，createTime > "2025-01-28T06:51:56-08:00"）* updateTime

请求正文

请求正文必须为空。

响应正文

列出对话消息的响应。

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

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

object (StorageMessage)

对话消息的列表。
nextPageToken

string

标识服务器应返回的结果页面的令牌。

授权范围

需要以下 OAuth 范围：

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

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

StorageMessage

包含用户消息或系统消息的已存储消息。

JSON 表示法 
{
  "messageId": string,
  "message": {
    object (Message)
  }
}
字段
messageId

string

对话消息的唯一资源名称。
message

object (Message)

消息内容。