Descripción general
La API de uso compartido del plan de datos móviles de Google también permite que un operador envíe notificaciones a un usuario mediante el envío de un PlanStatus.
Actualmente, la API admite 7 tipos de notificaciones.
- Saldo bajo: cuando PlanModule.coarseBalanceLevel se establece en LOW_QUOTA
- Sin datos: Cuando PlanModule.coarseBalanceLevel se establece en OUT_OF_DATA. Además, PlanModule.overUsagePolicy se configura en PAY_AS_YOU_GO y, luego, se le notificará al usuario que está a punto de ingresar al modo prepago.
- Advertencia de vencimiento de los datos: cuando PlanModule.planModuleState se configura como EXPIRING_SOON
- Activación del plan: Cuando PlanModule.planModuleState se establece en NEWLY_ACTIVE.
- Pago por uso: Cuando AccountInfo.payAsYouGoCharge se propaga con el importe que gastó el usuario.
- Recarga de la cuenta: Cuando se propagan AccountInfo.accountTopUp y AccountInfo.accountBalance. Ambos campos son obligatorios para enviar la notificación de recarga de cuenta al usuario. Si las unidades y los nanosegundos de AccountInfo.accountTopUp se establecen en cero, el importe de recarga no está 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 para cada conjunto de campos. Si se configuran varios campos coarseBalanceLevel o planModuleState en una sola PlanStatus, se enviará la misma cantidad de notificaciones al usuario.
Requisitos
La notificación PlanStatus DEBE contener la mayor cantidad de información posible acerca del plan de telefonía móvil del usuario. Para cada tipo de notificación, la API de uso compartido del plan de datos también define un conjunto mínimo de campos necesarios a fin de compilar 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 |