이 가이드에서는 Google Chat API의 SpaceReadState
리소스에서 get()
메서드를 사용하여 스페이스 내 사용자의 읽기 상태에 관한 세부정보를 가져오는 방법을 설명합니다. 메시지 대화목록에서 메시지의 읽기 상태를 가져오려면 사용자의 대화목록 읽기 상태에 관한 세부정보 가져오기를 참고하세요.
SpaceReadState
리소스는 Google Chat 스페이스에서 지정된 사용자가 마지막으로 읽은 메시지에 관한 세부정보를 나타내는 싱글톤 리소스입니다.
기본 요건
Node.js
- Google Chat에 액세스할 수 있는 비즈니스 또는 엔터프라이즈 Google Workspace 계정
- 환경을 설정합니다.
- Google Cloud 프로젝트를 만듭니다.
- OAuth 동의 화면 구성
- 채팅 앱의 이름, 아이콘, 설명을 사용하여 Google Chat API를 사용 설정하고 구성합니다.
- Node.js Cloud 클라이언트 라이브러리를 설치합니다.
- 데스크톱 애플리케이션용
OAuth 클라이언트 ID 사용자 인증 정보 만들기 이 가이드에서 샘플을 실행하려면 사용자 인증 정보를
client_secrets.json
라는 JSON 파일로 로컬 디렉터리에 저장합니다.
- 사용자 인증을 지원하는 승인 범위를 선택합니다.
호출하는 사용자의 스페이스 읽기 상태 가져오기
스페이스 내에서 사용자의 읽기 상태에 관한 세부정보를 가져오려면 요청에 다음을 포함합니다.
chat.users.readstate
또는chat.users.readstate.readonly
승인 범위를 지정합니다.GetSpaceReadState()
메서드를 호출하여 사용자 ID 또는 별칭과 공간 ID가 포함된 공간 읽기 상태의name
를 전달합니다. 공간 읽기 상태를 가져오면 호출하는 사용자의 읽기 상태만 가져올 수 있으며 다음 중 하나를 설정하여 지정할 수 있습니다.me
별칭 예를 들면users/me/spaces/SPACE/spaceReadState
입니다.- 호출 사용자의 Workspace 이메일 주소입니다. 예를 들면 다음과 같습니다.
users/user@example.com/spaces/SPACE/spaceReadState
- 호출 사용자의 사용자 ID입니다. 예를 들면 다음과 같습니다.
users/USER/spaces/SPACE/spaceReadState
다음 예에서는 호출하는 사용자의 스페이스 읽기 상태를 가져옵니다.
Node.js
이 샘플을 실행하려면 SPACE_NAME
를 스페이스의 name
에 있는 ID로 바꿉니다.
ListSpaces()
메서드를 호출하거나 스페이스의 URL에서 ID를 가져올 수 있습니다.
Google Chat API는 지정된 스페이스 읽기 상태를 가져와 SpaceReadState
인스턴스를 반환합니다.