このページは Cloud Translation API によって翻訳されました。

統合ガイド

秘密鍵の取得

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

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

サービスアカウントの作成

手動での鍵の生成

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

Google Cloud Console に移動します。
API へのアクセスに使用するプロジェクトを選択します。
左側の [IAM と管理] メニューで、サービスアカウントを見つけて、プロジェクトのオーナーになる新しいサービスアカウントを作成します。
サービスアカウントが作成されると、秘密鍵を受け取ります。

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

サービスアカウントを作成したら、次の手順を行います。

プロジェクトのオーナーである Google アカウントを使って、GTAF チーム（mdp-support@google.com）に連絡します。Mobile Data Plan Sharing API エンドポイントにアクセスするために、Google アカウントをホワイトリストに登録します。
Google ISP Portal でサービスアカウントを携帯通信会社に関連付けます。携帯通信会社は、API アクセスに移動してこの関連付けを行うことができます。

ライブラリを有効にする

許可リスト登録が完了したら、次の手順を行います。

Google Cloud Console にアクセスします。
上部のメニューバーのプルダウンで、正しいプロジェクトが選択されていることを確認します。
API ライブラリで Mobile Data Plan Sharing API を有効にします。
API ライブラリで Preprod Mobile Data Plan Sharing API を有効にします。

API アクセスのテスト

Google 側のメソッドへのアクセスをテストするには:

oauth2l をインストールします。
次のように、サービスアカウントのアクセストークンを取得します。your-service-account-key-file.json は、サービスアカウントのキーファイルです。
```
> oauth2l fetch --json your-service-account-key-file.json dataplansharing
```
アクセストークンは約 1 時間で期限切れになります。新しいアクセストークンで上記のコマンドを再度実行する前に、oauth2l reset を実行してローカルキャッシュを消去します。
次のようにテスト呼び出しを実行します。YOUR-ASN は、統合プロセス中に GTAF を構成したときに送信された 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 呼び出し

手順に沿って、Google 側のメソッドに対して承認済みの呼び出しを行います。その際、次の OAuth スコープを使用します。

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

プロジェクトの所有権を共有する

初期設定では 1 つの Google アカウントを使用しますが、承認済みユーザーのグループがプロジェクトの所有権を持つことをおすすめします。Google Cloud Console の [IAM と管理] メニューで、新しいメンバー（Google グループアカウントを含む）をプロジェクトのオーナーとして追加できます。