Panoramica
L'API Google Mobile Data Plan Sharing consente inoltre a un operatore di inviare notifiche a un utente eseguendo il push di un PlanStatus.
Attualmente l'API supporta sette tipi di notifiche.
- Saldo basso: quando PlanModule.coarseBalanceLevel è impostato su LOW_quota
- Fuori dati: quando PlanModule.coarseBalanceLevel è impostato su OUT_OF_DATA. Se, oltre a questo, PlanModule.overUsagePolicy è impostato su PAY_AS_YOU_GO, l'utente verrà informato che sta per attivare la modalità di pagamento a consumo.
- Avviso scadenza dati: quando PlanModule.planModuleState è impostato su EXPIRING_SOON
- Attivazione dei piani: quando PlanModule.planModuleState è impostato su NEWLY_ACTIVE
- Pagamento a consumo: quando AccountInfo.payAsYouGoCharge viene compilato con l'importo che l'utente ha speso.
- Ricarica account: quando vengono inseriti AccountInfo.accountTopUp e AccountInfo.accountBalance. Entrambi questi campi sono obbligatori per inviare la notifica di ricarica dell'account all'utente. Se le unità e i nano in AccountInfo.accountTopUp sono impostati su zero, l'importo di ricarica non è presente nella notifica.
- Scadenza dati: quando PlanModule.planModuleState è impostato su EXPIRED. Questo vale per i piani già scaduti.
All'utente viene inviata una notifica per ogni set di campi. Se in un singolo
PlanStatus vengono impostati più campi coarseBalanceLevel o planModuleState, all'utente verrà inviato un numero di notifiche uguale.
Requisiti
Una notifica PlanStatus DEVE contenere quante più informazioni possibili sul piano tariffario per dispositivi mobili dell'utente. Per ogni tipo di notifica, l'API di condivisione del piano dati definisce anche un insieme minimo di campi obbligatori per creare il testo della notifica. L'operatore DEVE includere questi campi in un piano Status.
| Notifica | Campi obbligatori |
|---|---|
| Saldo in esaurimento | PlanModule.moduleName, PlanModule.byteBalance.remainingBytes |
| Dati esauriti | NomeModuloModulo. |
| Avviso scadenza dati | PlanModule.moduleName, PlanModule.expirationTime |
| Attivazione del piano | NomeModuloModulo. |
| Scadenza dati | NomeModuloModulo. |