推送通知

概览

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

该 API 目前支持 7 类通知。

  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 中填充用户消费的金额时。
  6. 帐号充值:填充了 AccountInfo.accountTopUp 和 AccountInfo.accountBalance 时。必须填写这两个字段才能向用户发送帐号充值通知。如果 AccountInfo.accountTopUp 中的单位数和纳米值都设置为零,则充值金额不在通知中。
  7. 数据到期时间:当 PlanModule.planModuleState 设置为 EXPIRED 时。这适用于已过期的方案。

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

要求

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

通知 必填字段
余额不足 PlanModule.moduleName、PlanModule.byteBalance.remainingBytes
数据不足 PlanModule.moduleName
数据到期警告 PlanModule.moduleName、PlanModule.expirationTime
激活方案 PlanModule.moduleName
数据有效期 PlanModule.moduleName