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

En esta guía, se explica cómo usar el método get() en el recurso ThreadReadState de la API de Google Chat para obtener detalles sobre el estado de lectura de un usuario en un hilo de mensajes. Para obtener el estado de lectura de un mensaje en un espacio, consulta Cómo obtener detalles sobre el estado de lectura de un espacio de un usuario.

El recurso ThreadReadState es un recurso singleton que representa detalles sobre el último mensaje leído de un usuario especificado en un hilo de mensajes de Google Chat.

Requisitos previos

Node.js

Obtén el estado de lectura del subproceso del usuario que llama

Para obtener detalles sobre el estado de lectura de un usuario en un hilo de mensajes, incluye lo siguiente en tu solicitud:

  • Especifica el alcance de autorización chat.users.readstate o chat.users.readstate.readonly.
  • Llama al método GetThreadReadState() y pasa el name del estado de lectura del subproceso para obtener el que incluye un ID o alias de usuario y un ID de espacio. La obtención del estado de lectura del subproceso solo admite la obtención del estado de lectura del usuario que realiza la llamada, que se puede especificar configurando uno de los siguientes parámetros:
    • Es el alias de me. Por ejemplo, users/me/spaces/SPACE/threads/THREAD/threadReadState
    • Es la dirección de correo electrónico de Workspace del usuario que realiza la llamada. Por ejemplo, users/user@example.com/spaces/SPACE/threads/THREAD/threadReadState.
    • ID 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);
}

await main();

Para ejecutar esta muestra, reemplaza lo siguiente:

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

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