Übersicht
Mit der Google Mobile Data Plan Sharing API kann ein Operator Benachrichtigungen auch an Nutzer senden, indem er einen PlanStatus überträgt.
Die API unterstützt derzeit 7 Arten von Benachrichtigungen.
- Niedriges Guthaben: wenn PlanModule.coarse BalanceLevel auf LOW_KONTINGENT festgelegt ist
- Out of Data: Wenn PlanModule.coarse BalanceLevel auf OUT_OF_DATA gesetzt ist. Wenn zusätzlich PlanModule.overUsagePolicy auf PAY_AS_YOU_GO gesetzt ist, wird der Nutzer benachrichtigt, dass er gleich nach dem Start den Modus „Pay as you go“ starten soll.
- Datenablaufwarnung: wenn PlanModule.planModuleState auf EXPIRING_SOON gesetzt ist
- Plan Activation: wenn PlanModule.planModuleState auf NEWLY_ACTIVE gesetzt ist
- Pay as you go: Wenn AccountInfo.payAsYouGoCharge mit dem Betrag gefüllt wird, den der Nutzer ausgegeben hat.
- Konto aufladen: wenn AccountInfo.accountTopUp und AccountInfo.accountGuthaben ausgefüllt sind. Beide Felder sind erforderlich, um die Kontoaufladebenachrichtigung an den Nutzer zu senden. Wenn Einheiten und Nanos in AccountInfo.accountTopUp auf null gesetzt sind, ist der Aufladebetrag nicht in der Benachrichtigung enthalten.
- Datenablauf: wenn PlanModule.planModuleState auf EXPIRED gesetzt ist. Dies gilt für bereits abgelaufene Pläne.
Für jeden Feldsatz wird eine Benachrichtigung an den Nutzer gesendet. Wenn in einem einzelnen PlanStatus mehrere coarseBalanceLevel- oder planModuleState-Felder festgelegt sind, wird die gleiche Anzahl von Benachrichtigungen an den Nutzer gesendet.
Voraussetzungen
Ein PlanStatus in der Benachrichtigung sollte so viele Informationen wie möglich zum Mobilfunktarif des Nutzers enthalten. Für jeden Benachrichtigungstyp definiert die Data Plan Sharing API auch eine Mindestanzahl von Feldern, die zum Erstellen des Benachrichtigungstexts erforderlich sind. Der Operator MUSS diese Felder in einem „PlanStatus“ der Benachrichtigung enthalten.
| Benachrichtigung | Erforderliche Felder |
|---|---|
| Niedriger Kontostand | PlanModule.moduleName, PlanModule.byteBalancing.remainingBytes |
| Keine Daten mehr | PlanModule.moduleName |
| Warnung zum Ablauf von Daten | PlanModule.moduleName, PlanModul.expirationTime |
| Planaktivierung | PlanModule.moduleName |
| Datenablauf | PlanModule.moduleName |