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 às seguintes 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. Se accountBalance for preenchido, a notificação mostrará o saldo restante na conta.
- Recarga da conta: quando AccountInfo.accountTopUp e AccountInfo.accountBalance são preenchidas. 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 será incluído 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.
O status do plano que aciona a notificação é enviado ao dispositivo do usuário para atualizar
o cache no dispositivo. Isso melhora a experiência do usuário exibindo um status de plano recente
quando o usuário clica na notificação. Se o status do plano usado para
enviar uma notificação não estiver completo e não puder ser mostrado ao usuário, a operadora PRECISA definir
UiCompatibility como UI_INCOMPATIBLE.
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 |
| Pagamento por utilização | AccountInfo.payAsYouGoCharge |
| Recarga da conta | AccountInfo.accountTopUp |
| Expiração de dados | PlanModule.moduleName |