Google Chat API 개요

이 섹션에서는 Google Chat 앱이 Chat API를 호출하는 방법을 설명합니다. Chat API를 통해 Chat 앱 상호작용 이벤트에서 메시지를 표시하지 않고도 Chat 앱이 스페이스를 만들고, 스페이스에 사용자를 추가하고, 메시지를 게시하는 등의 작업을 수행할 수 있습니다.

인증

Chat API를 비동기식으로 호출하려면 인증이 필요합니다. 각 Chat API 메서드에는 사용자 인증(사용자 대신 작업 수행 또는 데이터 액세스) 또는 앱 인증(채팅 앱으로 작업 수행 또는 데이터 액세스)이 필요합니다. 일부 방법은 사용자 인증과 앱 인증을 모두 지원합니다.

Chat의 인증에 대한 자세한 내용은 인증 개요를 참조하세요.

API 리소스 및 메서드

REST 리소스 및 메서드는 Chat 스페이스, 스페이스 구성원, 메시지, 메시지 반응, 메시지 첨부파일에 대한 비동기 액세스 권한을 부여합니다.

스페이스

스페이스는 사용자와 앱이 대화하고 파일을 공유할 수 있는 장소입니다. 여러 유형의 공간이 있습니다. 채팅 메시지 (DM)는 두 사용자 또는 사용자와 채팅 앱 간의 1:1 대화입니다. 그룹 채팅은 3명 이상의 사용자와 Chat 앱 간의 대화입니다. 이름이 지정된 스페이스는 사용자가 메시지를 보내고 파일을 공유하며 공동작업할 수 있는 영구적인 공간입니다

spaces 리소스는 공백을 나타냅니다.

스페이스에서는 다음 메서드를 지원합니다.

구성원

멤버는 스페이스에 참여했거나 초대된 사용자와 채팅 앱입니다.

spaces.members 리소스는 구성원을 나타냅니다.

멤버는 다음 메서드를 지원합니다.

메시지

메시지에는 스페이스에 게시된 텍스트카드 커뮤니케이션이 포함됩니다. 메시지에 파일을 첨부할 수 있습니다. 사용자는 메시지에 이모티콘을 추가하여 메시지에 반응할 수 있습니다.

spaces.messages 리소스는 메시지를 나타냅니다.

메시지에서 지원하는 메서드는 다음과 같습니다.

리액션

반응은 사람들이 메시지에 반응할 때 사용하는 이모티콘을 (예: 👍, 😲, 먼) 나타냅니다.

spaces.messages.reactions 리소스는 반응을 나타냅니다.

리액션은 다음 메서드를 지원합니다.

미디어 및 첨부파일

미디어는 이미지, 동영상, 문서 등 Google Chat에 업로드된 파일을 나타냅니다.

media 리소스는 메시지에 첨부된 미디어를 나타냅니다.

첨부파일은 메일에 첨부된 미디어 (파일)의 인스턴스입니다.

spaces.messages.attachments 리소스는 연결을 나타냅니다. 첨부파일에는 메시지에 연결된 미디어 및 관련 메타데이터가 포함됩니다.

미디어 및 첨부파일은 다음 방법을 지원합니다.

스페이스 이벤트

스페이스 이벤트는 스페이스 또는 스페이스의 멤버, 메시지, 반응을 포함하여 스페이스 또는 그 하위 리소스의 변경사항을 나타냅니다.

spaces.spaceEvent 리소스는 스페이스 이벤트를 나타냅니다.

스페이스 이벤트는 다음 메서드를 지원합니다.

사용자 읽기 상태 (개발자 프리뷰)

사용자 읽기 상태는 Google Chat 스페이스 또는 메시지 스레드에서 지정된 사용자가 마지막으로 읽은 메시지에 대한 세부정보를 나타내는 싱글톤 리소스입니다.

users.spaces 리소스는 스페이스에서 사용자의 읽기 상태를 나타냅니다.

users.spaces.threads 리소스는 메시지 스레드에서 사용자의 읽기 상태를 나타냅니다.

사용자 읽기 상태는 다음 메서드를 지원합니다.