통합 가이드

비공개 키 가져오기

온보딩 인터페이스 사용

API와 통합하려면 Google Cloud 프로젝트를 만들어야 합니다. 그런 다음 서비스 계정을 만들고 비공개 키를 가져옵니다. 시작하려면 다음 버튼을 클릭합니다.

서비스 계정 만들기

수동 키 생성

위의 인터페이스가 실패하면 다음을 시도해 보세요.

  1. Google Cloud Console로 이동합니다.
  2. API에 액세스할 프로젝트를 선택합니다.
  3. 왼쪽의 IAM '관리' 메뉴에서 서비스 계정을 찾고 프로젝트 소유자가 될 새 서비스 계정을 만듭니다.
  4. 서비스 계정이 생성되면 비공개 키를 받게 됩니다.

허용 목록에 서비스 계정 추가

서비스 계정을 만든 후에는 다음을 수행합니다.

  1. 프로젝트 소유자인 Google 계정을 사용하여 GTAF팀(mdp-support@google.com)에 문의하세요. Google 계정을 허용 목록에 추가하여 모바일 데이터 요금제 공유 API 엔드포인트에 액세스합니다.
  2. Google ISP 포털에서 이동통신사와 서비스 계정을 연결합니다. 이동통신사는 API 액세스로 이동하여 연결할 수 있습니다.

라이브러리 사용 설정

허용 목록 추가가 완료되면 다음 안내를 따르세요.

  1. Google Cloud Console을 방문합니다.
  2. 상단 메뉴 바의 드롭다운에서 올바른 프로젝트를 선택했는지 확인합니다.
  3. API 라이브러리에서 모바일 데이터 요금제 공유 API를 사용 설정합니다.
  4. API 라이브러리에서 Preprod Mobile Data Plan Sharing API를 사용 설정합니다.

API 액세스 테스트

Google 측 메서드에 대한 액세스를 테스트하려면 다음 안내를 따르세요.

  1. oauth2l를 설치합니다.

  2. 다음과 같이 서비스 계정의 액세스 토큰을 가져옵니다. your-service-account-key-file.json은 서비스 계정의 키 파일입니다.

    > oauth2l fetch --json your-service-account-key-file.json dataplansharing

    액세스 토큰은 약 1시간 후에 만료됩니다. 새 액세스 토큰을 위해 위의 명령어를 다시 실행하기 전에 oauth2l reset을 실행하여 로컬 캐시를 지웁니다.

  3. 다음과 같이 테스트 호출을 실행합니다. YOUR-ASN는 통합 프로세스 중에 GTAF를 구성할 때 Google에 전송하는 ASN 중 하나여야 합니다. ACCESS-TOKEN-OBTAINED은 위 oauth2l fetch 명령어의 출력입니다. PLAN_STATUS는 GTAF에 전송하려는 PlanStatus 요청 본문입니다.

    > url_domain="mobiledataplansharing.googleapis.com"
> url_path="v1/operators/YOUR-ASN/clients/mobiledataplan/users/USER_KEY/planStatus"
> curl -H "Content-Type: application/json" \
       -d 'PLAN_STATUS' \
       -X POST "https://$url_domain/$url_path?access_token=ACCESS-TOKEN-OBTAINED"

프로그래매틱 API 호출

안내에 따라 다음 OAuth 범위를 사용하여 Google 측 메서드에 승인된 호출을 실행합니다.

https://www.googleapis.com/auth/dataplansharing

프로젝트 소유권 공유

초기 설정에는 단일 Google 계정이 포함되지만 승인된 사용자 그룹에 프로젝트 소유권을 부여하는 것이 좋습니다. Google Cloud Console의 IAM 및 관리자 메뉴에서 새 구성원 (Google 그룹 계정 포함)을 프로젝트 소유자로 추가할 수 있습니다.