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