Dziennik zmian

Data Plan Agent API

Grudzień 2019 r.

  1. Wprowadzono definicję interfejsu API register CPID, którą należy wdrożyć w ramach DPA.
  2. Dodano sugestie dotyczące generowania i przechowywania identyfikatora CPID, gdy klient poprosi o nowy identyfikator CPID.
  3. Dodaliśmy dokumentację dotyczącą wyboru identyfikatora CPID, który będzie używany do wysyłania powiadomień.
  4. Wyjaśniliśmy, jak określać preferencje językowe użytkownika, gdy GTAF wywołuje DPA i gdy DPA wywołuje GTAF.

Październik 2019 r.

  1. Wymagaj nowego identyfikatora CPID za każdym razem, gdy kontaktujemy się z punktem końcowym CPID. Można to osiągnąć, dodając sygnaturę czasową do algorytmu generowania identyfikatora CPID.
  2. Usuń pole planLanguage z elementu Offer, które do tej pory było oznaczone jako pole wymagane.

Wrzesień 2019 r.

  1. Dodaliśmy obsługę powiadomień o wygaśnięciu danych, które różnią się od powiadomień ostrzegawczych o wygaśnięciu danych.

Lipiec 2019 r.

  1. Wyjaśniliśmy możliwe wartości identyfikatora klienta.
  2. Dodaliśmy obsługę powiadomień o doładowaniu konta.
  3. Złagodziliśmy wymagania dotyczące generowania identyfikatora CPID, które wcześniej wymagały tworzenia nowego identyfikatora CPID za każdym razem, gdy wywoływany był punkt końcowy CPID.
  4. Dodaliśmy dokumentację różnych odpowiedzi o błędach z GTAF podczas wywoływania interfejsu API udostępniania mobilnej transmisji danych.

Czerwiec 2019 r.

  1. Zaktualizowana specyfikacja interfejsu DPA API, która wymaga od przewoźników akceptowania parametru _clientid jako parametru zapytania.
  2. Zaktualizowany interfejs API udostępniania mobilnej transmisji danych, który umożliwia operatorom udostępnianie Google informacji o abonamencie użytkownika w przypadku konkretnego klienta.
  3. Kolejność, w jakiej oferty są wyświetlane użytkownikowi, może się różnić od kolejności, w jakiej są one przekazywane do GTAF.
  4. GTAF może udostępniać w interfejsie abonamentu na mobilną transmisję danych więcej niż 10 abonamentów.

Maj 2019 r.

  1. Wymagany jest parametr ExpirationTime, chyba że plan nie wygasa.
  2. Zgodnie z RFC 6749 oznacz token_type jako wymagany w odpowiedzi serwera OAuth.
  3. Zwróć typy powiadomień, które zostały wysłane do użytkownika, gdy operator przesyła stan abonamentu do GTAF.

Kwiecień 2019 r.

  1. W przypadku subskrybentów korzystających z abonamentu przedpłaconego wymagane są informacje o koncie.
  2. Zaktualizuj zalecaną metodę generowania identyfikatora CPID, aby podczas generowania identyfikatora CPID uwzględniać język w zwykłym tekście.
  3. Usunięto obsługę pól moreInfoUrl, operatorLogoUrl i purchaseUrl z ofert. Te pola nie były obsługiwane przez interfejs planu mobilnej transmisji danych. Zmiana jest zgodna wstecznie.
  4. Dodano obsługę wysyłania powiadomień, gdy użytkownik wydaje środki z konta płatności, korzystając z danych w stanie płatności za wykorzystanie.
  5. Usunięto obsługę elastycznych przedziałów czasowych z modułów planu. Zmiana jest zgodna wstecznie. Jeśli więc operator przesyła nam elastyczne przedziały czasowe, odpowiedź zostanie zaakceptowana.

Marzec 2019 r.

  1. Usuń pole offerInfo.promoMessage z zestawu wymaganych pól. MDP nie używa tego pola podczas wyświetlania ofert użytkownikom.
  2. Poprawiono błąd w dokumentacji, który informował, że identyfikator CPID musi być zakodowany na potrzeby adresu URL. Zamiast tego GTAF koduje identyfikator CPID zgodnie ze standardem RFC2396.
  3. Dodano wymagania dotyczące powiadomień push.

Luty 2019 r.

  1. Usunięto obsługę udostępniania Google oferty abonamentu za pomocą interfejsu Data Plan Sharing API.

Styczeń 2019 r.

  1. Dodaliśmy przewodnik po aktualizowaniu konfiguracji operatora za pomocą portalu dostawcy usług internetowych.
  2. Dodano przewodnik po implementacji OAuth w przypadku interfejsu Data Plan Agent API.
  3. Zmieniliśmy nazwę i zreorganizowaliśmy przewodnik po integracji interfejsu Mobile Data Plan Sharing API.

listopadzie 2018 r.

  1. Dodaliśmy obsługę powiadomień o aktywacji planu.
  2. Dodaliśmy obsługę kategorii ruchu modułu planu APP_STORE.

Wrzesień 2018 r.

  1. Dodaliśmy interfejs API do raportowania operatorom zgody użytkowników.
  2. Dodaliśmy obsługę planów, które okresowo odświeżają limit, w przypadku elementów PlanModule i Offer.
  3. Dodaliśmy obsługę powiadomień o wygaśnięciu.
  4. Zmieniono nazwę PlanModuleState na PlanState. Jest to zmiana w dokumentacji, która nie powinna mieć wpływu na operatorów.

Sierpień 2018 r.

  1. Dodaliśmy możliwość określania salda konta przez operatorów w ramach parametru PlanStatus.

Czerwiec 2018 r.

  1. Usunięto aktualizację metod pobierania stanu abonamentu i ofert abonamentu.
  2. Umożliwia wypełnianie przybliżonego poziomu salda w tym samym czasie, w którym wypełniane jest saldo bajtów lub saldo czasu.
  3. Dodano typ połączenia do oferty.
  4. Dodano pole plan module state (stan modułu abonamentu) do elementu PlanModule, aby operator mógł wskazywać abonamenty, które użytkownik kupił, ale nie zostały jeszcze aktywowane. To pole nie jest wymagane.
  5. Zmieniliśmy nazwę DataPlan na Plan. Jest to zmiana w dokumentacji, która nie powinna mieć wpływu na operatorów.
  6. Dodano pole formOfPayment do elementu PlanOffer, aby operator mógł określić, w jaki sposób użytkownik zostanie obciążony za zakup. Domyślnie jest to odliczane od salda abonamentu.

Maj 2018 r.

  1. Zaktualizowano odpowiedź CPID, aby zachować zgodność wsteczną.
  2. Dodano tytuł do elementu PlanStatus. Tytuł będzie używany do wypełniania nagłówka w interfejsie ustawień.
  3. Dodaliśmy nazwę modułu i użyte bajty dla elementu PlanModule.
  4. Dodano wywołanie zwrotne odpowiedzi na zakup do GTAF.

Marzec 2018 r.

Ta aktualizacja obejmuje te zmiany w interfejsie Data Plan Agent API. Te zmiany dotyczą interfejsu Data Plan API w wersji 4.2, który jest dostępny tutaj.

  1. Wycofuje te wywołania interfejsu API:
    1. Wysyłanie zapytania o konto użytkownika (DPA_URL/{data_plan_key_string}/account).
    2. Wysyłanie zapytań o zakupione pakiety (DPA_URL/{data_plan_key_string}/purchasedPlans).
  2. Zmienia adres URL, z którego pobieramy stan pakietu danych. Nowy adres URL jest opisany tutaj. Oczekuje się, że DPA zwróci instancję PlanStatus.
  3. Zmienia adres URL, z którego korzystamy w przypadku ofert abonamentowych. Nowy adres URL jest opisany tutaj. Oczekuje się, że DPA zwróci instancję PlanOffer.
  4. Zmienia treść żądania wysyłanego do platformy DPA podczas zakupu planu. Pamiętaj, że wywołanie interfejsu API jest takie samo. Treść żądania zawiera teraz instancję TransactionRequest. Zwróć uwagę na usunięcie jednego poziomu zagnieżdżenia w porównaniu z poprzednią wersją interfejsu API.
  5. Odpowiedź na prośbę o zakup została zmieniona. Korzystamy z typu waluty zdefiniowanego przez Google Protocol Buffers. W odpowiedzi na udany zakup oczekujemy, że treść odpowiedzi będzie zawierała instancję TransactionResponse.
  6. Jeśli nie podano plan_id, interfejs API kwalifikacji MUSI zwrócić wszystkie pakiety danych, do których użytkownik ma prawo. Wcześniej było to opcjonalne.
  7. Dodaje punkt końcowy rejestracji numeru MSISDN dla GTAF, aby rejestrować numery MSISDN na potrzeby powiadomień z DPA.

Google Mobile Data Plan Sharing API

Marzec 2018 r.

Ta aktualizacja obejmuje te zmiany w interfejsie Google Mobile Data Plan Sharing API:

  1. Wprowadza nowe wywołania interfejsu API, które umożliwiają operatorowi przesyłanie informacji o ofercie dodatkowej do GTAF, aby można je było dalej przesyłać na urządzenia użytkowników. Te nowe wywołania umożliwiają operatorowi przesyłanie ofert do Google.
  2. Wprowadza pole czasu ostatniej aktualizacji w obiekcie PlanGroup.
  3. Usuwa pole procentu kredytu danych z elastycznego okna czasowego.