클라이언트 라이브러리 설명

Google Cloud API는 HTTP 요청(또는 가능한 경우 RPC 호출)을 직접 서버에게 전송하여 사용할 수 있지만 즐겨 사용하는 언어에서 더욱 쉽게 액세스할 수 있도록 클라이언트 라이브러리 코드를 모든 Cloud API에게 제공하고 있습니다. 이번 문서에서는 Cloud API에게 제공하고 있는 여러 가지 유형의 클라이언트 라이브러리에 대해서 설명합니다. 원하는 제품 또는 언어에 제공되는 라이브러리에 대한 자세한 내용은 해당 제품 또는 언어의 설명서에서 찾아볼 수 있습니다.

Google Cloud 클라이언트 라이브러리

Google Cloud 클라이언트 라이브러리는 최신 클라이언트 라이브러리 모델을 사용하기 때문에 프로그래매틱 방식으로 Cloud API에 액세스할 때 권장할 수 있는 옵션입니다. Cloud 클라이언트 라이브러리는 다음과 같습니다.

  • 관용 코드, 생성 코드 또는 필기 코드를 각 언어로 제공하기 때문에 Cloud API를 간단하게 직관적으로 사용할 수 있습니다.
  • Google 인증을 포함해 서버와 이루어지는 통신에 대한 하위 수준의 세부 정보를 모두 처리합니다.
  • npm, pip 같이 친숙한 패키지 관리 도구를 사용해 설치 가능합니다.
  • 일부 경우, gRPC를 사용해 성능 이점을 제공합니다. 자세한 내용은 아래 gRPC API 섹션에서 찾아볼 수 있습니다.

해당하는 Cloud 클라이언트 라이브러리에 따른 설치 안내 및 참조 자료는 선택한 Cloud API의 클라이언트 라이브러리 페이지에서 찾아볼 수 있습니다.

지원되는 언어 대부분에서, 지원되는 Cloud API에 대한 인터페이스를 제공하는 단일 클라이언트 라이브러리를 다운로드할 수 있습니다. 각 클라이언트 라이브러리와 참조 문서를 시작할 수 있는 링크는 Cloud 클라이언트 라이브러리 페이지에서 찾아볼 수 있습니다.

Google API 클라이언트 라이브러리

Google Cloud 클라이언트 라이브러리를 모든 언어로 제공하는 Google Cloud API는 아직 많지 않습니다. 이러한 API 중 하나를 사용하고 싶지만 원하는 언어로 제공되는 Cloud 클라이언트 라이브러리가 아직 없다면 Google API 클라이언트 라이브러리라고 하는 이전 버전의 클라이언트 라이브러리를 계속해서 사용할 수 있습니다. 이전 버전의 라이브러리는 다음과 같습니다.

  • API의 REST 인터페이스에 한해 액세스를 제공하며, gRPC는 지원되지 않습니다.
  • 최신 라이브러리와 같은 관용 코드는 아니지만 자동 생성되는 인터페이스 코드가 있습니다.
  • Google 인증을 포함해 서버와 이루어지는 통신에 대한 하위 수준의 세부 정보를 모두 처리합니다.
  • npm, pip 같이 친숙한 패키지 관리 도구를 사용해 설치 가능합니다.

이전 버전의 라이브러리 링크는 필요할 경우 Cloud API의 클라이언트 라이브러리 페이지에서 찾아볼 수 있습니다.

Firebase 모바일 플랫폼 사용

Firebase는 휴대기기 애플리케이션을 개발할 수 있는 Google 전체 솔루션입니다. 이 솔루션은 SDK를 클라이언트 코드와 함께 제공하기 때문에 iOS, Android 및 웹 앱에서 모바일 관련 Cloud API에 직접 액세스할 수 있습니다. 지원되는 Cloud API와 Firebase 시작 방법에 대한 자세한 내용은 Firebase 설명서를 참조하세요.

고유 클라이언트 코드 사용

일반적으로 Google의 클라이언트 라이브러리를 사용해 Cloud API에 액세스하도록 권장하고 있습니다. 하지만 자신이 숙련된 개발자이면서 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 인터페이스 2개가 있기 때문에 gRPC 기반 API 클라이언트는 JSON over HTTP 하나만 사용해 REST 인터페이스와 통신하지 않고 프로토콜 버퍼와 gRPC over HTTP2를 사용해 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 1개당 처리량을 최대 10배까지 늘릴 수 있습니다. 앞으로 최대한 많은 Cloud 클라이언트 라이브러리를 gRPC로 업그레이드할 계획이며, 업그레이드되더라도 클라이언트 라이브러리 코드의 나머지 모든 이점이 그대로 제공됩니다.

그 밖에 Cloud API에 액세스할 수 있는 방법

API에 프로그래매틱 방식으로 액세스하지 않더라도 Google Cloud SDK의 도구 또는 Google Cloud Platform Console을 통해 동일한 기능에 액세스할 수 있습니다.

이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

다음에 대한 의견 보내기...