Ü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 die folgenden 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. Wenn accountBalance ausgefüllt ist, wird in der Benachrichtigung das verbleibende Guthaben auf dem Konto angezeigt.
- Kontoaufladung: 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 Einheiten 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.
Der Planstatus, der die Benachrichtigung auslöst, wird an das Nutzergerät gesendet, um den Cache auf dem Gerät zu aktualisieren. Dadurch wird die Nutzerfreundlichkeit verbessert, da beim Klicken auf die Benachrichtigung der aktuelle Status des Abos angezeigt wird. Wenn der für das Senden einer Benachrichtigung verwendete Tarifstatus nicht vollständig ist und dem Nutzer nicht angezeigt werden sollte, MUSS der Mobilfunkanbieter UiCompatibility auf UI_INCOMPATIBLE festlegen.
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 |
| Pay as you go | AccountInfo.payAsYouGoCharge |
| Konto aufladen | AccountInfo.accountTopUp |
| Ablauf von Daten | PlanModule.moduleName |