Cas d'utilisation supplémentaires

Éligibilité

Le GTAF PEUT émettre la demande d'éligibilité suivante pour vérifier si un utilisateur est éligible à un forfait.

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

Notez que planId est l'identifiant unique du forfait qui peut être utilisé pour acheter le forfait au nom de l'utilisateur (consultez la section Achat de données). Si planId n'est pas spécifié, le DPA DOIT renvoyer tous les plans pouvant être achetés par cet utilisateur.

La section Cas d'erreur répertorie les réponses attendues de l'APD en cas d'erreur. En outre, le DPA affichera une erreur dans les cas suivants:

• Le DPA renvoie un code d'erreur 400 BAD REQUEST indiquant à la GTAF que planId n'est pas valide.
• Le DPA renvoie un code d'erreur 409 CONFLICT qui indique que planId est incompatible avec le forfait Internet de l'utilisateur.

Sinon, il renvoie une réponse "200-OK". Le format d'une réponse eligibilityResponse réussie est le suivant:

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

Lorsque la requête inclut un planId, la réponse n'inclut que ce plan. Sinon, la liste inclut tous les forfaits que l'utilisateur peut souscrire. Dans le cas où planId est vide et que le DPA ne permet pas de renvoyer la liste des forfaits éligibles, il DOIT renvoyer une erreur 400 BAD REQUEST.

Expériences Android 5G

Le GTAF permet aux opérateurs de partager l'état de mesure par type de connexion pour les abonnés. Les informations peuvent être extraites périodiquement par le GTAF, ou les opérateurs peuvent les transmettre en fonction de déclencheurs internes.

API pull

L'appareil peut extraire les informations de mesure via GTAF à l'aide des éléments suivants:

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

Notez que DPA (Data Plan Agent) représente un serveur d'API GW ou de droits d'accès dans le réseau de l'opérateur.

La clé utilisateur correspond au jeton d'authentification établi lors de la phase d'authentification initiale, tel que défini sur cette page.

client_id correspond à AndroidSystemInfo

L'état Meteredness est indiqué sous la forme d'un ENUM.

Le DPA renvoie une réponse "200 OK" et inclut planInfoPerClient. Pour traiter l'erreur du DPA, cliquez ici

Dans le modèle pull, GTAF agit en tant que client et valide le certificat SSL de l'APD. Le GTAF s'authentifie auprès du DPA à l'aide de la procédure OAuth définie sur cette page.

API Push

L'opérateur peut également transmettre les informations de mesure en utilisant les éléments suivants en fonction d'un événement déclencheur (par exemple, changement de forfait, etc.).

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

Le DPA doit inclure planInfoPerClient dans le corps du message. Les réponses d'erreur de la GTAF sont définies sur cette page.

En mode push, le GTAF authentifie les requêtes entrantes du DPA à l'aide du serveur Google Cloud OAuth2. Les requêtes entrantes doivent être authentifiées en tant que compte de service qui a été ajouté à la liste blanche dans le portail du FAI pour le numéro ASN représenté par l'APD. Consultez également le guide d'intégration sur cette page pour en savoir plus.