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 7 typów powiadomień.
- 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.
- Doładowanie konta: wtedy, 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 jednostkach AccountInfo.accountTopUp ma wartość zero, doładowanie nie znajduje się 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ń.
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 |
Data ważności | ModułModuł.Nazwa |