Obtén detalles sobre el estado de lectura de la conversación de un usuario

En esta guía, se explica cómo usar la get() en el recurso ThreadReadState de la API de Google Chat para obtener detalles sobre el estado de lectura de un usuario en una conversación. Para obtener el estado de lectura de un mensaje en un espacio, consulta Obtén detalles sobre el estado de lectura del espacio de un usuario.

El Recurso ThreadReadState es un recurso singleton que representa detalles sobre un el último mensaje leído del usuario especificado en una conversación de Google Chat.

Requisitos previos

Node.js

Obtén el estado de lectura del subproceso del usuario que realiza la llamada

Para obtener detalles sobre el estado de lectura de un usuario dentro de una conversación, incluye el siguiente en tu solicitud:

  • Especifica el permiso de autorización chat.users.readstate o chat.users.readstate.readonly.
  • Llama al GetThreadReadState() pasando el name del estado de lectura de subprocesos para obtener, que incluye un ID de usuario o alias y un ID de espacio. Obtener el estado de lectura de subprocesos solo admite obtener el estado de lectura del usuario que realiza la llamada, que puede especificarse mediante estableciendo una de las siguientes opciones:
    • El alias me. Por ejemplo, users/me/spaces/SPACE/threads/THREAD/threadReadState
    • La dirección de correo electrónico de Workspace del usuario que llama. Por ejemplo, users/user@example.com/spaces/SPACE/threads/THREAD/threadReadState.
    • El ID de usuario del usuario que llama. Por ejemplo, users/USER/spaces/SPACE/threads/THREAD/threadReadState.

En el siguiente ejemplo, se obtiene el estado de lectura del subproceso del usuario que realiza la llamada:

Node.js

chat/client-libraries/cloud/get-thread-read-state-user-cred.js
import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.users.readstate.readonly'];

// This sample shows how to get the thread read state for a space and calling user
async function main() {
  // Create a client
  const chatClient = await createClientWithUserCredentials(USER_AUTH_OAUTH_SCOPES);

  // Initialize request argument(s)
  const request = {
    // Replace SPACE_NAME and THREAD_NAME here
    name: 'users/me/spaces/SPACE_NAME/threads/THREAD_NAME/threadReadState'
  };

  // Make the request
  const response = await chatClient.getThreadReadState(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

Para ejecutar esta muestra, reemplaza lo siguiente:

  • SPACE_NAME: Es el ID del name del espacio. Para obtener el ID, llama al método ListSpaces() o desde la URL del espacio.
  • THREAD_NAME: El ID del subproceso name Puedes obtener el ID del cuerpo de la respuesta que se muestra después de crear un de forma asíncrona con la API de Chat nombre personalizado se asigna al mensaje en el momento de su creación.

La API de Google Chat obtiene el estado de lectura del subproceso especificado y muestra una instancia de ThreadReadState.