사용자의 스페이스 읽기 상태 업데이트

이 가이드에서는 Google Chat API의 SpaceReadState 리소스에서 update() 메서드를 사용하여 스페이스를 읽음 또는 읽지 않음으로 표시하는 방법을 설명합니다.

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

기본 요건

호출하는 사용자의 스페이스 읽기 상태 업데이트

스페이스 내에서 사용자의 읽기 상태를 업데이트하려면 요청에 다음을 포함하세요.

• chat.users.readstate 승인 범위를 지정합니다.
• UpdateSpaceReadState() 메서드를 호출합니다.
• lastReadTime 값으로 updateMask을 전달합니다.
• 다음과 같이 spaceReadState을 SpaceReadState의 인스턴스로 전달합니다.
  • 업데이트할 공간 읽기 상태로 설정된 name 필드입니다. 여기에는 사용자 ID 또는 별칭과 공간 ID가 포함됩니다. 스페이스 읽기 상태 업데이트는 호출 사용자의 읽기 상태 업데이트만 지원하며, 이는 다음 중 하나를 설정하여 지정할 수 있습니다.
    • me 별칭입니다. 예를 들면 users/me/spaces/SPACE/spaceReadState입니다.
    • 호출하는 사용자의 Workspace 이메일 주소입니다. 예를 들면 다음과 같습니다. users/user@example.com/spaces/SPACE/spaceReadState
    • 호출 사용자의 사용자 ID입니다. 예를 들면 다음과 같습니다. users/USER/spaces/SPACE/spaceReadState
  • 사용자의 스페이스 읽기 상태가 업데이트된 시간의 업데이트된 값으로 설정된 lastReadTime 필드입니다. 일반적으로 이는 마지막으로 읽은 메시지의 타임스탬프 또는 사용자가 스페이스에서 마지막으로 읽은 위치를 표시하기 위해 지정한 타임스탬프와 일치합니다. lastReadTime이 최신 메시지 생성 시간보다 이전이면 스페이스가 UI에서 읽지 않은 상태로 표시됩니다. 스페이스를 읽음으로 표시하려면 최신 메시지 생성 시간보다 큰 값을 나중에 lastReadTime로 설정합니다. lastReadTime이 최신 메시지 생성 시간과 일치하도록 강제됩니다. 스페이스 읽기 상태는 스페이스의 최상위 대화에 표시되는 메시지의 읽기 상태에만 영향을 미칩니다. 대화목록의 답장에는 이 타임스탬프가 적용되지 않으며 대신 대화목록 읽기 상태가 적용됩니다.

다음 예시에서는 호출 사용자의 스페이스 읽기 상태를 업데이트합니다.

import {createClientWithUserCredentials} from './authentication-utils.js';

const USER_AUTH_OAUTH_SCOPES = ['https://www.googleapis.com/auth/chat.users.readstate'];

// This sample shows how to update a 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 timestamp = new Date('2000-01-01').getTime();
  const request = {
    spaceReadState: {
      // Replace SPACE_NAME here
      name: 'users/me/spaces/SPACE_NAME/spaceReadState',
      lastReadTime: {
        seconds: Math.floor(timestamp / 1000),
        nanos: (timestamp % 1000) * 1000000
      }
    },
    updateMask: {
      // The field paths to update.
      paths: ['last_read_time']
    }
  };

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

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

main().catch(console.error);

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

Google Chat API는 지정된 스페이스 읽기 상태를 업데이트하고 SpaceReadState 인스턴스를 반환합니다.

관련 주제

• 호출 사용자의 스페이스 읽기 상태를 가져옵니다.
• 호출 사용자의 스레드 읽기 상태를 가져옵니다.