Method: spaces.messages.list

列出通話者所屬聊天室中的訊息，包括來自已封鎖成員和聊天室的訊息。系統訊息 (例如公告新聊天室成員的訊息) 不會納入。如果列出沒有訊息的聊天室訊息，回應會是空白物件。使用 REST/HTTP 介面時，回應會包含空白的 JSON 物件 {}。如需範例，請參閱「列出訊息」。

支援下列類型的驗證：

  • 透過管理員核准進行應用程式驗證，授權範圍如下：

    • https://www.googleapis.com/auth/chat.app.messages.readonly。使用這個驗證範圍時，這個方法只會傳回空間中的公開訊息。不包括私人訊息。

  • 使用者驗證，並使用下列其中一個授權範圍：

    • https://www.googleapis.com/auth/chat.messages.readonly
    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (僅限匯入模式聊天室)

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
parent

string

必填。要列出訊息的空間資源名稱。

格式：spaces/{space}

查詢參數

參數
pageSize

integer

(選用步驟) 傳回的訊息數量上限。服務傳回的訊息數量可能會少於這個值。

如未指定，最多會傳回 25 個。

最大值為 1000。如果使用超過 1000 的值，系統會自動變更為 1000。

負值會傳回 INVALID_ARGUMENT 錯誤。
pageToken

string

(選用步驟) 這是從先前的 list messages 呼叫收到的網頁符記。提供此參數即可擷取後續網頁。

進行分頁時，提供的所有其他參數應與提供網頁權杖的呼叫相符。將不同值傳遞至其他參數可能會導致非預期的結果。
filter

string

(選用步驟) 查詢篩選器。

你可以依日期 (createTime) 和訊息串 (thread.name) 篩選訊息。

RFC-3339 格式加上時間戳記和雙引號。例如 "2023-04-21T11:30:00-04:00"。您可以使用大於運算子 > 列出時間戳記之後建立的訊息，或使用小於運算子 < 列出時間戳記之前建立的訊息。如要篩選特定時間間隔內的訊息，請在兩個時間戳記之間使用 AND 運算子。

如要依執行緒篩選，請指定 thread.name，格式為 spaces/{space}/threads/{thread}。每項查詢只能指定一個 thread.name。

如要同時依討論串和日期篩選，請在查詢中使用 AND 運算子。

舉例來說，下列查詢皆有效：

createTime > "2012-04-21T11:30:00-04:00"

createTime > "2012-04-21T11:30:00-04:00" AND
  thread.name = spaces/AAAAAAAAAAA/threads/123

createTime > "2012-04-21T11:30:00+00:00" AND

createTime < "2013-01-01T00:00:00+00:00" AND
  thread.name = spaces/AAAAAAAAAAA/threads/123

thread.name = spaces/AAAAAAAAAAA/threads/123

伺服器會拒絕無效查詢，並傳回 INVALID_ARGUMENT 錯誤。
orderBy

string

(選用步驟) 訊息清單的排序方式。指定值，以便透過排序作業排序。有效的排序作業值如下：

  • ASC 表示遞增。

  • DESC 代表遞減。

預設排序方式為 createTime ASC。
showDeleted

boolean

(選用步驟) 是否要包含已刪除的郵件。已刪除的郵件包括刪除時間和刪除相關中繼資料，但無法查看郵件內容。

要求主體

要求主體必須為空白。

回應主體

列出訊息的回應訊息。

如果成功，回應主體會含有以下結構的資料：

JSON 表示法 
{
  "messages": [
    {
      object (Message)
    }
  ],
  "nextPageToken": string
}
欄位
messages[]

object (Message)

訊息清單。
nextPageToken

string

您可以將權杖做為 pageToken 傳送，擷取下一頁結果。如果留空，表示沒有後續網頁。

授權範圍

需要下列其中一種 OAuth 範圍：

  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.app.messages.readonly

詳情請參閱授權指南。