總覽
電信業者也可以透過 Google Mobile Data Plan Sharing API,推送 PlanStatus,向使用者傳送通知。
這個 API 目前支援 7 種通知。
- 餘額偏低:當 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 填入使用者已支出的金額時。
- 帳戶加值:當系統填入 AccountInfo.accountTopUp 和 AccountInfo.accountBalance 時,這兩個欄位都必須填寫,才能傳送帳戶加值通知給使用者。如果「AccountInfo.accountTopUp」AccountInfo中的單位和奈米設定為零,通知就不會顯示加值金額。
- 資料到期:當 PlanModule.planModuleState 設為 EXPIRED 時。 適用於已過期的方案。
系統會針對每個欄位集傳送一則通知給使用者。如果單一 PlanStatus
中設定了多個 coarseBalanceLevel
或 planModuleState
欄位,系統會傳送相同數量的通知給使用者。
需求條件
PlanStatus 通知應盡可能包含使用者的行動方案資訊。針對每種通知類型,資料方案共用 API 也會定義一組最低欄位,這些欄位是建構通知文字時的必要條件。作業人員「必須」在通知 PlanStatus 中加入這些欄位。
通知 | 必填欄位 |
---|---|
餘額偏低 | PlanModule.moduleName、PlanModule.byteBalance.remainingBytes |
數據流量不足 | PlanModule.moduleName |
資料到期警告 | PlanModule.moduleName、PlanModule.expirationTime |
啟用方案 | PlanModule.moduleName |
資料到期 | PlanModule.moduleName |