이 섹션에서는 Google Chat 앱이 Chat API를 호출하는 방법을 설명합니다. Chat API를 통해 Chat 앱 상호작용 이벤트에서 메시지를 표시하지 않고도 Chat 앱이 스페이스를 만들고, 스페이스에 사용자를 추가하고, 메시지를 게시하는 등의 작업을 수행할 수 있습니다.
인증
Chat API를 비동기식으로 호출하려면 인증이 필요합니다. 각 Chat API 메서드에는 사용자 인증(사용자 대신 작업 수행 또는 데이터 액세스) 또는 앱 인증(채팅 앱으로 작업 수행 또는 데이터 액세스)이 필요합니다. 일부 방법은 사용자 인증과 앱 인증을 모두 지원합니다.
Chat의 인증에 대한 자세한 내용은 인증 개요를 참조하세요.
API 리소스 및 메서드
REST 리소스 및 메서드는 Chat 스페이스, 스페이스 구성원, 메시지, 메시지 반응, 메시지 첨부파일에 대한 비동기 액세스 권한을 부여합니다.
- 스페이스
스페이스는 사용자와 앱이 대화하고 파일을 공유할 수 있는 장소입니다. 여러 유형의 공간이 있습니다. 채팅 메시지 (DM)는 두 사용자 또는 사용자와 채팅 앱 간의 1:1 대화입니다. 그룹 채팅은 3명 이상의 사용자와 Chat 앱 간의 대화입니다. 이름이 지정된 스페이스는 사용자가 메시지를 보내고 파일을 공유하며 공동작업할 수 있는 영구적인 공간입니다
spaces
리소스는 공백을 나타냅니다.스페이스에서는 다음 메서드를 지원합니다.
- 사용자와 앱이 대화하고 파일을 공유할 수 있는 공간인 스페이스를 만듭니다.
- 스페이스를 설정하여 스페이스를 만들고 사용자와 채팅 앱을 스페이스에 추가합니다.
- 스페이스에 관한 세부정보를 보려면 스페이스를 구매하세요.
- 페이지가 매겨지고 필터링 가능한 스페이스 목록을 보려면 스페이스를 나열하세요.
- 스페이스를 업데이트하여 사용자에게 표시되는 표시 이름, 설명, 가이드라인과 같은 스페이스 관련 속성을 변경합니다.
- 더 이상 필요하지 않은 공백을 삭제합니다.
- 채팅 메시지 (DM)를 찾아 두 사용자 간의 채팅 메시지 또는 사용자와 채팅 앱 간의 DM을 반환합니다.
- 구성원
멤버는 스페이스에 참여했거나 초대된 사용자와 채팅 앱입니다.
spaces.members
리소스는 구성원을 나타냅니다.멤버는 다음 메서드를 지원합니다.
- 메시지
메시지에는 스페이스에 게시된 텍스트 및 카드 커뮤니케이션이 포함됩니다. 메시지에 파일을 첨부할 수 있습니다. 사용자는 메시지에 이모티콘을 추가하여 메시지에 반응할 수 있습니다.
spaces.messages
리소스는 메시지를 나타냅니다.메시지에서 지원하는 메서드는 다음과 같습니다.
- 리액션
반응은 사람들이 메시지에 반응할 때 사용하는 이모티콘을 (예: 👍, 😲, 먼) 나타냅니다.
spaces.messages.reactions
리소스는 반응을 나타냅니다.리액션은 다음 메서드를 지원합니다.
- 미디어 및 첨부파일
미디어는 이미지, 동영상, 문서 등 Google Chat에 업로드된 파일을 나타냅니다.
media
리소스는 메시지에 첨부된 미디어를 나타냅니다.첨부파일은 메일에 첨부된 미디어 (파일)의 인스턴스입니다.
spaces.messages.attachments
리소스는 연결을 나타냅니다. 첨부파일에는 메시지에 연결된 미디어 및 관련 메타데이터가 포함됩니다.미디어 및 첨부파일은 다음 방법을 지원합니다.
- 미디어를 첨부파일로 업로드하여 Google Chat에 미디어를 업로드한 다음 메시지에 첨부합니다.
- 미디어를 첨부파일로 다운로드하여 Google Chat의 미디어를 바이너리 파일로 다운로드합니다.
- 메시지 첨부파일에 대한 메타데이터를 검색하려면 첨부파일을 가져옵니다.
- 스페이스 이벤트
스페이스 이벤트는 스페이스 또는 스페이스의 멤버, 메시지, 반응을 포함하여 스페이스 또는 그 하위 리소스의 변경사항을 나타냅니다.
spaces.spaceEvent
리소스는 스페이스 이벤트를 나타냅니다.스페이스 이벤트는 다음 메서드를 지원합니다.
- 스페이스 일정을 가져와 스페이스에서 발생한 일정에 대한 세부정보를 반환합니다.
- 스페이스 이벤트를 나열하여 스페이스에서 발생한 이벤트 목록을 가져옵니다.
- 사용자 읽기 상태
사용자 읽기 상태는 Google Chat 스페이스 또는 메시지 스레드에서 지정된 사용자가 마지막으로 읽은 메시지에 대한 세부정보를 나타내는 싱글톤 리소스입니다.
users.spaces
리소스는 스페이스에서 사용자의 읽기 상태를 나타냅니다.users.spaces.threads
리소스는 메시지 스레드에서 사용자의 읽기 상태를 나타냅니다.사용자 읽기 상태는 다음 메서드를 지원합니다.
- 스페이스 읽기 상태 가져오기: 스페이스 내 사용자의 읽기 상태에 관한 세부정보를 반환합니다.
- 스페이스 읽기 상태를 업데이트하여 스페이스 내 사용자의 읽기 상태를 업데이트합니다.
- 스레드 읽기 상태 가져오기: 스레드 내 사용자의 읽기 상태에 관한 세부정보를 반환합니다.