Zusätzliche Anwendungsfälle

Voraussetzungen

Der GTAF kann die folgende Berechtigungsanfrage stellen, um zu prüfen, ob ein Nutzer ein Abo erwerben kann.

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

Beachten Sie, dass planId die eindeutige Kennung für den Plan ist, mit der Sie den Plan im Namen des Nutzers erwerben können (siehe Datenkauf). Ist planId nicht angegeben, MUSS der DPA alle Pläne zurückgeben, die von diesem Nutzer gekauft werden können.

Fehlerfälle listet die von der DPA erwarteten Antworten im Fall eines Fehlers auf. Darüber hinaus gibt der DPA in den folgenden Fehlerfällen einen Fehler zurück:

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

Andernfalls gibt der DPA 200 OK als Antwort zurück. Das Format einer erfolgreichen EligibleResponse ist:

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

Wenn die Anfrage eine planId enthält, enthält die Antwort nur diesen Plan. Andernfalls enthält die Liste alle Pläne, die der Nutzer erwerben kann. Falls planId leer ist und die DPA die Rückgabe der Liste infrage kommender Pläne nicht unterstützt, MUSS der Fehler 400 BAD REQUEST zurückgegeben werden.

Android 5G-Erlebnisse

Mit GTAF können Mobilfunkanbieter den Meteringstatus pro Verbindungstyp für Abonnenten teilen. Die Informationen können von GTAF regelmäßig abgerufen werden oder Mobilfunkanbieter können die Informationen basierend auf internen Triggern senden.

Pull-API

Das Gerät kann die Metering-Informationen über GTAF folgendermaßen abrufen:

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

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

userKey ist das Authentifizierungstoken, das während der anfänglichen Authentifizierungsphase wie hier definiert erstellt wird.

client_id ist AndroidSystemInfo

Der Status der Meteredness wird als ENUM angegeben.

Die Datenschutzaufsichtsbehörde gibt 200 OK als Antwort zurück und fügt planInfoPerClient hinzu. Die Fehlerbehandlung für den Zusatz zur Datenverarbeitung wird hier definiert.

Im Pull-Modell agiert GTAF als Client und validiert das SSL-Zertifikat des DPA. GTAF authentifiziert sich beim DPA gemäß dem hier definierten OAuth-Verfahren.

Push API

Der Mobilfunkanbieter kann auch die Metering-Informationen mithilfe von Folgendem senden, die auf einem Trigger-Ereignis wie einer Änderung des Preismodells usw. basieren.

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

Der Zusatz zur Datenverarbeitung muss im Text der Nachricht planInfoPerClient enthalten. Die GTAF-Fehlerantworten sind hier definiert.

Im Push-Modus authentifiziert GTAF eingehende Anfragen von DPA über den Google Cloud OAuth2-Server. Die eingehenden Anfragen müssen als Dienstkonto authentifiziert werden, das im ISP-Portal für die von der DPA vertretene ASN auf die Zulassungsliste gesetzt wurde. Weitere Informationen finden Sie auch im Integrationsleitfaden.