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