클라이언트 라이브러리를 사용하면 지원되는 언어로 Google Cloud API에 쉽게 액세스할 수 있습니다. 서버에 원시 요청을 수행해서 Google Cloud API를 직접 사용할 수 있지만 클라이언트 라이브러리는 작성할 코드 양을 크게 줄여 주는 간소화 기능을 제공합니다.
이 문서에서는 Cloud API를 위해 Google에서 제공되는 여러 유형의 클라이언트 라이브러리에 대해 설명합니다. 또한 원하는 제품 또는 언어에 제공되는 라이브러리에 대한 자세한 내용은 해당 제품 또는 언어의 문서를 참조하세요.
Cloud 클라이언트 라이브러리
Cloud 클라이언트 라이브러리는 가능한 경우 Cloud API에 프로그래매틱 방식으로 액세스하기 위해 권장되는 옵션입니다. Cloud 클라이언트 라이브러리에는 최신 클라이언트 라이브러리 모델이 사용됩니다.
- 각 언어에서 관용적인 코드를 제공함으로써 Cloud API를 직관적으로 간단하게 사용할 수 있게 해줍니다.
- 클라이언트 라이브러리가 일관된 스타일로 제공되어, 클라우드 서비스가 여러 개여도 쉽게 사용할 수 있습니다.
- Google 인증을 포함해 서버와 이루어지는 통신에 대한 하위 수준의 세부 정보를 모두 처리합니다.
npm및pip와 같은 익숙한 패키지 관리 도구를 사용하여 설치할 수 있습니다.- 일부 경우에는 gRPC를 사용한 성능 이점을 제공합니다. 자세한 내용은 gRPC API를 참조하세요.
사용 중인 Cloud API에 대한 클라이언트 라이브러리 페이지에서 Cloud 클라이언트 라이브러리에 대한 설치 안내 및 참조 자료를 찾아볼 수 있습니다. Cloud 클라이언트 라이브러리를 시작하기 위한 링크 및 참조 문서를 보려면 Cloud 클라이언트 라이브러리 페이지를 참조하세요.
직접 사용해 보기
Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.
무료로 시작하기Google API 클라이언트 라이브러리
일부 Google Cloud API의 경우 Cloud 클라이언트 라이브러리가 모든 언어로 제공되지는 않습니다. 이러한 API 중 하나를 사용할 때 원하는 언어의 Cloud 클라이언트 라이브러리가 없으면 Google API 클라이언트 라이브러리라고 부르는 이전 스타일의 클라이언트 라이브러리를 사용할 수 있습니다. 또한 이미 이를 사용하는 프로젝트를 업로드하는 경우에도 이러한 라이브러리를 사용할 수 있습니다. 이전 버전의 라이브러리는 다음과 같습니다.
- API의 REST 인터페이스에 한해 액세스를 제공하며, gRPC는 지원되지 않습니다.
- Cloud 클라이언트 라이브러리처럼 관용적이진 않을 수 있는 자동 생성된 인터페이스 코드를 지원합니다.
- Google 인증을 포함해 서버와 이루어지는 통신에 대한 하위 수준의 세부 정보를 모두 처리합니다.
npm및pip와 같은 익숙한 패키지 관리 도구를 사용하여 설치할 수 있습니다.
이러한 라이브러리는 관련된 Cloud API를 위해 클라이언트 라이브러리 페이지에 연결되어 있습니다.
Firebase 모바일 플랫폼 사용
Firebase는 휴대기기 애플리케이션을 개발할 수 있는 Google 전체 솔루션입니다. 이 솔루션은 SDK를 클라이언트 코드와 함께 제공하기 때문에 iOS, Android 및 웹 앱에서 모바일 관련 Cloud API에 액세스할 수 있습니다. 지원되는 Cloud API 및 Firebase 시작 방법에 대한 자세한 내용은 Firebase 문서를 참조하세요.
고유 클라이언트 코드 사용
숙련된 개발자이고 Google의 클라이언트 라이브러리가 특정 요구에 부합되지 않는 경우에는 서비스의 로우 레벨 서비스 API에 직접 액세스하기 위해 고유의 커스텀 코드를 작성할 수 있습니다.
REST/HTTP API
모든 Cloud API는 기존 JSON/REST 인터페이스를 하나만 제공합니다. 커스텀 코드를 작성해 제3의 HTTP 클라이언트 라이브러리를 사용하여 REST API에 직접 액세스해야 한다면 HTTP 가이드라인에서 Cloud API와 여러 HTTP 버전 및 구현체의 호환성에 대해 자세한 내용을 찾아볼 수 있습니다.
gRPC API
gRPC는 언어 중립적이고, 플랫폼 중립적이며, 오픈소스를 기반으로 하고, Google에서 처음 개발된 리모트 프로시져 콜(RPC) 시스템입니다. 자세한 내용은 grpc.io를 참조하세요. gRPC를 지원하는 Cloud API는 일반적으로 REST 및 RPC 인터페이스를 모두 포함합니다. 따라서 REST 인터페이스와 통신하기 위해 HTTP 기반 JSON만 사용하는 대신 gRPC 지원 API 클라이언트가 프로토콜 버퍼와 HTTP2 기반 gRPC를 사용해서 RPC 인터페이스와 통신할 수도 있습니다. API의 gRPC 기반 여부는 API 및 참조 섹션을 살펴보면 알아낼 수 있습니다.
Cloud API가 gRPC 기반일 경우 gRPC가 지원되는 모든 언어에서 고유의 gRPC 클라이언트 라이브러리를 생성할 수 있습니다. 이를 위해서는 API의 프로토콜 버퍼 서비스 정의(일반적으로 GitHub 저장소에서 제공)가 필요합니다. 그런 다음 grpc.io에서 원하는 언어에 해당하는 안내를 따라 클라이언트를 생성하여 사용할 수 있습니다.
고유 gRPC 코드를 생성하지 않더라도 gRPC의 이점을 이용할 수 있습니다. 점차 늘어나고 있는 gRPC 기반 API용 Cloud 클라이언트 라이브러리는 gRPC를 '알지 못하게' 사용하여 Google의 서버와 통신하기 때문입니다. 처리량과 CPU 사용량의 관점에서 보았을 때 이러한 방법이 훨씬 더 효율적입니다. gRPC를 사용하여 API에 액세스하면 JSON REST API와 비교 시 CPU당 처리량을 최대 10배까지 늘릴 수 있습니다 Google은 가능한 한 많은 Cloud 클라이언트 라이브러리를 gRPC로 업그레이드할 계획입니다. 그 동안에는 Google 클라이언트 라이브러리 코드의 다른 모든 장점도 계속 지원됩니다.
그 밖에 Cloud API에 액세스할 수 있는 방법
프로그래매틱 방식으로 API에 액세스하지 않으려면 Google Cloud CLI의 도구 또는 Google Cloud Console을 사용하여 일부 동일한 기능에 액세스할 수 있습니다.