이 섹션에서는 Google Chat 앱이 Chat API를 호출할 수 있는 방법을 설명합니다. 이를 통해 채팅 앱은 Chat 앱 상호작용 이벤트에 의해 메시지가 표시되지 않고도 스페이스 만들기, 사용자 추가, 메시지 게시 등의 작업을 할 수 있습니다.
인증
Chat API를 비동기식으로 호출하려면 인증이 필요합니다. 각 Chat API 메서드에는 사용자 인증(사용자 대신 작업 수행 또는 데이터 액세스) 또는 앱 인증(채팅 앱으로 작업 수행 또는 데이터 액세스)이 필요합니다. 일부 메서드는 사용자 인증과 앱 인증을 모두 지원합니다.
Chat의 인증에 관한 자세한 내용은 인증 개요를 참고하세요.
API 리소스 및 메서드
REST 리소스 및 메서드는 Chat 스페이스, 스페이스 구성원, 메시지, 메시지 반응, 메시지 첨부파일에 대한 비동기 액세스 권한을 부여합니다.
- 스페이스
스페이스는 사용자와 앱이 대화하고 파일을 공유할 수 있는 장소입니다. 여러 유형의 공간이 있습니다. 채팅 메시지 (DM)는 두 사용자 또는 사용자와 채팅 앱 간의 1:1 대화입니다. 그룹 채팅은 3명 이상의 사용자와 채팅 앱 간의 대화입니다. 이름이 지정된 스페이스는 지속적으로 사용자가 메시지를 보내고, 파일을 공유하고, 협업하는 공간입니다.
spaces
리소스는 공백을 나타냅니다.스페이스에서는 다음 메서드를 지원합니다.
- 사용자와 앱이 대화하고 파일을 공유할 수 있는 스페이스를 만듭니다.
- 스페이스를 설정하여 스페이스를 만들고 해당 스페이스에 사용자와 채팅 앱을 추가합니다.
- 스페이스를 가져와서 스페이스 세부정보를 확인합니다.
- 스페이스 목록을 표시하여 페이지로 나눈 필터링 가능한 스페이스 목록을 확인합니다.
- 스페이스를 업데이트하여 사용자에게 표시되는 표시 이름, 설명, 가이드라인과 같이 스페이스에 관한 속성을 변경합니다.
- 더 이상 필요하지 않은 공백 삭제
- 채팅 메시지 (DM)를 찾아 두 사용자 간의 DM 또는 사용자와 통화 중인 채팅 앱 간의 DM을 반환합니다.
- 구성원
멤버는 스페이스에 참여했거나 스페이스에 초대된 사용자 및 Chat 앱입니다.
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
리소스는 메시지 스레드에서 사용자의 읽기 상태를 나타냅니다.사용자 읽기 상태에서는 다음 메서드가 지원됩니다.
- 스페이스 읽기 상태 가져오기: 스페이스 내에서 사용자의 읽기 상태에 관한 세부정보를 반환합니다.
- 스페이스 읽기 상태 업데이트: 스페이스 내에서 사용자의 읽기 상태를 업데이트합니다.
- 스레드 내에서 사용자의 읽기 상태에 관한 세부정보를 반환하려면 스레드 읽기 상태를 가져옵니다.