시작하기

이 페이지에서는 개발자가 Google Cloud API를 사용하는 방법을 설명합니다.

Google Cloud API를 처음 사용하는 경우 이 가이드의 단계에 따라 curl 명령어를 사용하여 API를 호출할 수 있습니다. 애플리케이션을 개발하기 전에 curl 명령어를 사용하여 API를 실험할 수 있습니다.

Google 계정 만들기

애플리케이션에서 Google Cloud API를 사용하려면 먼저 Google 계정이 있어야 합니다. 이렇게 하면 Google Cloud Console, gcloud CLI, Cloud Logging, Cloud Monitoring을 포함하여 Google 개발자 제품을 사용할 수 있습니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.

Google 프로젝트 만들기

Cloud API를 사용하려면 Google 프로젝트도 있어야 합니다. 프로젝트는 개발자 계정과 같습니다. 프로젝트는 Google Cloud 리소스에 대한 리소스 컨테이너 역할을 수행합니다. 또한 Google Cloud 서비스 사용에 대한 격리 경계를 제공하므로 프로젝트 수준에서 할당량 한도 및 결제를 직접 관리할 수 있습니다. 사용 원격 분석 및 대시보드는 프로젝트별로도 그룹화됩니다. 아직 프로젝트가 없으면 Google Cloud Console을 사용하여 프로젝트를 만들 수 있습니다.

프로젝트는 API 키, OAuth 클라이언트, 서비스 계정, Compute Engine VM, Cloud Storage 버킷, BigQuery 데이터 세트를 비롯한 다양한 리소스를 소유할 수 있습니다. 애플리케이션이 Cloud APIs를 호출하면 애플리케이션 사용자 인증 정보를 소유한 프로젝트를 클라이언트 프로젝트라고 하고 대상 리소스를 소유한 프로젝트를 리소스 프로젝트라고 합니다. API 요청 하나가 여러 리소스를 사용할 수 있으므로 여러 리소스 프로젝트가 관련됩니다.

어떤 이유로든 Google Cloud 사용을 중지하려면 Google Cloud Console을 사용하여 프로젝트를 삭제하면 됩니다. 보관 기간이 지나면 프로젝트와 프로젝트의 모든 리소스가 삭제됩니다. 다른 유형의 데이터에는 다른 보관 기간이 있습니다.

API 검색

Cloud API를 사용하기 전 Google Cloud Console API 라이브러리를 사용하여 사용 가능한 Cloud API를 찾아보고 비즈니스 요구에 가장 부합되는 항목을 찾아야 합니다. 특정 Cloud API에 대한 자세한 내용은 Spanner API와 같은 공개 문서 사이트를 방문하세요.

API 사용 설정

일부 Cloud API는 기본적으로 사용 설정되어 있습니다. 기본적으로 사용 설정되지 않은 Cloud API를 사용하려면 프로젝트에 사용 설정해야 합니다. 클라이언트 프로젝트와 리소스 프로젝트를 포함한 애플리케이션과 관련된 서비스와 프로젝트에 따라 여러 프로젝트에서 API를 사용 설정해야 할 수 있습니다. 다른 API에 의존하는 API를 사용 설정하면 이러한 API도 동시에 사용 설정됩니다.

API를 사용 설정하려면 API에 대한 서비스 약관 및 청구 책임에 동의해야 합니다. API를 사용 설정하려면 프로젝트에 대해 serviceusage.services.enable 권한이 필요합니다. 자세한 정보는 서비스 사용량 액세스 제어를 참조하세요.

또한 사용 설정할 서비스는 공개 상태여야 합니다. 아니면 서비스 소유자가 사용자에게 비공개 서비스에 대해 servicemanagement.services.bind 권한을 부여해야 합니다. 자세한 내용은 Service Management 액세스 제어를 참조하세요.

Console을 사용해 프로젝트에서 API를 사용 설정하는 방법은 다음과 같습니다.

  1. Google Cloud Console API 라이브러리로 이동합니다.
  2. 프로젝트 목록에서 사용할 프로젝트를 선택합니다.
  3. API 라이브러리에서 사용 설정할 API를 선택합니다. API를 찾는 데 도움이 필요하다면 검색 필드 및/또는 필터를 사용하세요.
  4. API 페이지에서 사용 설정을 클릭합니다.

오용 및 실수로 인한 요금 결제가 발생하지 않도록 동일한 페이지에서 더 이상 사용하지 않는 프로젝트에 API를 중지할 수 있습니다. 또한 gcloud CLI 및 Service Usage API를 사용하여 Cloud API를 사용 설정하거나 사용 중지할 수 있습니다.

$ gcloud services enable pubsub.googleapis.com
$ gcloud services disable pubsub.googleapis.com

결제 사용 설정 중

일부 Cloud API는 사용 요금이 부과됩니다. 프로젝트에서 이러한 API 사용을 시작하기 전에 프로젝트에서 결제를 사용 설정해야 합니다. 프로젝트의 API 사용량은 프로젝트에 연결된 결제 계정으로 청구됩니다.

결제 계정이 없으면 Google Cloud Console 결제 페이지로 이동하여 안내를 따라 결제 계정을 만듭니다. 그런 다음 프로젝트에 결제 계정을 연결하세요.

API 인증

API에 인증하는 방법은 개발 환경 및 API가 지원하는 인증 방법에 따라 다릅니다.

다양한 환경에서 사용할 애플리케이션 기본 사용자 인증 정보를 설정하는 것이 가장 일반적인 방법이며 대부분의 애플리케이션에 권장됩니다. API가 API 키를 지원하는 경우에도 다른 옵션입니다. 애플리케이션에서 최종 사용자가 소유한 Cloud 리소스에 액세스해야 하는 경우 OAuth 2.0 클라이언트 ID를 만들고 인증 라이브러리를 사용합니다.

인증에 대한 일반적인 정보는 Google에서 인증을 참조하세요.

애플리케이션 빌드

Cloud API를 사용하여 애플리케이션을 구축하는 경우, 가능하다면 Google Cloud 클라이언트 라이브러리를 사용하는 것이 좋습니다. 클라이언트 라이브러리는 인증, 오류 처리, 재시도, 페이로드 유효성 검사와 같은 편의를 위한 일반적인 API 기능을 처리합니다. 클라이언트 라이브러리가 애플리케이션 대신 Google Cloud API를 호출할 수 있도록 초기화 중에 애플리케이션 사용자 인증 정보를 클라이언트 라이브러리에 전달해야 합니다.

인기 API에 클라이언트 라이브러리를 사용하기 위한 다음 단계별 안내를 참조하세요.

자세한 내용은 클라이언트 라이브러리 설명을 참조하세요.

추가 정보