概要
Google Mobile Data Plan Sharing API を使用すると、通信事業者は PlanStatus をプッシュしてユーザーに通知を送信することもできます。
この API は現在、次の通知をサポートしています。
- Low Balance: PlanModule.coarseBalanceLevel が LOW_QUOTA に設定されている場合
- Out of Data: PlanModule.coarseBalanceLevel が OUT_OF_DATA に設定されている場合。これに加えて、PlanModule.overUsagePolicy が PAY_AS_YOU_GO に設定されている場合、ユーザーには従量課金モードに移行しようとしていることが通知されます。
- Data Expiration Warning: PlanModule.planModuleState が EXPIRING_SOON に設定されている場合
- プランの有効化: PlanModule.planModuleState が NEWLY_ACTIVE に設定されている場合
- 従量課金: AccountInfo.payAsYouGoCharge にユーザーが使用した金額が入力されている場合。accountBalance が設定されている場合、通知にはアカウントの残高が表示されます。
- アカウントのチャージ: AccountInfo.accountTopUp と AccountInfo.accountBalance が入力されている場合。ユーザーにアカウントのチャージ通知を送信するには、両方のフィールドが必要です。AccountInfo.accountTopUp の単位とナノがゼロに設定されている場合、チャージ額は通知に含まれません。
- データ有効期限: PlanModule.planModuleState が EXPIRED に設定されている場合。これは、すでに期限切れのプランを対象としています。
フィールド セットごとに 1 つの通知がユーザーに送信されます。1 つの PlanStatus に複数の coarseBalanceLevel フィールドまたは planModuleState フィールドが設定されている場合、同じ数の通知がユーザーに送信されます。
通知をトリガーするプランのステータスがユーザーのデバイスに送信され、デバイス上のキャッシュが更新されます。これにより、ユーザーが通知をクリックしたときに最近のプランのステータスが表示されるため、ユーザー エクスペリエンスが向上します。通知の送信に使用されるプランのステータスが完了しておらず、ユーザーに表示すべきでない場合、携帯通信会社は UiCompatibility を UI_INCOMPATIBLE に設定しなければなりません。
要件
通知 PlanStatus には、ユーザーのモバイル プランに関する情報をできるだけ多く含めるべきです。データプラン共有 API は、通知の種類ごとに、通知テキストの作成に必要な最小限のフィールドも定義します。オペレーターは、これらのフィールドを通知 PlanStatus に含めなければなりません。
| 通知 | 必須フィールド |
|---|---|
| 残高不足 | PlanModule.moduleName、PlanModule.byteBalance.remainingBytes |
| Out of Data | PlanModule.moduleName |
| データ有効期限の警告 | PlanModule.moduleName、PlanModule.expirationTime |
| プランの有効化 | PlanModule.moduleName |
| 従量課金制 | AccountInfo.payAsYouGoCharge |
| アカウントのチャージ | AccountInfo.accountTopUp |
| データの有効期限 | PlanModule.moduleName |