사용자의 스레드 읽기 상태에 대한 세부정보 가져오기

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

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

기본 요건

Node.js

호출 사용자의 스레드 읽기 상태 가져오기

메시지 대화목록 내에서 사용자의 읽기 상태에 관한 세부정보를 가져오려면 요청에 다음을 포함합니다.

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

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

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

이 샘플을 실행하려면 다음을 바꿉니다.

  • SPACE_NAME: 스페이스의 name의 ID입니다. ListSpaces() 메서드를 호출하거나 스페이스의 URL에서 ID를 가져올 수 있습니다.
  • THREAD_NAME: 대화목록의 name의 ID입니다. Chat API를 사용하여 메시지를 비동기식으로 만들거나 만들 때 메시지에 할당된 맞춤 이름으로 메시지를 만든 후 반환된 응답 본문에서 ID를 가져올 수 있습니다.

Google Chat API는 지정된 스레드 읽기 상태를 가져와 ThreadReadState의 인스턴스를 반환합니다.