Übersicht
Mit der Google Mobile Data Plan Sharing API kann ein Mobilfunkanbieter auch Benachrichtigungen an einen Nutzer senden, indem er einen PlanStatus pusht.
Die API unterstützt derzeit sieben Arten von Benachrichtigungen.
- Niedriger Kontostand: wenn PlanModule.coarseBalanceLevel auf LOW_QUOTA festgelegt ist
- Keine Daten: wenn PlanModule.coarseBalanceLevel auf OUT_OF_DATA festgelegt ist. Wenn zusätzlich dazu PlanModule.overUsagePolicy auf PAY_AS_YOU_GO gesetzt ist, wird der Nutzer benachrichtigt, dass er in den „Pay as you go“-Modus wechselt.
- Warnung zum Ablauf von Daten: wenn PlanModule.planModuleState auf EXPIRING_SOON festgelegt ist
- Aktivierung des Abos: wenn PlanModule.planModuleState auf NEWLY_ACTIVE festgelegt ist
- Pay-as-you-go: Wenn AccountInfo.payAsYouGoCharge mit dem Betrag gefüllt ist, den der Nutzer ausgegeben hat.
- Konto aufladen: wenn AccountInfo.accountTopUp und AccountInfo.accountBalance ausgefüllt sind. Beide Felder sind erforderlich, um dem Nutzer die Benachrichtigung zum Aufladen des Kontos zu senden. Wenn „units“ und „nanos“ in AccountInfo.accountTopUp auf null gesetzt sind, ist der Aufladebetrag nicht in der Benachrichtigung enthalten.
- Ablauf von Daten: wenn PlanModule.planModuleState auf EXPIRED festgelegt ist. Das gilt für Pläne, die bereits abgelaufen sind.
Für jeden Satz von Feldern wird eine Benachrichtigung an den Nutzer gesendet. Wenn in einem einzelnen PlanStatus mehrere coarseBalanceLevel- oder planModuleState-Felder festgelegt sind, wird dem Nutzer die gleiche Anzahl von Benachrichtigungen gesendet.
Voraussetzungen
Eine Benachrichtigung vom Typ PlanStatus SOLLTE so viele Informationen wie möglich zum Mobilfunktarif des Nutzers enthalten. Für jede Art von Benachrichtigung definiert die Data Plan Sharing API auch eine Mindestanzahl von Feldern, die zum Erstellen des Benachrichtigungstexts erforderlich sind. Der Betreiber MUSS diese Felder in eine Benachrichtigung vom Typ „PlanStatus“ aufnehmen.
| Benachrichtigung | Erforderliche Felder |
|---|---|
| Niedriger Kontostand | PlanModule.moduleName, PlanModule.byteBalance.remainingBytes |
| Keine Daten mehr | PlanModule.moduleName |
| Warnung: Ablauf von Daten | PlanModule.moduleName, PlanModule.expirationTime |
| Tarifaktivierung | PlanModule.moduleName |
| Ablauf von Daten | PlanModule.moduleName |