Ottenere dettagli sullo stato di lettura dello spazio di un utente

Questa guida spiega come utilizzare il metodo get() nella risorsa SpaceReadState dell'API Google Chat per ottenere dettagli sullo stato di lettura di un utente all'interno di uno spazio. Per ottenere lo stato di lettura di un messaggio in un thread, vedi Ottenere i dettagli sullo stato di lettura di un thread di un utente.

La risorsa SpaceReadState è una risorsa singleton che rappresenta i dettagli dell'ultimo messaggio letto di un utente specificato in uno spazio Google Chat.

Prerequisiti

Recupera lo stato di lettura dello spazio dell'utente chiamante

Per ottenere dettagli sullo stato di lettura di un utente all'interno di uno spazio, includi quanto segue nella richiesta:

• Specifica l'ambito di autorizzazione chat.users.readstate o chat.users.readstate.readonly.
• Chiama il metodo GetSpaceReadState(), passando name dello stato di lettura dello spazio per ottenere un ID utente o alias e un ID spazio. L'ottenimento dello stato di lettura dello spazio supporta solo l'ottenimento dello stato di lettura dell'utente chiamante, che può essere specificato impostando uno dei seguenti valori:
  • L'alias me. Ad esempio, users/me/spaces/SPACE/spaceReadState.
  • L'indirizzo email Workspace dell'utente che chiama. Ad esempio, users/user@example.com/spaces/SPACE/spaceReadState.
  • L'ID utente dell'utente chiamante. Ad esempio, users/USER/spaces/SPACE/spaceReadState.

L'esempio seguente recupera lo stato di lettura dello spazio dell'utente chiamante:

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);

Per eseguire questo esempio, sostituisci SPACE_NAME con l'ID dello spazio name. Puoi ottenere l'ID chiamando il metodo ListSpaces() o dall'URL dello spazio.

L'API Google Chat recupera lo stato di lettura dello spazio specificato e restituisce un'istanza di SpaceReadState.

Argomenti correlati

• Aggiorna lo stato di lettura dello spazio dell'utente chiamante.
• Recupera lo stato di lettura del thread dell'utente chiamante.