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. Aby uzyskać stan odczytu wiadomości w pokoju, zapoznaj się z artykułem Pobieranie informacji o stanie odczytu pokoju przez użytkownika.

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 Google Chat.

Wymagania wstępne

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

Aby uzyskać szczegółowe informacje o stanie odczytania przez użytkownika wątku wiadomości, w żądaniu podaj:

• 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ć identyfikator użytkownika lub alias i 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 dzwoniącego w 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:

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.

Powiązane artykuły

• Zaktualizuj stan odczytu pokoju przez dzwoniącego użytkownika.
• Uzyskaj stan odczytu przestrzeni użytkownika dzwoniącego.