시작하기

이 페이지에서는 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. 선택을 클릭하여 서비스에 액세스하는 데 사용하려는 Cloud 프로젝트를 선택합니다.
  3. API 라이브러리 페이지에서 사용 설정을 클릭합니다.

서비스 계정 만들기

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

  1. Cloud Console 서비스 계정 페이지로 이동합니다.
    서비스 계정 페이지로 이동
  2. 선택을 클릭하여 서비스에 액세스하는 데 사용하려는 Cloud 프로젝트를 선택합니다.
  3. 서비스 계정 만들기 서비스 계정을 만드는 방법을 알아보려면 서비스 계정 만들기 및 관리를 참조하세요. 이 섹션의 안내를 따르려면 서비스 계정에 roles/serviceusage.serviceUsageAdmin 역할을 부여해야 합니다. 서비스 계정에 역할을 부여하는 방법을 알아보려면 서비스 계정에 역할 부여를 참조하세요.
  4. Cloud 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
    

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

다음 단계

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