Ottenere dettagli sullo stato di lettura del thread di un utente

Questa guida spiega come utilizzare get() sulla risorsa ThreadReadState dell'API Google Chat per ottenere i dettagli sullo stato di lettura di un utente all'interno di un thread di messaggi. Per ottenere lo stato di lettura messaggio in uno spazio, vedi Ottenere 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

Node.js

Ottieni lo stato di lettura del thread dell'utente chiamante

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

  • Specifica il valore chat.users.readstate o chat.users.readstate.readonly nell'ambito dell'autorizzazione.
  • 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 dei thread supporta solo ottiene lo stato di lettura dell'utente chiamante, che può essere specificato impostando una delle seguenti opzioni:
    • 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.

L'esempio seguente restituisce 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 sample, 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 ottiene lo stato di lettura del thread specificato e restituisce un'istanza di ThreadReadState