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