이 페이지에서는 Google Chat API 및 Google Chat 앱을 간략하게 설명합니다.
Google Chat API 개요
Chat API는 스페이스, 스페이스 구성원, 메시지, 메시지 반응, 메시지 첨부파일, 스페이스 이벤트, 사용자 읽기 상태 등 Chat에 대한 액세스 권한을 부여하는 gRPC 서비스 또는 REST 리소스 및 메서드로 구성됩니다.
개념
다음 섹션에서는 Chat API의 서비스, 리소스, 메서드를 정의합니다.
- 스페이스
스페이스는 사용자와 앱이 대화하고 파일을 공유할 수 있는 공간입니다. 스페이스에는 여러 유형이 있습니다. 채팅 메시지 (DM)는 두 사용자 또는 사용자와 Chat 앱 간의 1:1 대화입니다. 그룹 채팅은 세 명 이상의 사용자와 Chat 앱 간의 대화입니다. 이름이 지정된 스페이스는 사용자가 메시지를 보내고, 파일을 공유하고, 공동작업하는 지속적인 공간입니다.
리소스 참조:
사용 예시는 다음을 참고하세요.
- 구성원
멤버는 스페이스에 참여했거나 스페이스에 초대된 사용자 및 Chat 앱입니다.
리소스 참조:
사용 예시는 다음을 참고하세요.
- 메시지
메시지에는 스페이스에 게시된 텍스트 및 카드 커뮤니케이션이 포함됩니다. 메일에 파일을 첨부할 수 있습니다. 메시지에 그림 이모티콘을 추가하여 반응할 수 있습니다.
리소스 참조:
사용 예시는 다음을 참고하세요.
- 리액션
반응은 메시지에 반응하기 위해 사용자가 사용하는 그림 이모티콘을 나타냅니다(예: 👍, 🚲, 🌞).
리소스 참조:
사용 예시는 다음을 참고하세요.
- 맞춤 그림 이모티콘
맞춤 그림 이모티콘은 Google Chat에서 조직 내에서 만들어 공유된 맞춤 그림 이모티콘을 나타냅니다. 맞춤 그림 이모티콘은 메시지 콘텐츠에 포함하거나 메시지에 반응하는 데 사용할 수 있습니다.
리소스 참조:
- 미디어 및 첨부파일
미디어는 이미지, 동영상, 문서와 같이 Google Chat에 업로드된 파일을 나타냅니다.
미디어 리소스 참조 (RPC에서 사용 불가):
첨부파일은 메일에 첨부된 미디어 (파일)의 인스턴스입니다.
리소스 참조:
사용 예시는 다음을 참고하세요.
- 스페이스 이벤트
스페이스 이벤트는 스페이스 또는 스페이스의 하위 리소스(멤버, 메시지, 반응 포함)의 변경사항을 나타냅니다.
리소스 참조:
사용 예시는 다음을 참고하세요.
- 사용자 읽기 상태
사용자 읽음 상태는 Google Chat 스페이스 또는 메시지 스레드에서 지정된 사용자의 마지막 읽음 메시지에 관한 세부정보를 나타내는 싱글톤 리소스입니다.
스페이스 읽기 상태 리소스 참조:
스레드 읽기 상태 리소스 참조:
사용 예시는 다음을 참고하세요.
- 사용자 스페이스 알림 설정
사용자 스페이스 알림 설정은 Google Chat 스페이스에서 지정된 사용자 알림 설정을 나타내는 싱글톤 리소스입니다.
리소스 참조:
인증
Chat API를 호출하려면 인증이 필요합니다. 각 Chat API 메서드에는 사용자 인증(사용자를 대신하여 작업을 실행하거나 데이터에 액세스) 또는 앱 인증(Chat 앱으로 작업을 실행하거나 데이터에 액세스)이 필요합니다. 일부 메서드는 사용자 인증과 앱 인증을 모두 지원합니다.
Chat의 인증에 대해 자세히 알아보려면 인증 개요를 참고하세요.
클라이언트 라이브러리
대부분의 개발자가 Google Chat API를 호출하는 데 권장되는 방법은 Python, Java, Node.js와 같은 선호하는 언어에 대해 공식적으로 지원되는 Cloud 클라이언트 라이브러리를 사용하는 것입니다.
Google Apps Script로 코딩하는 경우 클라이언트 라이브러리를 설치하는 대신 고급 Chat 서비스를 사용하세요.
Chat 앱 빌드
Chat API를 사용하면 서비스와 리소스를 Google Chat으로 바로 가져오는 Google Chat 앱을 빌드할 수 있습니다. 다음과 같은 작업을 실행하는 Chat 앱을 빌드할 수 있습니다.
- 사용자가 입력한 구조화된 텍스트 또는 자유 형식 텍스트 쿼리를 기반으로 정보를 가져옵니다.
- 사용자가 제공한 정보를 사용하여 사고 보고서 또는 기타 아티팩트를 생성합니다.
- '팀 메모리' 제공 또는 리소스 예약과 같은 팀 공동작업을 개선합니다.
다음과 같은 다양한 아키텍처 스타일을 사용하여 Chat 앱을 설계할 수 있습니다.
- 대화형 앱: @멘션 또는 슬래시 명령어와 같은 사용자 상호작용에 응답하고 카드와 대화상자를 사용하여 정보를 표시하거나 워크플로를 통해 사용자를 안내합니다.
- 명령줄 앱 또는 웹훅: 다른 시스템에서 스페이스로 알람이나 알림과 같은 사전 알림 메시지를 보냅니다. 사용자는 이러한 유형의 앱과 직접 상호작용할 수 없습니다.
- 이벤트 기반 앱: 새 회원의 가입과 같은 Chat 스페이스의 활동을 구독하고 이에 반응합니다. 이벤트에 대한 응답으로 앱은 메시지를 보내거나 다른 작업을 실행할 수 있습니다.
Chat 앱 설계에 관한 자세한 내용은 Google Chat 앱 아키텍처 선택하기를 참고하세요.
관련 주제
 |
Google Chat API가 실제로 작동하는 모습을 보고 싶으신가요?
Google Workspace 개발자 채널에서는 팁, 유용한 정보, 최신 기능에 관한 동영상을 제공합니다.
|