統合ガイド

秘密鍵を取得する

オンボーディング インターフェースの使用

API と統合するには、Google Cloud プロジェクトを作成する必要があります。その後、サービス アカウントを作成して秘密鍵を取得します。開始するには、次のボタンをクリックします。

サービス アカウントを作成する

鍵の手動生成

上記のインターフェースが機能しない場合は、次の手順をお試しください。

  1. Google Cloud コンソールに移動します。
  2. API へのアクセスに使用するプロジェクトを選択します。
  3. 左側の [IAM と管理] メニューでサービス アカウントを見つけ、プロジェクトのオーナーとなる新しいサービス アカウントを作成します。
  4. サービス アカウントを作成すると、秘密鍵が届きます。

サービス アカウントをホワイトリストに登録する

サービス アカウントを作成したら:

  1. プロジェクトのオーナーである Google アカウントを使用して、GTAF チーム（mdp-support@google.com）にお問い合わせください。Mobile Data Plan Sharing API エンドポイントにアクセスできるように、Google アカウントをホワイトリストに登録します。
  2. Google ISP ポータルでサービス アカウントを携帯通信会社に関連付けます。携帯通信会社は、[API Access] に移動してこの関連付けを行うことができます。

ライブラリを有効にする

ホワイトリスト登録が完了したら:

  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 は、統合プロセス中に 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 グループ アカウントを含む）をプロジェクトのオーナーとして追加できます。