Google Chat API 개요

이 섹션에서는 Google Chat 앱이 Chat API를 호출하는 방법을 설명합니다. Chat API를 사용하면 Chat 앱에서 스페이스를 만들고, 사용자를 추가하고, 메시지를 게시하는 등의 작업을 할 수 있습니다.

인증

Chat API를 호출하려면 인증이 필요합니다. 각 Chat API 메서드에는 사용자 인증(사용자를 대신하여 작업을 실행하거나 데이터에 액세스하기 위해) 또는 앱 인증(Chat 앱으로 작업을 실행하거나 데이터에 액세스하기 위해)이 필요합니다. 일부 메서드는 사용자 인증과 앱 인증을 모두 지원합니다.

Chat의 인증에 대해 자세히 알아보려면 인증 개요를 참고하세요.

클라이언트 라이브러리

대부분의 개발자가 Google Chat API를 호출하는 데 권장되는 방법은 Python, Java, Node.js와 같이 선호하는 언어로 공식적으로 지원되는 Cloud 클라이언트 라이브러리를 사용하는 것입니다.

Google Apps Script로 코딩하는 경우 클라이언트 라이브러리를 설치하는 대신 고급 Chat 서비스를 사용하세요.

Google Chat API 개념

gRPC 서비스 또는 REST 리소스 및 메서드는 Chat 스페이스, 스페이스 구성원, 메시지, 메시지 리액션, 메시지 첨부파일, 스페이스 이벤트, 사용자 읽기 상태에 대한 액세스 권한을 부여합니다.

스페이스

스페이스는 사용자와 앱이 대화하고 파일을 공유할 수 있는 공간입니다. 스페이스에는 여러 유형이 있습니다. 채팅 메시지 (DM)는 두 사용자 간의 1:1 대화 또는 사용자와 Chat 앱 간의 대화입니다. 그룹 채팅은 3명 이상의 사용자와 Chat 앱 간의 대화입니다. 이름이 지정된 스페이스는 사용자가 메시지를 보내고, 파일을 공유하고, 공동작업하는 영구적인 공간입니다.

리소스 참조:

사용 예시는 다음을 참고하세요.

구성원

참여자는 스페이스에 참여했거나 초대된 사용자 및 Chat 앱입니다.

리소스 참조:

사용 예시는 다음을 참고하세요.

메시지

메시지에는 스페이스에 게시된 텍스트 및 카드 커뮤니케이션이 포함됩니다. 메일에 파일을 첨부할 수 있습니다. 사용자는 메시지에 그림 이모티콘을 추가하여 메시지에 반응할 수 있습니다.

리소스 참조:

사용 예시는 다음을 참고하세요.

리액션

리액션은 사용자가 메시지에 반응하는 데 사용하는 이모티콘(예: 👍, 🚲, 🌞)을 나타냅니다.

리소스 참조:

사용 예시는 다음을 참고하세요.

맞춤 그림 이모티콘 (개발자 프리뷰)

맞춤 이모티콘은 Google Chat에서 조직 내에서 만들어지고 공유된 맞춤 이모티콘을 나타냅니다. 맞춤 이모티콘은 메시지 콘텐츠에 포함하거나 메시지에 반응하는 데 사용할 수 있습니다.

리소스 참조:

미디어 및 첨부파일

미디어는 이미지, 동영상, 문서와 같이 Google Chat에 업로드된 파일을 나타냅니다.

미디어 리소스 참조 (RPC에서는 사용할 수 없음):

첨부파일은 메일에 첨부된 미디어 (파일)의 인스턴스입니다.

리소스 참조:

사용 예시는 다음을 참고하세요.

스페이스 이벤트

스페이스 이벤트는 스페이스 또는 스페이스의 하위 리소스(예: 참여자, 메시지, 반응)의 변경사항을 나타냅니다.

리소스 참조:

사용 예시는 다음을 참고하세요.

사용자 읽기 상태

사용자 읽기 상태는 Google Chat 스페이스 또는 메시지 대화목록에서 지정된 사용자의 마지막으로 읽은 메시지에 관한 세부정보를 나타내는 싱글톤 리소스입니다.

스페이스 읽기 상태 리소스 참조:

스레드 읽기 상태 리소스 참조:

사용 예시는 다음을 참고하세요.

사용자 공간 알림 설정 (개발자 프리뷰)

사용자 스페이스 알림 설정은 Google Chat 스페이스에서 지정된 사용자 알림 설정을 나타내는 싱글톤 리소스입니다.

리소스 참조:

Chat 앱은 Chat API를 호출하는 것 외에도 다음 작업을 할 수 있습니다.