Présentation
L'API Google Mobile Data Plan Sharing permet également à un opérateur d'envoyer des notifications à un utilisateur en transmettant un PlanStatus.
L'API accepte actuellement sept types de notifications.
- Solde faible: lorsque PlanModule.coarseBalanceLevel est défini sur LOW_ATTRIBUTE
- Hors données: lorsque PlanModule.coarseBalanceLevel est défini sur OUT_OF_DATA. De plus, si le PlanModule.overUsagePolicy est défini sur PAY_AS_YOU_GO, l'utilisateur sera informé qu'il est sur le point de passer au mode de paiement à l'usage.
- Avertissement d'expiration des données : lorsque PlanModule.planModuleState est défini sur EXPIRING_SOON
- Plan Activation: lorsque PlanModule.planModuleState est défini sur NEWLY_ACTIVE
- Paiement à l'usage : lorsque AccountInfo.payAsYouGoCharge est renseigné avec le montant que l'utilisateur a dépensé.
- Crédit du compte : lorsque les champs AccountInfo.accountTopUp et AccountInfo.accountBalance sont renseignés. Ces deux champs sont obligatoires pour envoyer la notification de recharge de compte à l'utilisateur. Si les unités et les nano-unités de AccountInfo.accountTopUp sont définies sur zéro, le montant de rechargement ne figure pas dans la notification.
- Expiration des données: lorsque PlanModule.planModuleState est défini sur EXPIRED. Il s'agit des forfaits qui ont déjà expiré.
Une notification est envoyée à l'utilisateur pour chaque ensemble de champs. Si plusieurs champs coarseBalanceLevel ou planModuleState sont définis dans un seul élément PlanStatus, un nombre égal de notifications est envoyé à l'utilisateur.
Conditions requises
Une notification PlanStatus DOIT contenir autant d'informations que possible sur le forfait mobile de l'utilisateur. Pour chaque type de notification, l'API Data Plan Sharing définit également un ensemble minimal de champs obligatoires pour créer le texte de la notification. L’opérateur DOIT inclure ces champs dans un PlanPlan de notification.
| Notification | Champs obligatoires |
|---|---|
| Solde faible | PlanModule.moduleName, PlanModule.bytesBalance.remainingBytes |
| À court de données | PlanModule.moduleName |
| Avertissement concernant l'expiration des données | PlanModule.moduleName, PlanModule.expirationTime |
| Activation du plan | PlanModule.moduleName |
| Expiration des données | PlanModule.moduleName |