통합 가이드

비공개 키 가져오기

온보딩 인터페이스 사용

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

서비스 계정 만들기

수동으로 키 생성

위 인터페이스가 작동하지 않으면 다음을 시도해 보세요.

  1. Google Cloud 콘솔로 이동합니다.
  2. API에 액세스하는 데 사용할 프로젝트를 선택합니다.
  3. 왼쪽의 IAM 및 관리자 메뉴에서 서비스 계정을 찾아 프로젝트의 소유자가 될 새 서비스 계정을 만듭니다.
  4. 서비스 계정이 생성되면 비공개 키가 제공됩니다.

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

서비스 계정을 만든 후 다음 단계를 따르세요.

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

라이브러리 사용 설정

허용 목록이 작성되면 다음 단계를 따르세요.

  1. Google Cloud Console을 방문합니다.
  2. 상단 메뉴 바의 드롭다운에서 올바른 프로젝트를 선택했는지 확인합니다.
  3. API 라이브러리에서 Mobile Data Plan Sharing 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는 통합 프로세스 중에 Google에서 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 콘솔의 IAM 및 관리자 메뉴에서 프로젝트 소유자가 될 새 구성원 (Google 그룹 계정 포함)을 추가할 수 있습니다.