Visão geral
A API Google Mobile Data Plan Sharing também permite que um operador envie notificações para um usuário enviando um PlanStatus.
Atualmente, a API oferece suporte a sete tipos de notificações.
- Baixo saldo: quando PlanModule.coarseBalanceLevel está definido como LOW_QUOTA
- Sem dados: quando PlanModule.coarseBalanceLevel está definido como OUT_OF_DATA. Se além disso, o PlanModule.overUsagePolicy estiver definido como PAY_AS_YOU_GO, o usuário será notificado 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 está definido como NEWLY_ACTIVE
- Pagamento por utilização: quando AccountInfo.payAsYouGoCharge é preenchido com o valor gasto pelo usuário.
- Recarga da conta: quando AccountInfo.accountTopUp e AccountInfo.accountBalance são preenchidos. Esses dois campos são necessários para enviar a notificação de recarga da conta para o usuário. Se as unidades e os nanos em AccountInfo.accountTopUp forem definidos como zero, o valor da recarga não estará na notificação.
- Data de validade: quando PlanModule.planModuleState é definido como EXPIRED. Isso vale para planos que já expiraram.
Uma notificação é enviada para o usuário sobre cada conjunto de campos. Se vários campos
coarseBalanceLevel ou planModuleState forem definidos em um único
PlanStatus, um número igual de notificações será enviado ao usuário.
Requisitos
Uma notificação PlanStatus deve conter a maior quantidade de informações possível sobre o plano para dispositivos móveis 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 da 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 |
| Expiração de dados | PlanModule.moduleName |