總覽
Google Mobile Data Plan Shared API 也可讓業者透過傳送 PlanStatus 來傳送通知給使用者。
這個 API 目前支援下列通知:
- 餘額偏低:當 PlanModule.coarseBalanceLevel 設為 LOW_TRIAL 時
- 資料用盡:當 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 中的單元和 nanos 已設為零,則通知中不會列出儲值金額。
- 資料到期時間:當 PlanModule.planModuleState 設為 EXPIRED 時。 這適用於到期的方案。
系統會針對各個欄位集向使用者傳送通知。如果在單一 PlanStatus
中設定多個 coarseBalanceLevel
或 planModuleState
欄位,系統會向使用者傳送相同數量的通知。
觸發通知的方案狀態會傳送至使用者裝置,以更新裝置快取。使用者點按通知時,會顯示近期企劃書狀態,藉此提升使用者體驗。如果用於傳送通知的方案狀態不完整,不應向使用者顯示,那麼電信業者「必須」將 UiCompatibility 設為 UI_INCOMPATIBLE
。
相關規定
通知 PlanStatus 應盡可能包含關於使用者行動方案的資訊,針對每種通知類型,Data Plan Shared API 也會定義建構通知文字所需的最低一組欄位。運算子「必須」在通知 PlanStatus 中加入這些欄位。
通知 | 必填欄位 |
---|---|
餘額偏低 | PlanModule.moduleName、PlanModule.bytesBalance.remainingBytes |
資料不足 | PlanModule.moduleName |
資料到期警告 | PlanModule.moduleName、PlanModule.expirationTime |
計劃啟用 | PlanModule.moduleName |
用多少付多少 | AccountInfo.payAsYouGoCharge |
帳戶儲值 | AccountInfo.accountTopUp |
資料有效期限 | PlanModule.moduleName |