推播通知

總覽

電信業者也可以透過 Google Mobile Data Plan Sharing API,推送 PlanStatus,向使用者傳送通知。

這個 API 目前支援下列通知:

  1. 餘額偏低:當 PlanModule.coarseBalanceLevel 設為 LOW_QUOTA
  2. 沒有資料:當 PlanModule.coarseBalanceLevel 設為 OUT_OF_DATA 時。 此外,如果 PlanModule.overUsagePolicy 設為 PAY_AS_YOU_GO,系統會通知使用者即將進入隨用隨付模式。
  3. 資料到期警告:當 PlanModule.planModuleState 設為 EXPIRING_SOON
  4. 啟用方案:當 PlanModule.planModuleState 設為 NEWLY_ACTIVE
  5. 隨用隨付:當 AccountInfo.payAsYouGoCharge 填入使用者已支出的金額時,如果系統填入 accountBalance,通知就會顯示帳戶的剩餘餘額。
  6. 帳戶加值:當系統填入 AccountInfo.accountTopUp 和 AccountInfo.accountBalance 時。這兩個欄位都必須填寫,才能傳送帳戶加值通知給使用者。如果「AccountInfo」AccountInfo.accountTopUp 中的單位和奈米單位設為零,通知就不會包含加值金額。
  7. 資料到期:當 PlanModule.planModuleState 設為 EXPIRED 時。 適用於已過期的方案。

系統會針對每個欄位集傳送一則通知給使用者。如果單一 PlanStatus 中設定了多個 coarseBalanceLevelplanModuleState 欄位,系統會傳送相同數量的通知給使用者。

系統會將觸發通知的方案狀態傳送至使用者裝置,更新裝置上的快取。使用者點選通知時,系統會顯示最近的方案狀態,藉此提升使用者體驗。如果用於傳送通知的方案狀態不完整,且不應向使用者顯示,則電信業者「必須」將 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