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 las siguientes 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. Si se propaga accountBalance, la notificación muestra el saldo restante en la cuenta.
- 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 incluye 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.
El estado del plan que activa la notificación se envía al dispositivo del usuario para actualizar la caché del dispositivo. Esto mejora la experiencia del usuario, ya que muestra el estado reciente del plan cuando el usuario hace clic en la notificación. Si el estado del plan que se usa para enviar una notificación no está completo y no se debe mostrar al usuario, el operador DEBE establecer UiCompatibility en UI_INCOMPATIBLE.
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 |
| Pago por uso | AccountInfo.payAsYouGoCharge |
| Recarga de la cuenta | AccountInfo.accountTopUp |
| Vencimiento de los datos | PlanModule.moduleName |