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 le seguenti 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. Se il campo accountBalance viene completato, la notifica mostra il saldo rimanente nell'account.
- 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 è incluso 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.
Lo stato del piano che attiva la notifica viene inviato al dispositivo dell'utente per aggiornare
la cache del dispositivo. Ciò migliora l'esperienza utente mostrando uno stato del piano recente quando l'utente fa clic sulla notifica. Se lo stato del piano utilizzato per inviare 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 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. |
| Pagamento in base al consumo | InformazioniAccount.PayAsYouGoCharge |
| Ricarica account | AccountInfo.AccountTopUp |
| Scadenza dati | NomeModuloModulo. |