Visão geral
A API Google Mobile Data Plan Sharing também permite que uma operadora envie notificações a um usuário ao enviar um PlanStatus.
No momento, a API é compatível com sete tipos de notificações.
- Saldo baixo: quando PlanModule.coarseBalanceLevel é definido como LOW_QUOTA
- Sem dados: quando PlanModule.coarseBalanceLevel é definido como OUT_OF_DATA. Se, além disso, o PlanModule.overUsagePolicy estiver definido como PAY_AS_YOU_GO, o usuário vai receber uma notificação de que está prestes a entrar no modo de pagamento por utilização.
- Aviso de expiração de dados: quando PlanModule.planModuleState é definido como EXPIRING_SOON
- Ativação do plano: quando PlanModule.planModuleState é definido como NEWLY_ACTIVE
- Pague conforme o uso: quando AccountInfo.payAsYouGoCharge é preenchido com o valor gasto pelo usuário.
- Recarga da conta: quando AccountInfo.accountTopUp e AccountInfo.accountBalance são preenchidos. Os dois campos são obrigatórios para enviar a notificação de recarga da conta ao usuário. Se as unidades e os nanos em AccountInfo.accountTopUp forem definidos como zero, o valor da recarga não vai aparecer na notificação.
- Expiração de dados: quando PlanModule.planModuleState é definido como EXPIRED. Isso é para planos que já expiraram.
Uma notificação é enviada ao usuário para cada conjunto de campos. Se vários campos coarseBalanceLevel ou planModuleState forem definidos em um único PlanStatus, o mesmo número de notificações será enviado ao usuário.
Requisitos
Uma notificação PlanStatus DEVE conter o máximo de informações possível sobre o plano móvel do usuário. Para cada tipo de notificação, a API Data Plan Sharing também define um conjunto mínimo de campos necessários para criar o texto da notificação. O operador PRECISA incluir esses campos em um PlanStatus de notificação.
| Notificação | Campos obrigatórios |
|---|---|
| Saldo baixo | PlanModule.moduleName, PlanModule.byteBalance.remainingBytes |
| Sem dados | PlanModule.moduleName |
| Alerta de expiração de dados | PlanModule.moduleName, PlanModule.expirationTime |
| Ativação do plano | PlanModule.moduleName |
| Vencimento de dados | PlanModule.moduleName |