Pobieranie szczegółowych informacji o stanie odczytu pokoju użytkownika

Ten przewodnik wyjaśnia, jak używać metody get() w zasobie SpaceReadState interfejsu Google Chat API, aby uzyskać szczegółowe informacje o stanie odczytu użytkownika w przestrzeni. Aby uzyskać stan odczytu wiadomości w wątku, zapoznaj się z artykułem Uzyskiwanie szczegółowych informacji o stanie odczytu wątku przez użytkownika.

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

Wymagania wstępne

Node.js

Pobieranie stanu odczytu pokoju użytkownika wywołującego

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

  • Określ zakres autoryzacji chat.users.readstate lub chat.users.readstate.readonly.
  • Wywołaj metodę GetSpaceReadState() przekazując name stanu odczytu pokoju, aby uzyskać informacje, które obejmują identyfikator użytkownika lub alias oraz identyfikator pokoju. Pobieranie stanu odczytu przestrzeni 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/spaceReadState.
    • Adres e-mail użytkownika w Workspace, który inicjuje połączenie. Na przykład:users/user@example.com/spaces/SPACE/spaceReadState.
    • Identyfikator użytkownika wywołującego. Na przykład:users/USER/spaces/SPACE/spaceReadState.

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

Node.js

chat/client-libraries/cloud/get-space-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 space read state for the 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 here
    name: 'users/me/spaces/SPACE_NAME/spaceReadState',
  };

  // Make the request
  const response = await chatClient.getSpaceReadState(request);

  // Handle the response
  console.log(response);
}

main().catch(console.error);

Aby uruchomić ten przykład, zastąp SPACE_NAME identyfikatorem z przestrzeni name. Możesz go uzyskać, wywołując metodę ListSpaces() lub z adresu URL pokoju.

Interfejs Google Chat API pobiera określony stan odczytu pokoju i zwraca instancję SpaceReadState.