Obtén detalles sobre el estado de lectura del espacio de un usuario

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

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

Requisitos previos

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

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

• Especifica el alcance de autorización chat.users.readstate o chat.users.readstate.readonly.
• Llama al método GetSpaceReadState() y pasa el name del estado de lectura del espacio para obtener el que incluye un ID o alias de usuario y un ID de espacio. La obtención del estado de lectura del espacio solo admite la obtención del estado de lectura del usuario que llama, que se puede especificar configurando uno de los siguientes parámetros:
  • Es el alias de me. Por ejemplo, users/me/spaces/SPACE/spaceReadState
  • Es la dirección de correo electrónico de Workspace del usuario que realiza la llamada. Por ejemplo, users/user@example.com/spaces/SPACE/spaceReadState.
  • ID del usuario que llama. Por ejemplo, users/USER/spaces/SPACE/spaceReadState.

En el siguiente ejemplo, se obtiene el estado de lectura del espacio del usuario que llama:

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 space read state for the 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 here
    name: 'users/me/spaces/SPACE_NAME/spaceReadState',
  };

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

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

main().catch(console.error);

Para ejecutar este ejemplo, reemplaza SPACE_NAME por el ID del name del espacio. Puedes obtener el ID llamando al método ListSpaces() o desde la URL del espacio.

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

Temas relacionados

• Actualiza el estado de lectura del espacio del usuario que llama.
• Obtén el estado de lectura del subproceso del usuario que llama.