사용자의 스페이스 읽기 상태에 관한 세부정보 보기

이 가이드에서는 Google Chat API의 SpaceReadState 리소스에서 get() 메서드를 사용하여 스페이스 내 사용자의 읽기 상태에 관한 세부정보를 가져오는 방법을 설명합니다. 메시지 스레드의 메시지 읽기 상태를 가져오려면 사용자의 스레드 읽기 상태에 관한 세부정보 가져오기를 참고하세요.

SpaceReadState 리소스는 Google Chat 스페이스에서 지정된 사용자의 마지막으로 읽은 메시지에 관한 세부정보를 나타내는 싱글톤 리소스입니다.

기본 요건

Node.js

호출 사용자의 스페이스 읽기 상태 가져오기

스페이스 내 사용자의 읽기 상태에 관한 세부정보를 가져오려면 요청에 다음을 포함하세요.

  • chat.users.readstate 또는 chat.users.readstate.readonly 승인 범위를 지정합니다.
  • 스페이스 읽기 상태의 name를 전달하여 GetSpaceReadState() 메서드를 호출합니다. 여기에는 사용자 ID 또는 별칭과 스페이스 ID가 포함됩니다. 스페이스 읽기 상태 가져오기는 호출 사용자의 읽기 상태 가져오기만 지원하며, 이는 다음 중 하나를 설정하여 지정할 수 있습니다.
    • me 별칭입니다. 예를 들면 users/me/spaces/SPACE/spaceReadState입니다.
    • 호출하는 사용자의 Workspace 이메일 주소입니다. 예를 들면 다음과 같습니다. users/user@example.com/spaces/SPACE/spaceReadState
    • 호출 사용자의 사용자 ID입니다. 예를 들면 다음과 같습니다. users/USER/spaces/SPACE/spaceReadState

다음 예에서는 호출 사용자의 스페이스 읽기 상태를 가져옵니다.

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

await main();

이 샘플을 실행하려면 SPACE_NAME를 스페이스의 name에서 가져온 ID로 바꿉니다. ListSpaces() 메서드를 호출하거나 스페이스의 URL에서 ID를 가져올 수 있습니다.

Google Chat API는 지정된 스페이스 읽기 상태를 가져와 SpaceReadState 인스턴스를 반환합니다.