Google Chat API 개요
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
이 페이지에서는 Google Chat API 및 참조 문서를 사용하는 방법을 간략하게 설명합니다.
Google Chat API에는 gRPC 및 REST 인터페이스와 이를 모두 지원하는 클라이언트 라이브러리가 있습니다. 필요한 경우 제공된 클라이언트 라이브러리가 요구사항을 충족하지 않으면 gRPC 또는 REST 인터페이스를 사용하는 자체 클라이언트 라이브러리를 작성할 수 있습니다.
클라이언트 라이브러리
대부분의 개발자가 Google Chat API를 호출하는 데 권장되는 방법은 Python, Java, Node.js와 같은 선호하는 언어에 대해 공식적으로 지원되는 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 버전을 사용할 수 있습니다.
개발자 프리뷰
문서에는 개발자 미리보기 프로그램을 통해서만 사용할 수 있는 API 메서드나 필드가 표시될 수 있습니다. 최신 미리보기 기능을 테스트하고 미리 보고 의견을 제공하려면 개발자 미리보기 프로그램에 참여하세요.
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-08-29(UTC)
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[[["\u003cp\u003eThis page offers guidance on utilizing the Google Chat API and navigating its reference documentation, including gRPC and REST interfaces.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers are encouraged to use the provided client libraries for Python, Java, Node.js, or the Advanced Chat service for Google Apps Script.\u003c/p\u003e\n"],["\u003cp\u003eType, method, and field names may vary slightly depending on whether you are using client libraries, gRPC, or REST, with details provided on their respective conventions.\u003c/p\u003e\n"],["\u003cp\u003eThe Google Chat API is built upon protocol buffers, specifically proto3, which may require a basic understanding for certain request and response fields.\u003c/p\u003e\n"],["\u003cp\u003eStable API version v1 is currently available, with access to developer preview features obtainable through the Developer Preview Program.\u003c/p\u003e\n"]]],["The Google Chat API offers gRPC and REST interfaces, with corresponding client libraries or the option to create custom ones. Developers can use Cloud Client Libraries, or the Advanced Chat service with Google Apps Script. Type, method, and field names vary across libraries, gRPC, and REST. The API relies on protocol buffers (proto3), which can impact JSON responses due to default value behavior. The current stable version is v1, with a Developer Preview program for testing new features.\n"],null,["# Google Chat API overview\n\nThis page provides an overview of how to use Google Chat API and its reference\ndocumentation.\n\nGoogle Chat API has both [gRPC](/workspace/chat/api/reference/rpc) and\n[REST](/workspace/chat/api/reference/rest) interfaces, and\n[client libraries](/workspace/chat/libraries) that support both. Optionally, if\nthe provided client libraries don't meet your needs, you can write your own\nclient libraries that use the gRPC or REST interface.\n\nClient libraries\n----------------\n\nThe recommended way for most developers to call the Google Chat API\nis with our officially supported\n[Cloud Client Libraries](/workspace/chat/libraries)\nfor your preferred language, like Python, Java, or Node.js.\n\nIf you're coding with Google Apps Script, use the\n[Advanced Chat service](/apps-script/advanced/chat)\ninstead of installing a client library.\n\nType, method, and field names\n-----------------------------\n\nDepending on whether you're using client libraries, gRPC, or REST, the type,\nmethod, and field names for the Google Chat API vary somewhat:\n\n- Cloud Client Libraries are arranged by gRPC services and their methods. Google API Client Libraries are arranged as services that contain objects or classes that correspond with REST resources, which also contain corresponding methods.\n- gRPC is arranged by services and their methods.\n- REST is arranged by resource hierarchies and their methods.\n- gRPC field names use snake case.\n- REST field names use camel case, though the API service will accept either camel case or snake case.\n- Client library field names use either title case, camel case or snake case, depending on which name is idiomatic for the language.\n\nProtocol buffers\n----------------\n\nWhether you are using client libraries, REST, or gRPC, the underlying service is\ndefined using [protocol buffers](/protocol-buffers). In particular, the service\nuses [proto3](/protocol-buffers/docs/proto3).\n\nWhen calling the API, some request or response fields can require a basic\nunderstanding of\n[protocol buffer well-known types](/protocol-buffers/docs/reference/google.protobuf).\n\nIn addition, when calling the REST API, the\n[default value](/protocol-buffers/docs/proto3#default) behavior for protocol\nbuffers may result in missing fields in a JSON response. These fields are\nset to the default value, so they are not included in the response.\n\nAPI versions\n------------\n\nThe following API versions are available:\n\n- **v1**: Stable.\n\nDeveloper Preview\n-----------------\n\nIn the documentation, you might see API methods or fields that are only\navailable through the Developer Preview Program. To test and preview and offer\nfeedback on the latest preview features, join the\n[Developer Preview Program](/workspace/preview).\n\nRelated topics\n--------------\n\n- [Call the Google Chat API](/workspace/chat/api-overview)"]]
