Pobieranie informacji o stanie odczytu wątku użytkownika

Ten przewodnik wyjaśnia, jak używać metody get() w zasobach ThreadReadState interfejsu Google Chat API, aby uzyskać informacje o stanie odczytania wiadomości w wątku. Informacje o stanie odczytu wiadomości w pokoju znajdziesz w sekcji Uzyskiwanie informacji o stanie odczytu wiadomości użytkownika w pokoju.

Zasób ThreadReadState to pojedynczy zasób, który reprezentuje szczegóły ostatniej przeczytanej wiadomości określonego użytkownika w wątku wiadomości w Google Chat.

Wymagania wstępne

Node.js

Pobieranie stanu wątku odczytanego przez dzwoniącego użytkownika

Aby uzyskać szczegółowe informacje o stanie odczytu użytkownika w wątku wiadomości, umieść w żądaniu te informacje:

  • Określ zakres autoryzacji chat.users.readstate lub chat.users.readstate.readonly.
  • Zawołaj metodę GetThreadReadState(), przekazując name stanu odczytu wątku, aby uzyskać identyfikator użytkownika lub aliasa oraz identyfikator pokoju. Pobieranie stanu przeczytania wątku obsługuje tylko pobieranie stanu przeczytania przez wywołującego użytkownika, który można określić, ustawiając jedną z tych opcji:
    • Alias me. Na przykład: users/me/spaces/SPACE/threads/THREAD/threadReadState.
    • Adres e-mail użytkownika nawiązującego połączenie z Workspace. Na przykład: users/user@example.com/spaces/SPACE/threads/THREAD/threadReadState.
    • Identyfikator użytkownika dzwoniącego. Na przykład: users/USER/spaces/SPACE/threads/THREAD/threadReadState.

W tym przykładzie pobierany jest stan odczytania wątku przez dzwoniącego użytkownika:

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

Aby uruchomić ten przykład, zastąp:

  • SPACE_NAME: identyfikator pokojuname. Identyfikator możesz uzyskać, wywołując metodę ListSpaces() lub korzystając z adresu URL pokoju.
  • THREAD_NAME: identyfikator z name wątku. Identyfikator możesz uzyskać z treści odpowiedzi zwróconej po asynchronicznym utworzeniu wiadomości za pomocą interfejsu Chat API lub za pomocą nazwy niestandardowej przypisanej do wiadomości podczas jej tworzenia.

Interfejs Google Chat API pobiera określony stan odczytu wątku i zwraca instancję ThreadReadState.