Method: users.spaces.updateSpaceReadState

更新聊天室中用户的已读状态，用于识别已读和未读消息。如需查看示例，请参阅更新用户的聊天室读取状态。

需要用户身份验证，并具有授权范围：

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

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

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