Method: users.spaces.threads.updateThreadReadState

更新使用者在討論串中的讀取狀態,用於識別已讀和未讀訊息。如需範例,請參閱「更新使用者的討論串讀取狀態」。

需要使用者驗證,並具備授權範圍:

  • https://www.googleapis.com/auth/chat.users.readstate

HTTP 要求

PATCH https://chat.googleapis.com/v1/{threadReadState.name=users/*/spaces/*/threads/*/threadReadState}

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

路徑參數

參數
threadReadState.name

string

討論串讀取狀態的資源名稱。

格式:users/{user}/spaces/{space}/threads/{thread}/threadReadState

查詢參數

參數
updateMask

string (FieldMask format)

必填。要更新的欄位路徑。目前支援的欄位路徑:

  • lastReadTime

如果 lastReadTime 早於最新訊息的建立時間,討論串在使用者介面中會顯示為未讀取。

如要將討論串標示為已讀,請將 lastReadTime 設為等於或晚於最新訊息建立時間的時間戳記。未來時間戳記會強制轉型為目前的要求時間。如果設定負時間戳記 (1970-01-01T00:00:00Z 之前),系統會傳回 INVALID_ARGUMENT 錯誤。

要求主體

要求主體包含 ThreadReadState 的例項。

回應主體

如果成功,回應主體會包含 ThreadReadState 的執行個體。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/chat.users.readstate

詳情請參閱授權指南。