시작하기

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

Google 계정 만들기

애플리케이션에서 Google Cloud API를 사용하려면 먼저 Google 계정이 있어야 합니다. 이렇게 하면 Google Cloud Console, Cloud SDK, Cloud Logging, 을 포함하여 Google 개발자 제품을 사용할 수 있습니다. Google 계정이 없으면 여기서 가입하면 됩니다.

Google 프로젝트 만들기

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

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

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

API 사용 설정 중

Cloud API를 사용하려면 프로젝트에 사용 설정해야 합니다. 클라이언트 프로젝트와 리소스 프로젝트를 포함한 애플리케이션과 관련된 서비스와 프로젝트에 따라 여러 프로젝트에서 API를 사용 설정해야 할 수 있습니다.

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

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

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

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

결제 사용 설정

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

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

애플리케이션 사용자 인증 정보 가져오기

Cloud API는 등록된 애플리케이션의 API 요청만 허용합니다. 이 요구사항은 API 제작자가 애플리케이션을 소유하는 올바른 프로젝트에 대해 API 사용을 연결하고 보고할 수 있게 해줍니다.

Cloud APIs는 호출 애플리케이션을 식별하기 위해 애플리케이션 사용자 인증 정보를 사용합니다. 사용자 인증 정보의 유형에는 API 키, OAuth 2.0 클라이언트, 서비스 계정이 포함됩니다. Cloud Console을 사용하여 애플리케이션 사용자 인증 정보를 생성, 검색, 관리할 수 있습니다. 애플리케이션 사용자 인증 정보에 대한 자세한 내용은 인증 개요를 참조하세요.

애플리케이션 사용자 인증 정보 사용

Google Cloud API를 처음 사용하는 경우 애플리케이션 코드를 작성하기 전에 oauth2l를 사용하여 애플리케이션 사용자 인증 정보와 Cloud APIs를 실험하는 것이 좋습니다. oauth2l는 모든 애플리케이션 사용자 인증 정보를 수락하고 curl 명령어를 사용하여 Google Cloud API를 호출하는 데 사용할 수 있습니다.

예:

oauth2l curl --credentials ./creds.json --scope cloud-platform --url https://pubsub.googleapis.com/v1/projects/my-project-id/topics -- -v

애플리케이션 빌드

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

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

추가 정보

결제에 대한 자세한 내용은 결제 계정 생성, 수정 또는 해지를 참조하세요.

프로젝트 청구 사용 설정에 대한 자세한 내용은 프로젝트의 청구 설정 수정을 참조하세요.

API 사용 설정 및 사용 중지에 대한 자세한 내용은 서비스 사용 설정 및 사용 중지를 참조하세요.