推播通知

總覽

Google Mobile Data Plan Shared API 也可讓業者透過傳送 PlanStatus 來傳送通知給使用者。

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

  1. 餘額偏低:當 PlanModule.coarseBalanceLevel 設為 LOW_TRIAL
  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.accountTopUp 中的單元和 nanos 已設為零,則通知中不會列出儲值金額。
  7. 資料到期時間:當 PlanModule.planModuleState 設為 EXPIRED 時。 這適用於到期的方案。

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

觸發通知的方案狀態會傳送至使用者裝置,以更新裝置快取。使用者點按通知時,會顯示近期企劃書狀態,藉此提升使用者體驗。如果用於傳送通知的方案狀態不完整,不應向使用者顯示,那麼電信業者「必須」將 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