概览
借助 Google 移动流量套餐共享 API,运营商还可以通过推送 PlanStatus 向用户发送通知。
该 API 目前支持 7 类通知。
- 低余额:当 PlanModule.coarseBalanceLevel 设置为 LOW_QUOTA 时
- 数据不足:当 PlanModule.coarseBalanceLevel 设置为 OUT_OF_DATA 时。 此外,如果 PlanModule.overUsagePolicy 设置为 PAY_AS_YOU_GO,系统会通知用户他们即将进入随用随付模式。
- 数据到期时间警告:当 PlanModule.planModuleState 设置为 EXPIRING_SOON 时
- Plan Activation:当 PlanModule.planModuleState 设为 NEWLY_ACTIVE 时
- 随用随付:在 AccountInfo.payAsYouGoCharge 中填充用户消费的金额时。
- 帐号充值:填充了 AccountInfo.accountTopUp 和 AccountInfo.accountBalance 时。必须填写这两个字段才能向用户发送帐号充值通知。如果 AccountInfo.accountTopUp 中的单位数和纳米值都设置为零,则充值金额不在通知中。
- 数据到期时间:当 PlanModule.planModuleState 设置为 EXPIRED 时。这适用于已过期的方案。
系统会针对每个字段集向用户发送一条通知。如果在一个 PlanStatus
中设置了多个 coarseBalanceLevel
或 planModuleState
字段,系统会向用户发送相同数量的通知。
要求
通知 PlanStatus 应尽可能多地包含有关用户移动套餐的信息。对于每种类型的通知,Data Plan Sharing API 还定义了构建通知文本所需的最小字段集。运营商必须在通知 PlanStatus 中包含这些字段。
通知 | 必填字段 |
---|---|
余额不足 | PlanModule.moduleName、PlanModule.byteBalance.remainingBytes |
数据不足 | PlanModule.moduleName |
数据到期警告 | PlanModule.moduleName、PlanModule.expirationTime |
激活方案 | PlanModule.moduleName |
数据有效期 | PlanModule.moduleName |