本指南說明如何在 Google Chat API 的 ThreadReadState
資源上使用 get()
方法,取得訊息串內使用者的讀取狀態詳細資料。如要取得聊天室中訊息的已讀狀態,請參閱「取得使用者聊天室已讀狀態的詳細資料」。
ThreadReadState
項資源
是單例模式資源,代表
指定使用者的 Google Chat 訊息串中最後已讀訊息。
必要條件
Node.js
- 企業或企業 具有存取權的 Google Workspace 帳戶 Google Chat。
- 設定環境:
- 建立 Google Cloud 專案。
- 設定 OAuth 同意畫面。
- 啟用並設定 Google Chat API。 圖示和說明
- 安裝 Node.js Cloud 用戶端程式庫。
-
為電腦版應用程式建立 OAuth 用戶端 ID 憑證。如要執行本指南中的範例,請將憑證儲存為名為
client_secrets.json
的 JSON 檔案,並儲存至本機目錄。
- 選擇支援使用者驗證的授權範圍。
取得呼叫端使用者的執行緒讀取狀態
如要進一步瞭解使用者在訊息串中的讀取狀態,請在要求中加入以下內容:
- 指定
chat.users.readstate
或chat.users.readstate.readonly
授權範圍 - 在
GetThreadReadState()
方法,傳遞執行緒讀取狀態的name
,取得 使用者 ID 或別名,以及聊天室 ID。取得執行緒讀取狀態僅支援取得呼叫使用者的讀取狀態,您可以設定下列其中一個項目來指定此狀態:me
別名。例如users/me/spaces/SPACE/threads/THREAD/threadReadState
。- 通話對象的 Workspace 電子郵件地址。例如
users/user@example.com/spaces/SPACE/threads/THREAD/threadReadState
。 - 呼叫使用者的使用者 ID。例如
users/USER/spaces/SPACE/threads/THREAD/threadReadState
。
以下範例會取得呼叫使用者的執行緒讀取狀態:
Node.js
如要執行這個範例,請取代下列項目:
SPACE_NAME
:聊天室name
的 ID。您可以呼叫ListSpaces()
方法,或從空間的網址取得 ID。THREAD_NAME
:執行緒的name
中的 ID。您可以使用 Chat API 以非同步方式建立訊息,或在建立訊息時指派自訂名稱,然後從回應主體中取得 ID。
Google Chat API 會取得指定的執行緒讀取狀態,並傳回 ThreadReadState
的例項。