Pobieranie informacji o stanie odczytu wątku użytkownika

Ten przewodnik wyjaśnia, jak używać metody get()ThreadReadState zasobu w Google Chat API, aby uzyskać szczegółowe informacje o stanie odczytu użytkownika w wątku wiadomości. Aby uzyskać stan odczytu wiadomości w pokoju, przeczytaj artykuł Uzyskiwanie szczegółowych informacji o stanie odczytu pokoju przez użytkownika.

ThreadReadStateZasób jest zasobem pojedynczym, który zawiera szczegóły dotyczące ostatniej przeczytanej wiadomości określonego użytkownika w wątku wiadomości w Google Chat.

Wymagania wstępne

Node.js

Pobieranie stanu odczytu wątku użytkownika wywołującego

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

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

Poniższy przykład pokazuje, jak uzyskać stan odczytu wątku użytkownika wywołującego:

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 te elementy:

  • SPACE_NAME: identyfikator z przestrzeni name. Możesz go uzyskać, wywołując metodę ListSpaces() lub 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ą niestandardowej nazwy przypisanej do wiadomości podczas jej tworzenia.

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