Zusätzliche Anwendungsfälle

Voraussetzungen

GTAF kann die folgende Anfrage zur Berechtigung stellen, um zu prüfen, ob ein Nutzer berechtigt ist, einen Tarif zu kaufen.

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

planId ist die eindeutige Kennzeichnung für den Tarif, mit der der Tarif im Namen des Nutzers gekauft werden kann (siehe Data Purchase). Wenn planId nicht angegeben ist, MUSS die DPA alle Pläne zurückgeben, die von diesem Nutzer gekauft werden können.

Unter Fehlerfälle sind die Antworten aufgeführt, die im Fehlerfall von DPA erwartet werden. Außerdem MUSS der DPA in den folgenden Fehlerfällen einen Fehler zurückgeben:

  • Die DPA gibt den Fehlercode 400 BAD REQUEST zurück, der GTAF darauf hinweist, dass planId ungültig ist.
  • Die DPA gibt den Fehlercode 409 CONFLICT zurück, der angibt, dass planId nicht mit dem Datentarif des Nutzers kompatibel ist.

Andernfalls MUSS der DPA eine 200-OK-Antwort zurückgeben. Das Format einer erfolgreichen EligibilityResponse ist:

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

Wenn die Anfrage ein planId enthält, enthält die Antwort nur diesen Plan. Andernfalls enthält die Liste alle Tarife, die der Nutzer kaufen kann. Wenn planId leer ist und die DPA die Rückgabe der Liste der infrage kommenden Tarife nicht unterstützt, MUSS ein 400 BAD REQUEST-Fehler zurückgegeben werden.

5G-Funktionen für Android

Mit GTAF können Mobilfunkanbieter den Abrechnungsstatus pro Verbindungstyp für Abonnenten freigeben. Die Informationen können regelmäßig von GTAF abgerufen oder von Mobilfunkanbietern auf Grundlage interner Trigger gesendet werden.

Pull API

Das Gerät kann die Informationen zur Abrechnung über GTAF mit den folgenden Methoden abrufen:

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

Der Data Plan Agent (DPA) stellt einen API-GW- oder Berechtigungsserver im Netzwerk des Mobilfunkanbieters dar.

„userKey“ ist das Authentifizierungstoken, das während der ersten Authentifizierungsphase wie hier definiert festgelegt wurde.

client_id ist AndroidSystemInfo

Der Status der Abrechnung wird als ENUM bereitgestellt.

Der DPA muss die Antwort „200 OK“ zurückgeben und planInfoPerClient einschließen. Die Fehlerbehandlung für den DPA ist hier definiert.

Im Pull-Modell fungiert GTAF als Client und validiert das SSL-Zertifikat des DPA. GTAF authentifiziert sich bei DPA mithilfe des hier definierten OAuth-Verfahrens.

Push API

Der Mobilfunkanbieter kann die Informationen zur Abrechnung auch auf Grundlage eines Triggerereignisses wie einer Änderung des Tarifmodells usw. übertragen.

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

Die DPA muss planInfoPerClient im Nachrichtentext enthalten. Fehlerantworten von GTAF sind hier definiert.

Im Push-Modus authentifiziert GTAF eingehende Anfragen von DPA mithilfe des Google Cloud OAuth2-Servers. Die eingehenden Anfragen müssen als Dienstkonto authentifiziert werden, das im ISP-Portal für die ASN, die die DPA repräsentiert, auf die Zulassungsliste gesetzt wurde. Weitere Informationen finden Sie auch im Integrationsleitfaden.