Opis
Interfejs Google Mobile Data Plan Sharing API umożliwia też operatorowi wysyłanie powiadomień do użytkownika za pomocą funkcji PlanStatus.
Obecnie interfejs API obsługuje te powiadomienia:
- Niskie saldo: gdy PlanModule.coarse BalanceLevel ma wartość LOW_AMOUNT
- Brak danych: gdy PlanModule.coarse BalanceLevel ma wartość OUT_OF_DATA. Jeśli oprócz tego zasada PlanModule.overUsagePolicy ma wartość PAY_AS_YOU_GO, użytkownik otrzyma powiadomienie, że wkrótce przejdzie do trybu płatności według wykorzystania.
- Ostrzeżenie o wygaśnięciu danych: gdy PlanModule.planModuleState ma wartość EXPIRING_SOON
- Aktywacja planu: gdy PlanModule.planModuleState ma wartość NEWLY_ACTIVE
- Płatność według wykorzystania: gdy pole AccountInfo.payAsYouGoCharge jest przeznaczone na wydatki użytkownika. Jeśli pole accountSaldo jest wypełnione, powiadomienie wyświetli pozostałe saldo.
- Doładowanie konta: gdy wypełniane są pola AccountInfo.accountTopUp i AccountInfo.accountSaldo. Oba te pola są wymagane, aby wysłać użytkownikowi powiadomienie o doładowaniem konta. Jeśli w ciągu AccountInfo.accountTopUp wybrane wartości mają wartość 0, kwota doładowania nie jest uwzględniana w powiadomieniu.
- Data wygaśnięcia: gdy PlanModule.planModuleState ma wartość Ważność wygasła. Dotyczy to planów, które już wygasły.
Do każdego zestawu pól wysyłane jest jedno powiadomienie. Jeśli w jednym polu PlanStatus ustawiono wiele pól coarseBalanceLevel lub planModuleState, do użytkownika zostanie wysłana taka sama liczba powiadomień.
Stan planu, który uruchamia powiadomienie, jest wysyłany do urządzenia użytkownika w celu zaktualizowania pamięci podręcznej urządzenia. Zwiększa to wygodę użytkowników, wyświetlając ostatnie stan abonamentu po kliknięciu powiadomienia. Jeśli stan abonamentu używany do wysyłania powiadomień nie jest kompletny i nie powinien być wyświetlany użytkownikowi, operator MUSI ustawić Zgodność na UI_INCOMPATIBLE.
Wymagania
Powiadomienie PlanStatus powinno zawierać jak najwięcej informacji o pakiecie użytkownika. W przypadku każdego typu powiadomień interfejs Data Plan Sharing API definiuje też minimalny zestaw pól wymaganych do utworzenia tekstu powiadomienia. Operator MUSI uwzględnić te pola w planie powiadomień.
| Powiadomienie | Pola wymagane |
|---|---|
| Niskie saldo | PlanModule.moduleName, PlanModule.byteBalance.remainingBytes |
| Brak danych | ModułModuł.Nazwa |
| Ostrzeżenie o wygaśnięciu danych | Planmodule.moduleName,PlanModule.expirationTime, |
| Aktywacja planu | ModułModuł.Nazwa |
| Płatność według wykorzystania | AccountInfo.payAsYouGoCharge |
| Doładowanie konta | AccountInfo.accountTopUp |
| Data ważności | ModułModuł.Nazwa |