推送通知

概览

借助 Google 移动流量套餐共享 API,运营商还可以通过推送 PlanStatus 向用户发送通知。

该 API 目前支持以下通知:

  1. 低余额:当 PlanModule.coarseBalanceLevel 设置为 LOW_QUOTA
  2. 数据不足:当 PlanModule.coarseBalanceLevel 设置为 OUT_OF_DATA 时。 此外,如果 PlanModule.overUsagePolicy 设置为 PAY_AS_YOU_GO,系统会通知用户他们即将进入随用随付模式。
  3. 数据到期时间警告:当 PlanModule.planModuleState 设置为 EXPIRING_SOON
  4. Plan Activation:当 PlanModule.planModuleState 设为 NEWLY_ACTIVE
  5. 随用随付:在 AccountInfo.payAsYouGoCharge 中填充用户消费的金额时。如果已填充 accountBalance,则通知会显示帐号的剩余余额。
  6. 帐号充值:填充了 AccountInfo.accountTopUp 和 AccountInfo.accountBalance 时。必须填写这两个字段才能向用户发送帐号充值通知。如果 AccountInfo.accountTopUp 中的单位数和纳米值均设置为零,则通知中不包含充值金额。
  7. 数据到期时间:当 PlanModule.planModuleState 设置为 EXPIRED 时。这适用于已过期的方案。

系统会针对每个字段集向用户发送一条通知。如果在一个 PlanStatus 中设置了多个 coarseBalanceLevelplanModuleState 字段,系统会向用户发送相同数量的通知。

触发通知的方案状态会发送到用户设备以更新设备缓存。这会在用户点击通知时显示最近的方案状态,从而改善用户体验。如果用于发送通知的计划状态不完整,不应向用户显示,则运营商必须将 UiCompatibility 设置为 UI_INCOMPATIBLE

要求

通知 PlanStatus 应尽可能多地包含有关用户移动套餐的信息。对于每种类型的通知,Data Plan Sharing API 还定义了构建通知文本所需的最小字段集。运营商必须在通知 PlanStatus 中包含这些字段。

通知 必填字段
余额不足 PlanModule.moduleName、PlanModule.byteBalance.remainingBytes
数据不足 PlanModule.moduleName
数据到期警告 PlanModule.moduleName、PlanModule.expirationTime
激活方案 PlanModule.moduleName
随用随付 AccountInfo.payAsYouGoCharge
帐号充值 AccountInfo.accountTopUp
数据有效期 PlanModule.moduleName