推播通知

總覽

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

這個 API 目前支援 7 種通知。

  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 填入使用者已支出的金額時。
  6. 帳戶加值:當系統填入 AccountInfo.accountTopUp 和 AccountInfo.accountBalance 時,這兩個欄位都必須填寫,才能傳送帳戶加值通知給使用者。如果「AccountInfo.accountTopUp」AccountInfo中的單位和奈米設定為零,通知就不會顯示加值金額。
  7. 資料到期:當 PlanModule.planModuleState 設為 EXPIRED 時。 適用於已過期的方案。

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

需求條件

PlanStatus 通知應盡可能包含使用者的行動方案資訊。針對每種通知類型,資料方案共用 API 也會定義一組最低欄位,這些欄位是建構通知文字時的必要條件。作業人員「必須」在通知 PlanStatus 中加入這些欄位。

通知 必填欄位
餘額偏低 PlanModule.moduleName、PlanModule.byteBalance.remainingBytes
數據流量不足 PlanModule.moduleName
資料到期警告 PlanModule.moduleName、PlanModule.expirationTime
啟用方案 PlanModule.moduleName
資料到期 PlanModule.moduleName