Method: users.spaces.updateSpaceReadState

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

需要使用者驗證

HTTP 要求

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

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

路徑參數

參數
spaceReadState.name

string

聊天室讀取狀態的資源名稱。

格式:users/{user}/spaces/{space}/spaceReadState

查詢參數

參數
updateMask

string (FieldMask format)

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

  • lastReadTime

如果 lastReadTime 早於最新訊息建立時間,UI 就會顯示為未讀取。

如要將聊天室標示為已讀,請將 lastReadTime 設為晚於最新訊息建立時間的值。系統會將 lastReadTime 強制轉換成最新的訊息建立時間。請注意,聊天室讀取狀態只會影響聊天室頂層對話中顯示的訊息讀取狀態。討論串中的回覆不會受到這個時間戳記的影響,而是取決於討論串的讀取狀態。

要求主體

要求主體包含 SpaceReadState 的例項。

回應主體

如果成功,回應主體會包含 SpaceReadState 的執行例項。

授權範圍

需要下列 OAuth 範圍:

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

詳情請參閱授權指南