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

如需了解详情,请参阅授权指南