Descripción general
La API de Google Mobile Data Plan Sharing también permite que un operador envíe notificaciones a un usuario con un envío de PlanStatus.
Actualmente, la API admite 7 tipos de notificaciones.
- Poco saldo: Cuando PlanModule.coarseBalanceLevel se establece en LOW_QUOTA
- Sin datos: Cuando PlanModule.coarseBalanceLevel se establece en OUT_OF_DATA. Si, además de esto, PlanModule.overUsagePolicy se establece en PAY_AS_YOU_GO, se le notificará al usuario que está a punto de ingresar al modo de pago por uso.
- Advertencia de vencimiento de datos: Cuando PlanModule.planModuleState se establece en EXPIRING_SOON
- Activación del plan: Cuando PlanModule.planModuleState se establece en NEWLY_ACTIVE
- Pago por uso: Cuando AccountInfo.payAsYouGoCharge se completa con el importe que gastó el usuario.
- Recarga de la cuenta: Cuando se completan AccountInfo.accountTopUp y AccountInfo.accountBalance Ambos campos son obligatorios para enviar la notificación de recarga de la cuenta al usuario. Si las unidades y los nanos en AccountInfo.accountTopUp se establecen en cero, el importe de la recarga no se incluirá en la notificación.
- Vencimiento de datos: Cuando PlanModule.planModuleState se establece en EXPIRED. Esto es para los planes que ya vencieron.
Se envía una notificación al usuario por cada conjunto de campos. Si se configuran varios campos coarseBalanceLevel o planModuleState en un solo PlanStatus, se enviará la misma cantidad de notificaciones al usuario.
Requisitos
Una notificación PlanStatus DEBE contener la mayor cantidad de información posible sobre el plan para dispositivos móviles del usuario. Para cada tipo de notificación, la API de Data Plan Sharing también define un conjunto mínimo de campos que son obligatorios para crear el texto de la notificación. El operador DEBE incluir estos campos en un PlanStatus de notificación.
| Notificación | Campos obligatorios |
|---|---|
| Saldo bajo | PlanModule.moduleName, PlanModule.byteBalance.remainingBytes |
| Sin datos | PlanModule.moduleName |
| Advertencia de vencimiento de datos | PlanModule.moduleName, PlanModule.expirationTime |
| Activación del plan | PlanModule.moduleName |
| Vencimiento de los datos | PlanModule.moduleName |