Method: users.spaces.threads.getThreadReadState
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Solicitud HTTP
GET https://chat.googleapis.com/v1/{name=users/*/spaces/*/threads/*/threadReadState}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
| Parámetros |
name |
string
Obligatorio. Es el nombre del recurso del estado de lectura del subproceso que se recuperará. Solo admite obtener el estado de lectura del usuario que realiza la llamada. Para hacer referencia al usuario que llama, establece una de las siguientes opciones:
El alias me. Por ejemplo, users/me/spaces/{space}/threads/{thread}/threadReadState Su dirección de correo electrónico de Workspace Por ejemplo, users/user@example.com/spaces/{space}/threads/{thread}/threadReadState. Su ID de usuario. Por ejemplo, users/123456789/spaces/{space}/threads/{thread}/threadReadState. Formato: users/{user}/spaces/{space}/threads/{thread}/threadReadState
|
Cuerpo de la solicitud
El cuerpo de la solicitud debe estar vacío.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de ThreadReadState.
Alcances de autorización
Se necesita uno de los siguientes permisos de OAuth:
https://www.googleapis.com/auth/chat.users.readstatehttps://www.googleapis.com/auth/chat.users.readstate.readonly
Para obtener más información, consulta la Guía de autorización.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 2025-07-25 (UTC)"],[[["\u003cp\u003eRetrieves a user's read state within a specific thread, indicating read and unread messages.\u003c/p\u003e\n"],["\u003cp\u003eRequires user authentication and uses a specific HTTP GET request format with path parameters.\u003c/p\u003e\n"],["\u003cp\u003eThe request body should be empty, while a successful response includes a \u003ccode\u003eThreadReadState\u003c/code\u003e object.\u003c/p\u003e\n"],["\u003cp\u003eAuthorisation is necessary, using specific OAuth scopes related to read state permissions.\u003c/p\u003e\n"]]],["This describes retrieving a user's read state within a specific thread. To do so, send a `GET` HTTP request to a URL constructed with user, space, and thread identifiers, using either the `me` alias, their email, or ID. The request body must be empty. Successful requests return a `ThreadReadState` object, and requests require authorization via OAuth scopes, such as `chat.users.readstate`. The user must be authenticated to access this resource.\n"],null,["# Method: users.spaces.threads.getThreadReadState\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReturns details about a user's read state within a thread, used to identify read and unread messages. For an example, see [Get details about a user's thread read state](https://developers.google.com/workspace/chat/get-thread-read-state).\n\nRequires [user authentication](https://developers.google.com/workspace/chat/authenticate-authorize-chat-user) with one of the following [authorization scopes](https://developers.google.com/workspace/chat/authenticate-authorize#chat-api-scopes):\n\n- `https://www.googleapis.com/auth/chat.users.readstate.readonly`\n- `https://www.googleapis.com/auth/chat.users.readstate`\n\n### HTTP request\n\n`GET https://chat.googleapis.com/v1/{name=users/*/spaces/*/threads/*/threadReadState}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Required. Resource name of the thread read state to retrieve. Only supports getting read state for the calling user. To refer to the calling user, set one of the following: - The `me` alias. For example, `users/me/spaces/{space}/threads/{thread}/threadReadState`. - Their Workspace email address. For example, `users/user@example.com/spaces/{space}/threads/{thread}/threadReadState`. - Their user id. For example, `users/123456789/spaces/{space}/threads/{thread}/threadReadState`. Format: users/{user}/spaces/{space}/threads/{thread}/threadReadState |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [ThreadReadState](/workspace/chat/api/reference/rest/v1/users.spaces.threads#ThreadReadState).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/chat.users.readstate`\n- `https://www.googleapis.com/auth/chat.users.readstate.readonly`\n\nFor more information, see the [Authorization guide](/workspace/chat/authenticate-authorize)."]]
