Panoramica
L'API Google Mobile Data Plan Sharing consente inoltre a un operatore di inviare notifiche a un utente tramite push di un PlanStatus.
L'API supporta attualmente 7 tipi di notifiche.
- Saldo in esaurimento: quando PlanModule.coarseBalanceLevel è impostato su LOW_QUOTA
- Dati esauriti: quando PlanModule.coarseBalanceLevel è impostato su OUT_OF_DATA. Se, oltre a questo, PlanModule.overUsagePolicy è impostato su PAY_AS_YOU_GO, l'utente riceverà una notifica che lo informa che sta per passare alla modalità di pagamento a consumo.
- Avviso di scadenza dei dati: quando PlanModule.planModuleState è impostato su EXPIRING_SOON
- Plan Activation: when PlanModule.planModuleState is set to NEWLY_ACTIVE
- Pagamento a consumo: quando AccountInfo.payAsYouGoCharge viene compilato con l'importo speso dall'utente.
- Ricarica account: quando AccountInfo.accountTopUp e AccountInfo.accountBalance sono compilati. Entrambi questi campi sono obbligatori per inviare la notifica di ricarica dell'account all'utente. Se le unità e i nanosecondi in AccountInfo.accountTopUp sono impostati su zero, l'importo della ricarica non è presente nella notifica.
- Data di scadenza dei dati: quando PlanModule.planModuleState è impostato su EXPIRED. Questo vale per i piani già scaduti.
Viene inviata una notifica all'utente per ogni insieme di campi. Se in un singolo
PlanStatus vengono impostati più campi
coarseBalanceLevel o planModuleState, all'utente verrà inviato un numero uguale di notifiche.
Requisiti
Una notifica PlanStatus DEVE contenere quante più informazioni possibili sul piano mobile dell'utente. Per ogni tipo di notifica, l'API Data Plan Sharing definisce anche un insieme minimo di campi necessari per creare il testo della notifica. L'operatore DEVE includere questi campi in una notifica PlanStatus.
| Notifica | Campi obbligatori |
|---|---|
| Saldo in esaurimento | PlanModule.moduleName, PlanModule.byteBalance.remainingBytes |
| Dati terminati | PlanModule.moduleName |
| Avviso di scadenza dei dati | PlanModule.moduleName, PlanModule.expirationTime |
| Attivazione del piano | PlanModule.moduleName |
| Scadenza dei dati | PlanModule.moduleName |