Ottenere dettagli sullo stato di lettura del thread di un utente

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

La risorsa ThreadReadState è una risorsa singleton che rappresenta i dettagli dell'ultimo messaggio letto da un utente specificato in un thread di messaggi di Google Chat.

Prerequisiti

Recupera lo stato di lettura del thread dell'utente che chiama

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

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

L'esempio seguente recupera lo stato di lettura del thread dell'utente che chiama:

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

Per eseguire questo esempio, sostituisci quanto segue:

• SPACE_NAME: l'ID del name dello spazio. Puoi ottenere l'ID chiamando il metodo ListSpaces() o dall'URL dello spazio.
• THREAD_NAME: l'ID del name del thread. Puoi ottenere l'ID dal corpo della risposta restituito dopo aver creato un messaggio in modo asincrono con l'API Chat o con il nome personalizzato assegnato al messaggio al momento della creazione.

L'API Google Chat recupera lo stato di lettura del thread specificato e restituisce un'istanza di ThreadReadState.

Argomenti correlati

• Aggiorna lo stato di lettura dello spazio dell'utente che chiama.
• Ottieni lo stato di lettura dello spazio dell'utente che chiama.