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 早于最新消息创建时间时,聊天室会在界面中显示为未读。

如需将聊天室标记为已读,请将 lastReadTime 设为晚于最新消息创建时间的任何值(更大)。lastReadTime 会被强制匹配最新消息创建时间。请注意,聊天室的读取状态只会影响聊天室顶级对话中显示的消息的读取状态。线程中的回复不受此时间戳的影响,而是依赖于线程读取状态。

请求正文

请求正文包含一个 SpaceReadState 实例。

响应正文

如果成功,则响应正文包含一个 SpaceReadState 实例。

授权范围

需要以下 OAuth 作用域:

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

有关详情,请参阅授权指南