시작하기

이 페이지에서는 Service Usage API를 사용하기 위한 개발 환경을 설정하는 방법을 설명합니다. 대부분의 운영 사례에서 서비스를 사용 설정하고 중지하는 가장 간단한 방법은 Google Cloud Platform Console을 사용하는 것입니다. 스크립트를 작성해야 하는 경우 gcloud 명령줄 인터페이스를 사용할 수 있습니다. Service Usage API와 달리 프로그래밍해야 하는 경우에는 제공된 클라이언트 라이브러리 중에 하나를 사용하는 것이 좋습니다. API를 실험하려면 이 가이드의 대체 설정 안내를 따르고 curl 명령어를 사용하여 전체 애플리케이션 개발 환경을 설정하지 않고 API를 테스트할 수 있습니다.

API를 직접 호출하도록 설정

이 섹션에서는 curl 명령어를 사용하여 Service Usage API를 실험하기 위한 로컬 환경을 설정하는 데 필요한 기본 단계를 설명합니다. 이는 Service Usage API와 달리 프로그래밍해야 하는 개발자를 대상으로 합니다.

Service Usage API 사용 설정

Service Usage API를 사용하려면 먼저 사용할 GCP 프로젝트에서 사용 설정해야 합니다.

  1. Google Cloud Platform Console API 라이브러리 페이지로 이동합니다.
    API 라이브러리 페이지로 이동
  2. 선택을 클릭하여 서비스에 액세스하는 데 사용할 GCP 프로젝트를 선택합니다.
  3. API 라이브러리 페이지에서 사용 설정을 클릭합니다.

서비스 계정 만들기

이 섹션에서는 curl 명령어를 실행할 서비스 계정과 키를 만듭니다.

  1. GCP Console 서비스 계정 페이지로 이동합니다.
    서비스 계정 페이지로 이동
  2. 선택을 클릭하여 서비스에 액세스하는 데 사용할 GCP 프로젝트를 선택합니다.
  3. 서비스 계정을 만듭니다. 서비스 계정을 만드는 방법을 알아보려면 서비스 계정 만들기 및 관리를 참조하세요. 이 섹션의 안내를 따르려면 서비스 계정에 roles/serviceusage.serviceUsageAdmin 역할을 부여해야 합니다. 서비스 계정에 역할을 부여하는 방법을 알아보려면 서비스 계정에 역할 부여를 참조하세요.
  4. GCP Console API 사용자 인증 정보 페이지로 이동합니다.
    API 사용자 인증 정보 페이지로 이동
  5. 새 서비스 계정의 서비스 계정 키를 만들고 해당 JSON 사용자 인증 정보 파일을 로컬 머신에 다운로드합니다. 이 가이드의 예에서는 파일 경로가 ~/credentials.json이라고 가정합니다. 서비스 계정 키를 만드는 방법을 알아보려면 서비스 계정 키 만들기 및 관리를 참조하세요.
  6. Google OAuth 시스템과 상호작용할 수 있도록 로컬 머신에 oauth2l을 설치합니다.

curl로 테스트

  1. 먼저 초기 설정을 확인합니다.

    oauth2l header --json ~/credentials.json cloud-platform
    
  2. OAuth 흐름을 완료하면 다음과 같은 출력이 표시됩니다.

    Authorization: Bearer y29.xxxxxxx
    
  3. Google REST API를 호출하기 위한 간편한 셸 별칭을 정의합니다.

    alias gcurl='curl -H "$(oauth2l header --json ~/credentials.json cloud-platform userinfo.email)" -H "Content-Type: application/json"'
    
  4. 프로젝트에서 사용 가능하고 사용 설정된 API 및 서비스를 나열합니다.

    gcurl https://serviceusage.googleapis.com/v1/projects/357084163378/services
    

    서비스 목록이 보이면 설정에 성공한 것입니다.

다음 단계

서비스 사용 설정 및 중지를 따라 GCP 프로젝트에서 서비스 사용 설정 또는 사용 중지