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 oferece suporte às seguintes 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. Se o accountBalance estiver preenchido, a notificação vai mostrar o saldo restante na conta.
- 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, estiverem definidos como zero, o valor da recarga não será incluído 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.
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 mostrando um status recente do plano quando ele 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 DEVE definir
UiCompatibility
como UI_INCOMPATIBLE.
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 |
| Pagamento por utilização | AccountInfo.payAsYouGoCharge |
| Recarga na conta | AccountInfo.accountTopUp |
| Vencimento de dados | PlanModule.moduleName |