Method: users.spaces.updateSpaceReadState

Updates a user's read state within a space, used to identify read and unread messages.

Requires user authentication.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
spaceReadState.name

string

Resource name of the space read state.

Format: users/{user}/spaces/{space}/spaceReadState

Query parameters

Parameters
updateMask

string (FieldMask format)

Required. The field paths to update. Currently supported field paths:

  • lastReadTime

When the lastReadTime is before the latest message create time, the space appears as unread in the UI.

To mark the space as read, set lastReadTime to any value later (larger) than the latest message create time. The lastReadTime is coerced to match the latest message create time. Note that the space read state only affects the read state of messages that are visible in the space's top-level conversation. Replies in threads are unaffected by this timestamp, and instead rely on the thread read state.

Request body

The request body contains an instance of SpaceReadState.

Response body

If successful, the response body contains an instance of SpaceReadState.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authorization guide.