Panoramica
L'API Google Mobile Data Plan Sharing consente inoltre a un operatore di inviare notifiche a un utente tramite push di un PlanStatus.
Al momento, l'API supporta le seguenti 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. Se il campo accountBalance è compilato, la notifica mostra il saldo rimanente dell'account.
- 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 nanos in AccountInfo.accountTopUp, sono impostati su zero, l'importo della ricarica non è incluso 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.
Lo stato del piano che attiva la notifica viene inviato al dispositivo dell'utente per aggiornare
la cache sul dispositivo. In questo modo, l'esperienza utente migliora perché viene mostrato lo stato recente del piano quando l'utente fa clic sulla notifica. Se lo stato del piano utilizzato per
l'invio di una notifica non è completo e non deve essere mostrato all'utente, l'operatore DEVE impostare
UiCompatibility
su UI_INCOMPATIBLE.
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 |
| Paga in base al consumo | AccountInfo.payAsYouGoCharge |
| Ricarica dell'account | AccountInfo.accountTopUp |
| Scadenza dei dati | PlanModule.moduleName |