Przegląd
Interfejs Google Mobile Data Plan Sharing API umożliwia też operatorowi wysyłanie powiadomień do użytkownika przez przekazywanie elementu PlanStatus.
Interfejs API obsługuje obecnie 7 rodzajów powiadomień.
- Niskie saldo: gdy wartość parametru PlanModule.coarseBalanceLevelLOW_QUOTA
- Brak danych: gdy wartość parametru PlanModule.coarseBalanceLevel jest ustawiona na OUT_OF_DATA. Jeśli dodatkowo pole PlanModule.overUsagePolicy ma wartość PAY_AS_YOU_GO, użytkownik otrzyma powiadomienie, że wkrótce przejdzie w tryb płatności za wykorzystanie.
- Data Expiration Warning: gdy PlanModule.planModuleState ma wartość EXPIRING_SOON
- Aktywacja abonamentu: gdy stan PlanModule.planModuleState zostanie ustawiony na NEWLY_ACTIVE.
- Płatność za wykorzystanie: gdy pole AccountInfo.payAsYouGoCharge zawiera kwotę wydaną przez użytkownika.
- Doładowanie konta: gdy pola AccountInfo.accountTopUp i AccountInfo.accountBalance są wypełnione. Oba te pola są wymagane do wysłania użytkownikowi powiadomienia o doładowaniu konta. Jeśli wartości jednostek i nanosów w polu AccountInfo.accountTopUp są ustawione na zero, kwota doładowania nie jest uwzględniona w powiadomieniu.
- Data wygaśnięcia: gdy wartość PlanModule.planModuleState zostanie ustawiona na EXPIRED. Dotyczy to planów, które już wygasły.
Użytkownik otrzymuje 1 powiadomienie dla każdego zestawu pól. Jeśli w jednym polu PlanStatus ustawionych jest kilka pól coarseBalanceLevel lub planModuleState, użytkownik otrzyma tyle powiadomień, ile jest tych pól.
Wymagania
Powiadomienie PlanStatus POWINNO zawierać jak najwięcej informacji o abonamencie komórkowym użytkownika. W przypadku każdego typu powiadomienia interfejs Data Plan Sharing API określa też minimalny zestaw pól wymaganych do utworzenia tekstu powiadomienia. Operator MUSI uwzględnić te pola w powiadomieniu PlanStatus.
| Powiadomienie | Pola wymagane |
|---|---|
| Niskie saldo | PlanModule.moduleName, PlanModule.byteBalance.remainingBytes |
| Nieaktualne | PlanModule.moduleName |
| Ostrzeżenie o wygaśnięciu danych | PlanModule.moduleName, PlanModule.expirationTime |
| Aktywacja abonamentu | PlanModule.moduleName |
| Wygasanie danych | PlanModule.moduleName |