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 una conversación. Para obtener el estado de lectura de un mensaje en un espacio, consulta Obtén 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 específico en una conversación de Google Chat.

Requisitos previos

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 en una conversación, incluye lo siguiente en tu solicitud:

• Especifica el permiso 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 lo que incluye un ID de usuario o alias y un ID de espacio. Obtener el estado de lectura del subproceso solo admite obtener el estado de lectura del usuario que realiza la llamada, que se puede especificar configurando una de las siguientes opciones:
  • El alias 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.
  • El ID de usuario del usuario que realiza la llamada. 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:

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: 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 su creación.

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

Temas relacionados

• Actualiza el estado de lectura del espacio del usuario que realiza la llamada.
• Obtén el estado de lectura del espacio del usuario que realiza la llamada.