Historia zmian

Interfejs API agenta Data Data

Grudzień 2019 r.

  1. Wprowadziliśmy definicję interfejsu Rejestrowanie CPID w interfejsie organu ochrony danych do wdrożenia.
  2. Dodaliśmy sugestie dotyczące generowania CPI i jego przechowywania, gdy klient poprosi o nowy CPI.
  3. Dodaliśmy dokumentację dotyczącą wyboru CPI do wysyłania powiadomień.
  4. Wyjaśniliśmy, jak określać preferencje dotyczące języka użytkowników, gdy GTAF wywołuje metodę DPA, a kiedy DPA wywołuje GTAF.

październiku 2019 r.

  1. Wymagaj nowego CPI za każdym razem, gdy kontaktujesz się z punktem końcowym CPID. Można to osiągnąć, dodając sygnaturę czasową do algorytmu generowania CPID.
  2. Usuń atrybut planLanguage z Oferty, który do tej pory był oznaczony jako pole wymagane.

Wrzesień 2019 r.

  1. Dodaliśmy obsługę powiadomień o wygaśnięciu danych różniących się od ostrzeżeń o wygaśnięciu danych.

Lipiec 2019 r.

  1. Doprecyzowano możliwe wartości identyfikatorów klienta.
  2. Dodaliśmy obsługę powiadomień o doładowaniem konta.
  3. Spełnianie wymagań dotyczących CPI w odniesieniu do wymagania nowego CPI przy każdym wywołaniu punktu końcowego CPI.
  4. Dodaj dokumentację różnych odpowiedzi na błędy GTAF podczas wywoływania interfejsu API mobilnej transmisji danych.

Czerwiec 2019 r.

  1. Zaktualizowaliśmy specyfikację interfejsu DPA API, zgodnie z którą operatorzy muszą zaakceptować parametr _clientid jako parametr zapytania.
  2. Zaktualizowaliśmy interfejs API udostępniania mobilnej transmisji danych, aby umożliwić operatorom udostępnianie Google informacji o konkretnym kliencie.
  3. Kolejność, w jakiej oferty są wyświetlane użytkownikowi, może się różnić od kolejności, w jakiej są one przyznawane GTAF.
  4. GTAF może udostępniać w interfejsie mobilnej transmisji danych więcej niż 10 abonamentów.

Maj 2019 r.

  1. Termin ważności jest wymagany, chyba że abonament nie wygasa.
  2. zgodnie z RFC 6749 oznacz token_type jako wymagany w odpowiedzi serwera OAuth.
  3. Zwraca typ powiadomień, które zostały wysłane do użytkownika, gdy operator prześle stan planu do GTAF.

Kwiecień 2019 r.

  1. Informacja o koncie jest wymagana w przypadku użytkowników przedpłaconych.
  2. Zaktualizuj zalecaną metodę generowania identyfikatora CPI, by podczas jej generowania uwzględniać język w formie zwykłego tekstu.
  3. Usunęliśmy obsługę ofert infoInfoUrl,operatorLogoUrl i UrlUrl. Te pola nie były obsługiwane przez interfejs użytkownika mobilnej transmisji danych. Zmiana jest zgodna wstecznie.
  4. Dodaliśmy obsługę wysyłania powiadomień, gdy użytkownik wydaje saldo konta przy użyciu danych, które są naliczane według wykorzystania.
  5. Usunęliśmy obsługę okien czasu elastycznego z modułów planu. Zmiana jest zgodna wstecznie. Jeśli więc operator wysyła nam elastyczne okna czasowe, odpowiedź zostanie zaakceptowana.

Marzec 2019 r.

  1. Usuń atrybut offerInfo.promoMessage z zestawu wymaganych pól. MDP nie używa tego pola do wyświetlania ofert użytkownikom.
  2. Usuń błąd w dokumentacji informujący o tym, że CPID musi być zakodowany na potrzeby adresu URL. GTAF koduje CPID zgodnie ze standardem RFC2396.
  3. Dodaliśmy wymagania dotyczące powiadomień push.

Luty 2019 r.

  1. Usunęliśmy obsługę udostępniania PlanOffer przez Google przy użyciu interfejsu API udostępniania danych.

Styczeń 2019 r.

  1. Dodaliśmy przewodnik po aktualizacji konfiguracji operatora za pomocą portalu dostawcy usług internetowych.
  2. Dodaliśmy przewodnik po implementacji protokołu OAuth dla interfejsu Data Plan Agent API.
  3. Zaktualizowaliśmy nazwę i przeorganizowaliśmy przewodnik integracji interfejsu Mobile Data Plan Share API.

listopadzie 2018 r.

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

Wrzesień 2018 r.

  1. Dodaliśmy interfejs API, aby raportować operatory zgody użytkownika.
  2. Dodaliśmy obsługę abonamentów, które okresowo odświeżają limit w usługach PlanModule i Offer.
  3. Dodano obsługę powiadomień o wygaśnięciu.
  4. Nazwa elementu PlanModuleState została zmieniona na PlanState. Jest to zmiana dokumentacji, która nie powinna mieć wpływu na operatorów.

Sierpień 2018 r.

  1. Dodaliśmy możliwość określenia salda konta w ramach PlanStatus.

Czerwiec 2018 r.

  1. Usunięto aktualizację. Otrzymaj metody dotyczące stanu planu i ofert.
  2. Maksymalne przybliżone saldo może być wypełniane w tym samym czasie, gdy wypełniane są bajty lub saldo.
  3. Do oferty dodano typ połączenia.
  4. Dodaliśmy pole plan modułu do PlanModule, aby umożliwić operatorowi wskazanie abonamentów, które użytkownik kupił, ale nie został jeszcze aktywowany. To pole nie jest wymagane.
  5. Zmieniono nazwę Dataplanu na Plan. Jest to zmiana dokumentacji, która nie powinna mieć wpływu na operatorów.
  6. Do sekcji PlanOffer dodaliśmy pole formOfPayment, dzięki któremu operator może określić sposób pobierania od użytkownika opłaty za zakup. Domyślnie jest ono odjęte od salda planu.

Maj 2018 r.

  1. Zaktualizowaliśmy odpowiedź CPI, by zachować zgodność wsteczną.
  2. Dodano tytuł PlanStatus. Tytuł będzie używany do wypełnienia nagłówka w ustawieniach.
  3. Dodano nazwę modułu i bajty używane w PlanModule.
  4. Wywołano odpowiedź z zakupem z powrotem do GTAF.

Marzec 2018 r.

Ta aktualizacja obejmuje następujące zmiany w interfejsie Data Plan Agent API. Zmiany te odnoszą się do interfejsu Data Plan API w wersji 4.2 hostowanego tutaj.

  1. Wycofuje te wywołania interfejsu API:
    1. Zapytania dotyczące konta użytkownika (DPA_URL/{data_plan_key_string}/konto).
    2. wysyłanie zapytań do zakupionych planów;
  2. Umożliwia zmianę adresu URL, który wywołuje stan abonamentu na dane. Nowy adres URL opisano tutaj. Organ ochrony danych powinien zwrócić instancję PlanStatus.
  3. Zmienia adres URL, który nazywamy ofertami pakietów. Nowy adres URL opisano tutaj. Organ ochrony danych powinien zwrócić instancję PlanOffer.
  4. Zmienia treść żądania wysłanego do organu ochrony danych podczas zakupu planu. Wywołanie interfejsu API jest takie samo. Treść żądania zawiera teraz instancję TransactionRequest. Zwróć uwagę na usunięcie poziomu zagnieżdżania w porównaniu z poprzednią wersją interfejsu API.
  5. Odpowiedź na prośbę o zakup się zmieniła. Korzystamy z typu waluty zdefiniowanej przez Google Protobuf. W odpowiedzi na zakup uznajemy, że treść odpowiedzi będzie zawierać instancję TransactionResponse.
  6. Jeśli nie określisz właściwości plan_id, to interfejs API MUSI zwracać wszystkie plany danych, do których użytkownik kwalifikuje się. Wcześniej ta funkcja była opcjonalna.
  7. Dodaje punkt końcowy rejestracji MSISDN na potrzeby GTAF, aby zarejestrować numer MSISDN na potrzeby powiadomień w organie ochrony danych.

Interfejs API udostępniania mobilnej transmisji danych Google

Marzec 2018 r.

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

  1. Wprowadzenie nowych wywołań interfejsu API, które pozwalają operatorowi na przekazywanie informacji o ofertach sprzedaży do GTAF w dół. Nowe wywołania umożliwiają operatorowi przekazywanie ofert do Google.
  2. Wprowadzamy pole czasu ostatniej aktualizacji w grupie PlanGroup.
  3. Usuwa pole procentowe udziału w danych z okresu elastycznego.