시작하기

이 페이지에서는 Service Usage API를 사용하기 위한 개발 환경을 설정하는 방법에 대해 설명합니다.

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

API를 직접 호출하도록 설정

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

Service Usage API 사용 설정

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

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

승인 구성

Service Usage API가 Cloud 프로젝트에 액세스하도록 승인하려면 다음을 수행합니다.

  1. 서비스 계정을 만듭니다.
    1. Cloud Console 서비스 계정 페이지로 이동합니다.
      서비스 계정 페이지로 이동
    2. 서비스에 액세스하는 데 사용할 클라우드 프로젝트를 선택합니다.
    3. 서비스 계정을 만듭니다. 서비스 계정을 만드는 방법을 알아보려면 서비스 계정 만들기 및 관리를 참조하세요.
  2. 새 서비스 계정에 서비스 사용량 관리자 역할을 부여합니다. 서비스 계정에 역할을 부여하는 방법을 알아보려면 서비스 계정에 역할 부여를 참조하세요.
  3. 로컬 머신을 구성합니다.

    1. Cloud Console API 사용자 인증 정보 페이지로 이동합니다.
      API 사용자 인증 정보 페이지로 이동
    2. 새 서비스 계정의 서비스 계정 키를 만들고 해당 JSON 사용자 인증 정보 파일을 로컬 머신에 다운로드합니다. 이 가이드의 예시에서는 파일 경로를 ~/credentials.json이라고 가정합니다. 서비스 계정 키를 만드는 방법을 알아보려면 서비스 계정 키 만들기 및 관리를 참조하세요.
    3. Google OAuth 시스템과 상호작용할 수 있도록 로컬 머신에 oauth2l을 설치합니다.
    4. 필요할 경우 oauth2l을 사용하여 사용자 인증 정보 파일로 Bearer 토큰을 만듭니다. 이를 통해 OAuth 설정이 올바르고 서비스 계정 사용자 인증 정보 파일이 유효한지 확인합니다.

          oauth2l header --json ~/credentials.json cloud-platform userinfo.email
      

      성공하면 출력은 다음과 비슷합니다.

          Authorization: Bearer y29.xxxxxxx
      

curl로 테스트

  1. Google REST API를 호출하기 위한 간편한 셸 별칭을 정의합니다.

    alias gcurl='curl -H "$(oauth2l header --json ~/credentials.json cloud-platform userinfo.email)" -H "Content-Type: application/json"'
    
  2. 프로젝트 식별자로 PROJECT_ID 환경 변수를 설정합니다.

    PROJECT_ID="my-project-id"
    
  3. 'gcloud'에 로그인되어 있는지 확인합니다.

    gcloud auth login
    
  4. gcloud를 사용하여 프로젝트의 프로젝트 번호를 찾고 환경 변수에 프로젝트 번호를 저장합니다.

    PROJECT_NUMBER=`gcloud projects list --filter="${PROJECT_ID}" --format="value(PROJECT_NUMBER)"`
    
  5. 이 프로젝트에서 사용 설정된 API 및 서비스를 나열합니다.

    gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services?filter=state:ENABLED&fields=services.config.title,services.config.name"
    

    다음과 같은 출력이 표시되면 설정에 성공한 것입니다.

    {
    "services": [
      {
        "config": {
          "name": "bigquery.googleapis.com",
          "title": "BigQuery API"
        }
      },
      {
        "config": {
          "name": "bigquerystorage.googleapis.com",
          "title": "BigQuery Storage API"
        }
      },
      ...
    

다음 단계

서비스 나열에 따라 클라우드 프로젝트에서 사용 설정되거나 사용 가능한 API 및 서비스를 나열합니다.