Interfejs API agenta Data Data
Grudzień 2019 r.
- Wprowadziliśmy definicję interfejsu Rejestrowanie CPID w interfejsie organu ochrony danych do wdrożenia.
- Dodaliśmy sugestie dotyczące generowania CPI i jego przechowywania, gdy klient poprosi o nowy CPI.
- Dodaliśmy dokumentację dotyczącą wyboru CPI do wysyłania powiadomień.
- 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.
- 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.
- Usuń atrybut planLanguage z Oferty, który do tej pory był oznaczony jako pole wymagane.
Wrzesień 2019 r.
- 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.
- Doprecyzowano możliwe wartości identyfikatorów klienta.
- Dodaliśmy obsługę powiadomień o doładowaniem konta.
- Spełnianie wymagań dotyczących CPI w odniesieniu do wymagania nowego CPI przy każdym wywołaniu punktu końcowego CPI.
- Dodaj dokumentację różnych odpowiedzi na błędy GTAF podczas wywoływania interfejsu API mobilnej transmisji danych.
Czerwiec 2019 r.
- Zaktualizowaliśmy specyfikację interfejsu DPA API, zgodnie z którą operatorzy muszą zaakceptować parametr _clientid jako parametr zapytania.
- Zaktualizowaliśmy interfejs API udostępniania mobilnej transmisji danych, aby umożliwić operatorom udostępnianie Google informacji o konkretnym kliencie.
- Kolejność, w jakiej oferty są wyświetlane użytkownikowi, może się różnić od kolejności, w jakiej są one przyznawane GTAF.
- GTAF może udostępniać w interfejsie mobilnej transmisji danych więcej niż 10 abonamentów.
Maj 2019 r.
- Termin ważności jest wymagany, chyba że abonament nie wygasa.
- zgodnie z RFC 6749 oznacz token_type jako wymagany w odpowiedzi serwera OAuth.
- Zwraca typ powiadomień, które zostały wysłane do użytkownika, gdy operator prześle stan planu do GTAF.
Kwiecień 2019 r.
- Informacja o koncie jest wymagana w przypadku użytkowników przedpłaconych.
- Zaktualizuj zalecaną metodę generowania identyfikatora CPI, by podczas jej generowania uwzględniać język w formie zwykłego tekstu.
- 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.
- Dodaliśmy obsługę wysyłania powiadomień, gdy użytkownik wydaje saldo konta przy użyciu danych, które są naliczane według wykorzystania.
- 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.
- Usuń atrybut offerInfo.promoMessage z zestawu wymaganych pól. MDP nie używa tego pola do wyświetlania ofert użytkownikom.
- 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.
- Dodaliśmy wymagania dotyczące powiadomień push.
Luty 2019 r.
- Usunęliśmy obsługę udostępniania PlanOffer przez Google przy użyciu interfejsu API udostępniania danych.
Styczeń 2019 r.
- Dodaliśmy przewodnik po aktualizacji konfiguracji operatora za pomocą portalu dostawcy usług internetowych.
- Dodaliśmy przewodnik po implementacji protokołu OAuth dla interfejsu Data Plan Agent API.
- Zaktualizowaliśmy nazwę i przeorganizowaliśmy przewodnik integracji interfejsu Mobile Data Plan Share API.
listopadzie 2018 r.
- Dodaliśmy obsługę powiadomień o aktywacji abonamentu.
- Dodano obsługę kategorii ruchu modułu planu APP_STORE.
Wrzesień 2018 r.
- Dodaliśmy interfejs API, aby raportować operatory zgody użytkownika.
- Dodaliśmy obsługę abonamentów, które okresowo odświeżają limit w usługach PlanModule i Offer.
- Dodano obsługę powiadomień o wygaśnięciu.
- 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.
- Dodaliśmy możliwość określenia salda konta w ramach PlanStatus.
Czerwiec 2018 r.
- Usunięto aktualizację. Otrzymaj metody dotyczące stanu planu i ofert.
- Maksymalne przybliżone saldo może być wypełniane w tym samym czasie, gdy wypełniane są bajty lub saldo.
- Do oferty dodano typ połączenia.
- 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.
- Zmieniono nazwę Dataplanu na Plan. Jest to zmiana dokumentacji, która nie powinna mieć wpływu na operatorów.
- 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.
- Zaktualizowaliśmy odpowiedź CPI, by zachować zgodność wsteczną.
- Dodano tytuł PlanStatus. Tytuł będzie używany do wypełnienia nagłówka w ustawieniach.
- Dodano nazwę modułu i bajty używane w PlanModule.
- 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.
- Wycofuje te wywołania interfejsu API:
- Zapytania dotyczące konta użytkownika (DPA_URL/{data_plan_key_string}/konto).
- wysyłanie zapytań do zakupionych planów;
- 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.
- Zmienia adres URL, który nazywamy ofertami pakietów. Nowy adres URL opisano tutaj. Organ ochrony danych powinien zwrócić instancję PlanOffer.
- 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.
- 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.
- 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. - 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:
- 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.
- Wprowadzamy pole czasu ostatniej aktualizacji w grupie PlanGroup.
- Usuwa pole procentowe udziału w danych z okresu elastycznego.