Altri casi d'uso

Idoneità

GTAF POSSONO emettere la seguente richiesta di idoneità per verificare l'idoneità dell'utente 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 acquistare il piano per conto dell'utente (consulta la sezione Acquisto dati). Se planId non è specificato, l'DPA DEVE restituire tutti i piani acquistabili dall'utente.

Casi di errore elenca le risposte previste dal DPA in caso di errore. Inoltre, la DPA DEVE restituire un errore nei seguenti casi di errore:

• L'ETD restituisce un codice di errore 400 BAD REQUEST che indica a GTAF che planId non è valido.
• L'ETD restituisce un codice di errore 409 CONFLICT che indica che planId non è compatibile con il piano dati dell'utente.

In caso contrario, la DPA DEVE restituire una risposta di 200 OK. Il formato di una IdoneitàResponse riuscita è il seguente:

{
  "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 è idoneo ad acquistare. Se planId è vuoto e l'ETD non supporta la restituzione dell'elenco dei piani idonei, DEVE restituire un errore 400 BAD REQUEST.

Esperienze 5G per Android

GTAF consente agli operatori di condividere lo stato di misurazione per tipo di connessione per gli abbonati. Le informazioni possono essere estratte periodicamente da GTAF o gli operatori possono eseguirne il push in base a trigger interni.

API Pull

Il dispositivo può estrarre 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 GW o di diritto dell'API nella rete dell'operatore.

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

client_id è AndroidSystemInfo

Lo stato Misurazione è fornito come valore ENUM

DPA restituirà 200 OK di risposta e includerà planInfoPerClient La gestione degli errori per DPA è definita qui

Nel modello di pull, GTAF funge da client e convalida il certificato SSL di DPA. GTAF esegue l'autenticazione a DPA utilizzando la procedura OAuth definita qui.

API Push

L'operatore può anche inviare le informazioni di misurazione utilizzando il seguente 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

L'ETD include planInfoPerClient nel corpo del messaggio. Le risposte di errore di GTAF vengono definite qui

In modalità push, GTAF autentica le richieste in arrivo da DPA utilizzando il server OAuth2 di Google Cloud. Le richieste in arrivo devono essere autenticate come account di servizio autorizzati nel portale ISP dell'ASN rappresentato dall'ETD. Per ulteriori dettagli, consulta anche la guida all'integrazione qui.