概览
Google Mobile Data Plan Sharing API 还允许运营商通过推送 PlanStatus 向用户发送通知。
该 API 目前支持以下通知：
- 余额偏低：当 PlanModule.coarseBalanceLevel 设置为 LOW_QUOTA 时
- 流量不足：当 PlanModule.coarseBalanceLevel 设置为 OUT_OF_DATA 时。 如果除了上述情况之外，PlanModule.overUsagePolicy 还设置为 PAY_AS_YOU_GO，那么系统会通知用户他们即将进入随用随付模式。
- 数据过期警告：当 PlanModule.planModuleState 设置为 EXPIRING_SOON 时
- 方案激活：当 PlanModule.planModuleState 设置为 NEWLY_ACTIVE 时
- 按用量付费：当 AccountInfo.payAsYouGoCharge 中填充了用户已支出的金额时。如果填充了 accountBalance，则通知会显示账号中的剩余余额。
- 账号充值：当 AccountInfo.accountTopUp 和 AccountInfo.accountBalance 已填充时。这两个字段都是必需字段，用于向用户发送账号充值通知。如果 AccountInfo.accountTopUp 中的单位和纳诺设置为零，则通知中不包含充值金额。
- 数据过期：当 PlanModule.planModuleState 设置为 EXPIRED 时。 适用于已过期的方案。
系统会针对每个字段集向用户发送一条通知。如果单个 PlanStatus 中设置了多个 coarseBalanceLevel 或 planModuleState 字段，系统将向用户发送相同数量的通知。
触发通知的方案状态会发送到用户设备，以更新设备上的缓存。这样一来，当用户点击通知时，系统会显示最近的方案状态，从而改善用户体验。如果用于发送通知的方案状态不完整且不应向用户显示，则运营商必须将 UiCompatibility 设置为 UI_INCOMPATIBLE。
要求
PlanStatus 通知应包含尽可能多的用户移动流量套餐信息。对于每种类型的通知，数据流量方案共享 API 还定义了构建通知文本所需的最少字段集。运营商必须在 PlanStatus 通知中包含这些字段。
| 通知 | 必填字段 |
|---|---|
| 余额不足 | PlanModule.moduleName, PlanModule.byteBalance.remainingBytes |
| 数据流量不足 | PlanModule.moduleName |
| 数据到期警告 | PlanModule.moduleName、PlanModule.expirationTime |
| 方案激活 | PlanModule.moduleName |
| 随用随付 | AccountInfo.payAsYouGoCharge |
| 账号充值 | AccountInfo.accountTopUp |
| 数据过期 | PlanModule.moduleName |