概要
Google Mobile Data Plan Sharing API を使用すると、オペレーターは PlanStatus をプッシュしてユーザーに通知を送信することもできます。
この API は現在、7 種類の通知をサポートしています。
- 低残高: PlanModule.coarseBalanceLevel が LOW_QUOTA に設定されている場合
- データ外: PlanModule.coarseBalanceLevel が OUT_OF_DATA に設定されている場合。さらに、PlanModule.overUsagePolicy が PAY_AS_YOU_GO に設定されている場合は、従量課金制に移行しようとしていることがユーザーに通知されます。
- Data Expiration Warning: PlanModule.planModuleState が EXPIRING_SOON に設定されている場合
- Plan Activation: PlanModule.planModuleState が NEWLY_ACTIVE に設定されている場合
- 従量課金制: AccountInfo.payAsYouGoCharge にユーザーが使った金額が表示される場合の従量課金制。
- アカウントのチャージ: AccountInfo.accountTopUp と AccountInfo.accountBalance が入力されたときアカウントの切り替え情報をユーザーに送信するには、これらのフィールドの両方が必要です。AccountInfo.accountTopUp の単位とナノがゼロに設定されている場合、チャージ金額は通知に含まれません。
- データの有効期限: PlanModule.planModuleState が EXPIRED に設定されている場合。 すでに有効期限が切れているプランが対象です。
項目セットごとに 1 つの通知がユーザーに送信されます。1 つの PlanStatus に複数の coarseBalanceLevel フィールドまたは planModuleState フィールドが設定されている場合、ユーザーに同じ数の通知が送信されます。
要件
通知 PlanStatus は、ユーザーのモバイルプランについて可能な限り多くの情報を含むべきです。Data Plan Sharing API は通知のタイプごとに、通知テキストの作成に必要な最小限のフィールド セットも定義します。オペレーターは、これらのフィールドを通知 PlanStatus に含める必要があります。
| 通知 | 必須フィールド |
|---|---|
| 残高不足 | PlanModule.moduleName、PlanModule.byteBalance.remainingBytes |
| データ不足 | PlanModule.moduleName |
| データの有効期限に関する警告 | PlanModule.moduleName、PlanModule.expirationTime |
| プランの有効化 | PlanModule.moduleName |
| データの有効期限 | PlanModule.moduleName |