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 te powiadomienia:
- 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. Jeśli pole accountBalance jest wypełnione, powiadomienie zawiera informację o pozostałym saldzie na koncie.
- Doładowanie konta: gdy wypełnione są pola AccountInfo.accountTopUp i AccountInfo.accountBalance. Oba te pola są wymagane do wysłania użytkownikowi powiadomienia o doładowaniu konta. Jeśli wartości jednostek i nanos w polu AccountInfo.accountTopUp są ustawione na zero, kwota doładowania nie jest uwzględniana 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.
Stan planu, który wywołuje powiadomienie, jest wysyłany na urządzenie użytkownika w celu zaktualizowania pamięci podręcznej na urządzeniu. Ułatwia to użytkownikom korzystanie z usługi, ponieważ po kliknięciu powiadomienia wyświetla się aktualny stan subskrypcji. Jeśli stan planu używany do wysyłania powiadomienia nie jest kompletny i nie powinien być wyświetlany użytkownikowi, operator MUSI ustawić wartość UiCompatibility na UI_INCOMPATIBLE.
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 |
| Płatność według wykorzystania | AccountInfo.payAsYouGoCharge |
| Doładowanie konta | AccountInfo.accountTopUp |
| Wygasanie danych | PlanModule.moduleName |