이 페이지에서는 Google Chat API 및 참조 문서를 사용하는 방법을 간략하게 설명합니다.
Google Chat API에는 gRPC 및 REST 인터페이스와 둘 다 지원하는 클라이언트 라이브러리가 있습니다. 제공된 클라이언트 라이브러리가 요구사항을 충족하지 않는 경우 gRPC 또는 REST 인터페이스를 사용하는 자체 클라이언트 라이브러리를 작성할 수 있습니다(선택사항).
클라이언트 라이브러리
대부분의 개발자가 Google Chat API를 호출하는 데 권장되는 방법은 Python, Java 또는 Node.js와 같은 선호하는 언어에 대해 Google에서 공식적으로 지원하는Cloud 클라이언트 라이브러리를 사용하는 것입니다.
Google Apps Script로 코딩하는 경우 클라이언트 라이브러리를 설치하는 대신 고급 Chat 서비스 를 사용하세요.
유형, 메서드, 필드 이름
클라이언트 라이브러리, gRPC 또는 REST 중 어떤 것을 사용하는지에 따라 Google Chat API의 유형, 메서드, 필드 이름이 약간 달라집니다.
- Cloud 클라이언트 라이브러리는 gRPC 서비스와 해당 메서드를 기준으로 정렬됩니다. Google API 클라이언트 라이브러리는 REST 리소스에 해당하는 객체 또는 클래스를 포함하는 서비스로 정렬되며, 해당 메서드도 포함합니다.
- gRPC는 서비스와 해당 메서드를 기준으로 정렬됩니다.
- REST는 리소스 계층 구조와 해당 메서드를 기준으로 정렬됩니다.
- gRPC 필드 이름은 스네이크 표기법을 사용합니다.
- API 서비스에서는 카멜 표기법이나 스네이크 표기법을 허용하지만 REST 필드 이름에서는 카멜 표기법을 사용합니다.
- 클라이언트 라이브러리 필드 이름은 어떤 이름이 해당 언어에 자연스러운지에 따라 타이틀 표기법, 카멜 표기법, 스네이크 표기법 중 하나를 사용합니다.
프로토콜 버퍼
클라이언트 라이브러리, REST 또는 gRPC를 사용하는지 여부에 관계없이 기본 서비스는 프로토콜 버퍼를 사용하여 정의됩니다. 특히 서비스는 proto3을 사용합니다.
API를 호출할 때 일부 요청 또는 응답 필드에는 기본적인 이해와 프로토콜 버퍼 잘 알려진 유형이 필요할 수 있습니다.
또한 REST API를 호출할 때 프로토콜 버퍼의 기본값 동작으로 인해 JSON 응답에 필드가 누락될 수 있습니다. 이러한 필드는 기본값으로 설정되므로 응답에 포함되지 않습니다.
API 버전
다음 API 버전을 사용할 수 있습니다.
- v1: 정식.
개발자 프리뷰
문서에서 개발자 프리뷰 프로그램을 통해서만 사용할 수 있는 API 메서드 또는 필드가 표시될 수 있습니다. 최신 프리뷰 기능을 테스트하고 미리 보고 의견을 제공하려면 개발자 프리뷰 프로그램에 참여하세요.