Data Plan Agent API
2019 年 12 月
- DPA が実装するための register CPID API 定義を導入しました。
- CPID を生成して、クライアントが新しい CPID をリクエストしたときに保存する方法に関する提案を追加しました。
- 通知の送信に使用する CPID の選択方法に関するドキュメントを追加しました。
- GTAF が DPA を呼び出したときと DPA が GTAF を呼び出したときのユーザー言語設定を決定する方法を明確にしました。
2019 年 10 月
- Google から CPID エンドポイントに連絡するたびに新しい CPID が必要です。これは、CPID 生成アルゴリズムにタイムスタンプを追加することで実現できます。
- [特典] の [planLanguage] を削除します。これまでは、このフィールドは必須フィールドとしてマークされていました。
2019 年 9 月
- データ有効期限警告と区別して、データ有効期限通知のサポートを追加しました。
2019 年 7 月
- 可能性のあるクライアント識別子の値を明確にしました。
- アカウントのチャージ通知のサポートを追加しました。
- CPID エンドポイントが呼び出されるたびに新しい CPID を要求する必要がなくなった。
- Mobile Data Plan Sharing API を呼び出すときの GTAF からのさまざまなエラー レスポンスについて、ドキュメントを追加しました。
2019 年 6 月
- 携帯通信会社がクエリ パラメータとして _clientid を受け入れることを要件とする DPA API 仕様を更新しました。
- Mobile Data Plan Sharing API を更新し、携帯通信会社は特定のクライアントのユーザーのプラン情報を Google と共有できるようになりました。
- ユーザーに特典を表示する順序は、GTAF に提示される順序と異なる場合があります。
- GTAF は、モバイルデータ プランの UI を使用して 10 を超えるプランを共有できます。
2019 年 5 月
- プランが期限切れでない限り、有効期限が必要です。
- RFC 6749 に従って、OAuth サーバー レスポンスで token_type を必須としてマークします。
- 携帯通信会社がプランのステータスを GTAF に push したときにユーザーに送信された通知の種類を返します。
2019 年 4 月
- 前払いの定期購入者には AccountInfo が必要です。
- 推奨される CPID 生成方法を更新して、CPID を生成するときに書式なしテキストに言語を含めます。
- とオファーから、moreInfoUrl、operatorLogoUrl、purchaseUrl のサポートを削除しました。これらのフィールドは、モバイルデータ プランの UI ではサポートされていませんでした。この変更には下位互換性があります。
- ユーザーが従量課金制のデータを使用してアカウント残高を消費したときに通知を送信するサポートを追加しました。
- プラン モジュールでのフレックス タイム ウィンドウのサポートを削除しました。この変更には下位互換性があります。したがって、オペレーターがフレックス タイム ウィンドウを送信している場合、レスポンスは受け入れられます。
2019 年 3 月
- 一連の必須フィールドから offerInfo.promoMessage を削除します。MDP は、ユーザーに特典を提示する際にこのフィールドを使用しません。
- CPID を URL エンコードする必要があることを示すドキュメントのバグを修正しました。代わりに、GTAF は RFC2396 に沿って CPID をエンコードします。
- プッシュ通知の要件を追加しました。
2019 年 2 月
- データプラン共有 API を使用して PlanOffers を Google と共有するためのサポートを削除しました。
2019 年 1 月
- ISP ポータルを使用して携帯通信会社の設定を更新するためのガイドを追加しました。
- Data Plan Agent API 向けの OAuth 実装に関するガイドを追加しました。
- Mobile Data Plan Sharing API 統合ガイドの名前を変更し、再編成しました。
2018 年 11 月
- プランの有効化の通知のサポートを追加しました。
- APP_STORE プラン モジュールのトラフィック カテゴリのサポートを追加しました。
2018 年 9 月
- ユーザーの同意をオペレーターにレポートするための API を追加しました。
- PlanModule と Offer に割り当てを定期的に更新するプランのサポートが追加されました。
- 有効期限通知のサポートを追加しました。
- PlanModuleState の名前が PlanState に変更されました。これはドキュメントの変更であり、演算子には影響しません。
2018 年 8 月
- 携帯通信会社が PlanStatus の一部として口座残高を指定する機能を追加しました。
2018 年 6 月
- 更新を削除し、プランのステータスと特典のメソッドを取得しました。
- バイトバランスまたはタイムバランスが入力されたときに、粗調整のレベルが入力されるようになりました。
- 接続に接続タイプを追加しました。
- PlanModule state フィールドが PlanModule に追加され、オペレーターは、ユーザーが購入したもののまだ有効になっていないプランを示すことができるようになりました。これは必須項目ではありません。
- DataPlan の名前が Plan に変更されました。これはドキュメントの変更であり、演算子には影響しません。
- PlanOfPayment フィールドが PlanOffer に追加され、オペレーターは、購入に対するユーザーの請求方法を指定できるようになりました。デフォルトでは、プラン残高から差し引かれます。
2018 年 5 月
- レスポンスの下位互換性を維持するため、CPID レスポンスを更新しました。
- PlanStatus のタイトルを追加しました。タイトルは、設定 UI のヘッダーで使用されます。
- PlanModule のモジュール名と使用バイト数を追加しました。
- GTAF への購入レスポンスのコールバックを追加しました。
2018 年 3 月
このアップデートには、Data Plan Agent API の次の変更が含まれています。この変更は、こちらでホストされている Data Plan API v4.2 に対する変更です。
- 次の API 呼び出しのサポートが終了しました。
- ユーザー アカウントのクエリ（DPA_URL/{data_plan_key_string}/account）
- 購入したプランのクエリ（DPA_URL/{data_plan_key_string}/purchasedPlans）。
- データプランのステータスを要求する URL を変更します。新しい URL については、こちらをご覧ください。DPA は、PlanStatus のインスタンスを返すことが想定されています。
- プランの特典の呼び出しに使用する URL を変更します。新しい URL については、こちらをご覧ください。DPA は、PlanOffer のインスタンスを返す必要があります。
- プランの購入時に DPA に送信されるリクエストの本文を変更します。API 呼び出しは同じです。リクエストの本文に TransactionRequest のインスタンスが追加されました。以前のバージョンの API と比較して、ネストのレベルは削除されています。
- 購入リクエストに対するレスポンスが変更されました。Google protobuf で定義された通貨タイプを利用します。購入が正常に完了すると、Google はレスポンスの本文に TransactionResponse のインスタンスが含まれることを想定します。
plan_idが指定されていない場合、対象 API は、ユーザーが対象となるすべてのデータプランを返さなければなりません。これまでは省略可能でした。- GTAF に MSISDN 登録エンドポイントを追加して、DPA に通知用の MSISDN を登録します。
Google Mobile Data Plan Sharing API
2018 年 3 月
このアップデートには、Google Mobile Data Plan Sharing API の次の変更が含まれています。
- オペレーターがアップセルの特典情報を GTAF にプッシュし、ユーザー デバイスにプッシュする新しい API 呼び出しを導入しました。これらの新しい呼び出しにより、オペレーターはオファーを Google に push できます。
- 最終更新日時が PlanGroup に追加されました。
- フレックス タイム ウィンドウからデータ クレジット率フィールドを削除します。