Dodatkowe przypadki użycia

Dostępność

GTAF MOŻE wysłać następujące żądanie, aby sprawdzić, czy użytkownik może kupić abonament.

GET DPA/{userKey}/Eligibility/{planId}?key_type={CPID,MSISDN}

Pamiętaj, że planId to unikalny identyfikator planu, którego możesz użyć do zakupu abonamentu w imieniu użytkownika (zobacz Zakup danych). Jeśli planId nie został określony, podmiot DPA MUSI zwrócić wszystkie plany, które może kupić ten użytkownik.

Przypadki błędów zawierają odpowiedzi przygotowane przez organ ochrony danych na wypadek błędu. Organ ochrony danych w takim przypadku zwraca błąd w tych przypadkach:

  • Organ ochrony danych zwraca kod błędu 400 BAD REQUEST, który informuje GTAF, że planId jest nieprawidłowy.
  • Organ ochrony danych zwraca kod błędu 4F (409), który wskazuje, że parametr planId jest niezgodny z abonamentem użytkownika.

W przeciwnym razie podmiot DPA powinien zwrócić odpowiedź 200-OK. Udało się Warunki odpowiedzi odnoszą się do:

{
  "eligiblePlans":
  [
   {
    "planId": string,   // Plan identifier. Can be used to
                        // refer to the plan during
                        // offers, etc. (req.)
   }
  ]
}

Jeśli żądanie zawiera zmienną planId, odpowiedź zawiera tylko ten plan. W przeciwnym razie lista zawiera wszystkie abonamenty, które użytkownik może kupić. Jeśli żądanie planId jest puste, a organ ochrony danych nie zwraca listy kwalifikujących się planów, MUSI zwrócić błąd 400 BAD REQUEST.

Android 5G

Dzięki GTAF operatorzy mogą udostępniać stan pomiaru według typu połączenia. Informacje mogą być okresowo pobierane przez GTAF, a operatorzy mogą je przekazywać na podstawie reguł wewnętrznych.

Interfejs API pull

Urządzenie może pobrać informacje o pomiarach użycia danych przy użyciu GTAF:

GET DPA/{userKey}/planStatus?key_type={userKey}&client_id=AndroidSystemInfo

DPA (Agent pakietu danych) reprezentuje serwer GW API lub serwer uprawnień w sieci operatora.

userKey to token uwierzytelniania utworzony na wstępnym etapie uwierzytelniania, zgodnie z definicją tutaj.

client_id to AndroidSystemInfo

Stan Meterness jest podawany jako ENUM

Aneks o przetwarzaniu danych zwraca odpowiedź 200 OK i zawiera planInfoPerClient Postępowanie w przypadku błędów DPA jest zdefiniowane tutaj

W modelu pull GTAF działa jako klient i weryfikuje certyfikat SSL DPA. GTAF uwierzytelnia się w Aneksie o przetwarzaniu danych przy użyciu procedury OAuth określonej tutaj.

Push API

Operator może też przekazać informacje o obejrzeniu na podstawie podanego niżej zdarzenia związanego z regułą, np. zmiany abonamentu.

POST https://mobiledataplansharing.googleapis.com/v1/operators/12345/clients/AndroidSystemInfo/users/abcdef/planStatus

Aneks o przetwarzaniu danych powinien zawierać parametr planInfoPerClient w treści wiadomości. Odpowiedzi błędów GTAF są zdefiniowane tutaj.

W trybie push GTAF uwierzytelnia żądania przychodzące z Aneksu o przetwarzaniu danych przy użyciu serwera OAuth 2 Google Cloud. Żądania przychodzące muszą być uwierzytelnione jako konto usługi umieszczone na białej liście w portalu dostawcy usług internetowych dla ASN reprezentowanego przez organ ochrony danych. Więcej informacji znajdziesz też w przewodniku po integracji.