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, vedi Ottenere dettagli sullo stato di lettura di uno spazio di un utente.

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

Prerequisiti

Node.js

Recupera lo stato di lettura del thread dell'utente chiamante

Per ottenere informazioni dettagliate 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 per ottenere quello che include un ID utente o alias e un ID spazio. L'ottenimento dello stato di lettura del thread 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/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 chiamante. Ad esempio, users/USER/spaces/SPACE/threads/THREAD/threadReadState.

Il seguente esempio recupera lo stato di lettura del thread dell'utente chiamante:

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

main().catch(console.error);

Per eseguire questo esempio, sostituisci quanto segue:

  • SPACE_NAME: l'ID di name dello spazio. Puoi ottenere l'ID chiamando il metodo ListSpaces() o dall'URL dello spazio.
  • THREAD_NAME: l'ID di name del thread. Puoi ottenere l'ID dal corpo della risposta restituito dopo la creazione di 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.