Method: spaces.threads.list

列出 1:1 應用程式即時訊息聊天室中的討論串。

支援下列驗證類型:

僅支援一對一應用程式即時訊息聊天室。如果呼叫其他聊天室類型或使用使用者驗證,則會傳回錯誤。

HTTP 要求

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

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

路徑參數

參數
parent

string

必填。要列出討論串的聊天室資源名稱,格式:spaces/{space}

查詢參數

參數
pageSize

integer

(選用步驟) 要傳回的討論串數量上限。服務傳回的產品數量可能會少於這個值。如未指定,最多會傳回 50 個討論串。許可的最大值為 1000;超出的數值將一律指定為 1000。

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

詳情請參閱授權指南。