Altri casi d'uso

Idoneità

GTAF MAY potrebbe inviare la seguente richiesta di idoneità per verificare se un utente è idoneo all'acquisto di un piano.

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

Tieni presente che planId è l'identificatore univoco del piano che può essere utilizzato per acquistarlo per conto dell'utente (vedi Acquisto di dati). Se planId non è specificato, il DPA DEVE restituire tutti i piani acquistabili dall'utente.

Casi di errore elenca le risposte previste da DPA in caso di errore. Inoltre, il DPA RESTITUISCE un errore nei seguenti casi:

• La DPA restituisce un codice di errore HTTP 400 BAD REQUEST che indica a GTAF che planId non è valido.
• Il DPA restituisce un codice di errore 409 CONFLICT che indica che planId è incompatibile con il piano dati dell'utente.

In caso contrario, il DPA RESTITUISCE una risposta 200-OK. Il formato di una EligibilityResponse corretta è:

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

Quando la richiesta include un planId, la risposta include solo quel piano. In caso contrario, l'elenco include tutti i piani che l'utente può acquistare. Nel caso in cui planId sia vuoto e il DPA non supporti la restituzione dell'elenco dei piani idonei, DEVE restituire un errore 400 BAD REQUEST.

Esperienze 5G su Android

GTAF consente agli operatori di condividere lo stato di misurazione per tipo di connessione per gli abbonati. Le informazioni possono essere recuperate periodicamente da GTAF oppure gli operatori possono trasmetterle in base a trigger interni.

API Pull

Il dispositivo può recuperare le informazioni sulla misurazione tramite GTAF utilizzando quanto segue:

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

Tieni presente che DPA (Data Plan Agent) rappresenta un server API GW o Entitlement nella rete dell'operatore.

userKey è il token di autenticazione stabilito durante la fase di autenticazione iniziale come definito qui.

client_id è AndroidSystemInfo

Lo stato Meteredness viene fornito come ENUM

DPA deve restituire una risposta 200 OK e includere planInfoPerClient La gestione degli errori per DPA è definita qui

Nel modello pull, GTAF funge da client e convalida il certificato SSL di DPA. GTAF si autentica in DPA utilizzando la procedura OAuth definita qui.

API Push

L'operatore può anche inviare le informazioni sul consumo a pagamento utilizzando quanto segue in base a un evento trigger, ad esempio la modifica del piano tariffario e così via.

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

Il DPA deve includere planInfoPerClient nel corpo del messaggio. Le risposte di errore di GTAF sono definite qui

In modalità push, GTAF autentica le richieste in entrata da DPA utilizzando il server Google Cloud OAuth2. Le richieste in entrata devono essere autenticate come un service account inserito nella lista consentita nel portale ISP per l'ASN rappresentato dal DPA. Per ulteriori dettagli, consulta anche la guida all'integrazione qui.