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 les notifications suivantes:
- 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é. Si le champ accountBalance est renseigné, la notification indique le solde restant sur le compte.
- Crédit du compte: lorsque les valeurs des champs AccountInfo.accountTopUp et AccountInfo.accountBalance sont remplies. 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 n'est pas inclus 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.
L'état du forfait qui déclenche la notification est envoyé à l'appareil de l'utilisateur pour mettre à jour le cache de l'appareil. Cela améliore l'expérience utilisateur en affichant un état de forfait récent lorsque l'utilisateur clique sur la notification. Si l'état du forfait utilisé pour envoyer une notification n'est pas complet et ne doit pas être affiché à l'utilisateur, l'opérateur DOIT définir la valeur de UiCompatibilité sur UI_INCOMPATIBLE.
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 |
| Paiement à l'usage | AccountInfo.payAsYouGoCharge |
| Crédit du compte | CompteInfo.compteTopUp |
| Expiration des données | PlanModule.moduleName |