Dodatkowe przypadki użycia

Dostępność

GTAF może wysłać to żądanie weryfikacji, aby sprawdzić, czy użytkownik kwalifikuje się do zakupu abonamentu.

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

Pamiętaj, że planId to unikalny identyfikator subskrypcji, który można wykorzystać do zakupu subskrypcji w imieniu użytkownika (patrz Zakup danych). Jeśli parametr planId nie jest określony, dostawca danych musi zwrócić wszystkie plany, które może kupić dany użytkownik.

W sekcji Przypadki błędów znajdziesz listę odpowiedzi, których oczekuje DPA w przypadku wystąpienia błędu. Dodatkowo DPA ZWRACA błąd w tych przypadkach:

  • Usługa DPA zwraca kod błędu 400 BAD REQUEST, który informuje usługę GTAF, że planId jest nieprawidłowy.
  • Interfejs DPA zwraca kod błędu 409 CONFLICT, który oznacza, że planId jest niezgodny z abonamentem użytkownika.

W przeciwnym razie platforma DPA ZWRACA odpowiedź 200-OK. Format odpowiedzi EligibilityResponse informującej o powodzeniu:

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

Jeśli żądanie zawiera symbol planId, odpowiedź obejmuje tylko ten plan. W przeciwnym razie lista zawiera wszystkie pakiety, które użytkownik może kupić. Jeśli parametr planId jest pusty, a platforma DPA nie obsługuje zwracania listy kwalifikujących się planów, MUSI zwrócić błąd 400 BAD REQUEST.

Android 5G Experiences

GTAF umożliwia operatorom udostępnianie informacji o limicie danych dla każdego typu połączenia w przypadku subskrybentów. Informacje mogą być okresowo pobierane przez GTAF lub operatorzy mogą je przesyłać na podstawie wewnętrznych wyzwalaczy.

Pull API

Urządzenie może pobierać informacje o limicie danych za pomocą GTAF w ten sposób:

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

Pamiętaj, że DPA (Data Plan Agent) to serwer API GW lub serwer uprawnień w sieci operatora.

userKey to token uwierzytelniania utworzony w początkowej fazie uwierzytelniania, zgodnie z opisem tutaj.

client_id to AndroidSystemInfo

Stan płatności jest podawany jako ENUM.

Platforma DPA powinna zwrócić odpowiedź 200 OK i zawierać parametr planInfoPerClient. Obsługa błędów na platformie DPA jest opisana tutaj

W modelu pobierania GTAF działa jako klient i weryfikuje certyfikat SSL DPA. GTAF uwierzytelnia się w DPA za pomocą procedury OAuth opisanej tutaj.

Push API

Operator może też przesyłać informacje o pomiarze na podstawie zdarzenia wywołującego, np. zmiany planu cenowego itp.

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

DPA musi uwzględnić w treści wiadomości parametr planInfoPerClient. Odpowiedzi z błędami z GTAF są zdefiniowane tutaj

W trybie push GTAF uwierzytelnia przychodzące żądania z DPA za pomocą serwera OAuth2 Google Cloud. Przychodzące żądania muszą być uwierzytelniane jako konto usługi, które zostało dodane do białej listy w Portalu dostawcy usług internetowych dla numeru ASN, który reprezentuje DPA. Więcej informacji znajdziesz w przewodniku po integracji tutaj.