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