總覽
Google Mobile Data Plan Shared API 也可讓業者透過傳送 PlanStatus 來傳送通知給使用者。
API 目前支援 7 種通知。
- 餘額偏低：當 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 中填入使用者消費的金額。
- 帳戶儲值：填入 AccountInfo.accountTopUp 和 AccountInfo.accountBalance 時。這兩個欄位皆為必填欄位，才能傳送帳戶儲值通知給使用者。如果 AccountInfo.accountTopUp 中的單元和 nanos 設為 0，則儲值金額不包含在通知中。
- 資料到期時間：當 PlanModule.planModuleState 設為 EXPIRED 時。 這適用於到期的方案。
系統會針對各個欄位集向使用者傳送通知。如果在單一 PlanStatus 中設定多個 coarseBalanceLevel 或 planModuleState 欄位，系統會向使用者傳送相同數量的通知。
相關規定
通知 PlanStatus 應盡可能包含關於使用者行動方案的資訊，針對每種通知類型，Data Plan Shared API 也會定義建構通知文字所需的最低一組欄位。運算子「必須」在通知 PlanStatus 中加入這些欄位。
| 通知 | 必填欄位 |
|---|---|
| 餘額偏低 | PlanModule.moduleName、PlanModule.bytesBalance.remainingBytes |
| 資料不足 | PlanModule.moduleName |
| 資料到期警告 | PlanModule.moduleName、PlanModule.expirationTime |
| 計劃啟用 | PlanModule.moduleName |
| 資料有效期限 | PlanModule.moduleName |