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，系統會強制設為 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)

訊息內容。