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