Journal des modifications

API Data Plan Agent

Décembre 2019

  1. Définition de l'API register CPID introduite pour l'implémentation par le DPA.
  2. Ajout de suggestions sur la façon de générer le CPID et de le stocker lorsque le client demande un nouveau CPID.
  3. Ajout d'une documentation expliquant comment choisir le CPID à utiliser pour l'envoi de notifications.
  4. Clarification sur la façon de déterminer les préférences linguistiques de l'utilisateur lorsque GTAF appelle le DPA et lorsque le DPA appelle GTAF.

Octobre 2019

  1. Un nouveau CPID est requis chaque fois que nous contactons le point de terminaison CPID. Pour ce faire, ajoutez un code temporel à l'algorithme de génération de CPID.
  2. Supprimez planLanguage de Offer, qui était jusqu'à présent marqué comme champ obligatoire.

Septembre 2019

  1. Ajout de la prise en charge des notifications d'expiration des données, qui se distinguent des notifications d'avertissement d'expiration des données.

Juillet 2019

  1. Clarification des valeurs possibles de l'identifiant client.
  2. Ajout de la prise en charge des notifications de recharge de compte.
  3. Assouplissement des exigences de génération de CPID, qui ne nécessitent plus de nouveau CPID à chaque appel du point de terminaison CPID.
  4. Ajoutez la documentation pour les différentes réponses d'erreur de GTAF lors de l'appel de l'API Mobile Data Plan Sharing.

Juin 2019

  1. Mise à jour de la spécification de l'API DPA, qui exige des opérateurs qu'ils acceptent un client comme paramètre de requête.
  2. Mise à jour de l'API Mobile Data Plan Sharing, qui permet aux opérateurs de partager les informations sur le forfait d'un utilisateur pour un client spécifique avec Google.
  3. L'ordre dans lequel les offres sont présentées à l'utilisateur peut être différent de celui dans lequel elles sont fournies à GTAF.
  4. GTAF peut partager plus de 10 forfaits avec l'UI Forfait de données mobiles.

Mai 2019

  1. ExpirationTime est obligatoire, sauf si le forfait n'expire pas.
  2. Conformément à la norme RFC 6749, marquez token_type comme obligatoire dans la réponse du serveur OAuth.
  3. Renvoie le type de notifications envoyées à l'utilisateur lorsque l'opérateur transmet un état du forfait à GTAF.

Avril 2019

  1. AccountInfo est obligatoire pour les abonnés prépayés.
  2. Mise à jour de la méthode recommandée de génération de CPID pour inclure la langue dans le texte brut lors de la génération du CPID.
  3. Suppression de la compatibilité avec moreInfoUrl, operatorLogoUrl et purchaseUrl dans les offres. Ces champs n'étaient pas compatibles avec l'interface utilisateur du forfait de données mobiles. Cette modification est rétrocompatible.
  4. Ajout de la possibilité d'envoyer des notifications lorsqu'un utilisateur dépense le solde de son compte à l'aide de données en état de paiement à l'utilisation.
  5. La compatibilité avec les plages horaires flexibles a été supprimée des modules de planification. Cette modification est rétrocompatible. Par conséquent, si un opérateur nous envoie des plages horaires flexibles, la réponse sera acceptée.

Mars 2019

  1. Supprimez offerInfo.promoMessage de l'ensemble des champs obligatoires. Le MDP n'utilise pas ce champ lorsqu'il présente des offres aux utilisateurs.
  2. Correction d'un bug de documentation indiquant que le CPID doit être encodé au format URL. GTAF encode plutôt le CPID conformément à la norme RFC2396.
  3. Ajout d'exigences pour les notifications push.

Février 2019

  1. Suppression de la prise en charge du partage de PlanOffer avec Google à l'aide de l'API de partage de forfait de données.

Janvier 2019

  1. Ajout d'un guide pour mettre à jour la configuration de l'opérateur à l'aide du portail FAI.
  2. Ajout d'un guide pour l'implémentation d'OAuth pour l'API Data Plan Agent.
  3. Renommage et réorganisation du guide d'intégration de l'API Mobile Data Plan Sharing.

novembre 2018

  1. Ajout de la prise en charge des notifications d'activation de forfait.
  2. Ajout de la prise en charge d'une catégorie de trafic de module de forfait APP_STORE.

Septembre 2018

  1. Ajout d'une API permettant de signaler le consentement de l'utilisateur aux opérateurs.
  2. Ajout de la prise en charge des forfaits qui actualisent périodiquement leur quota à PlanModule et Offer.
  3. Ajout de la prise en charge des notifications d'expiration.
  4. Le nom PlanModuleState a été remplacé par PlanState. Il s'agit d'une modification de la documentation qui ne devrait pas affecter les opérateurs.

Août 2018

  1. Ajout de la possibilité pour les opérateurs de spécifier le solde du compte dans un PlanStatus.

Juin 2018

  1. Suppression des méthodes de mise à jour et d'obtention pour l'état et les offres du forfait.
  2. Le niveau de précision du solde autorisé peut être renseigné en même temps que le solde en octets ou le solde en temps.
  3. Ajout du type de connexion à une offre.
  4. Ajout du champ plan module state à PlanModule pour permettre à un opérateur d'indiquer les forfaits que l'utilisateur a achetés, mais qui n'ont pas encore été activés. Ce champ n'est pas obligatoire.
  5. DataPlan renommé Plan. Il s'agit d'une modification de la documentation qui ne devrait pas affecter les opérateurs.
  6. Ajout du champ formOfPayment à PlanOffer, permettant à un opérateur de spécifier comment l'utilisateur sera facturé pour l'achat. Par défaut, le montant est déduit du solde du forfait.

Mai 2018

  1. Mise à jour de la réponse CPID pour assurer la rétrocompatibilité de la réponse.
  2. Ajout d'un titre pour PlanStatus. Le titre sera utilisé pour renseigner l'en-tête dans l'interface utilisateur des paramètres.
  3. Ajout du nom du module et des octets utilisés pour un PlanModule.
  4. Ajout d'un rappel de réponse d'achat à GTAF.

Mars 2018

Cette mise à jour inclut les modifications suivantes apportées à l'API Data Plan Agent. Ces modifications concernent l'API Data Plan v4.2 hébergée ici.

  1. Les appels d'API suivants sont obsolètes :
    1. Interrogation du compte utilisateur (DPA_URL/{data_plan_key_string}/account).
    2. Interroger les forfaits achetés (DPA_URL/{data_plan_key_string}/purchasedPlans).
  2. Modifie l'URL que nous appelons pour l'état du forfait de données. La nouvelle URL est décrite ici. L'APD doit renvoyer une instance de PlanStatus.
  3. Modifie l'URL que nous appelons pour les offres de forfaits. La nouvelle URL est décrite ici. Le DPA est censé renvoyer une instance de PlanOffer.
  4. Modifie le corps de la requête envoyée à DPA lors de l'achat d'un forfait. Notez que l'appel d'API est le même. Le corps de la requête contient désormais une instance de TransactionRequest. Notez la suppression d'un niveau d'imbrication par rapport à la version précédente de l'API.
  5. La réponse à une demande d'achat a été modifiée. Nous tirons parti du type de devise défini par Google protobuf. En cas d'achat réussi, nous nous attendons à ce que le corps de la réponse contienne une instance de TransactionResponse.
  6. Si aucun plan_id n'est spécifié, l'API d'éligibilité DOIT renvoyer tous les forfaits auxquels l'utilisateur est éligible. Auparavant, cette étape était facultative.
  7. Ajoute un point de terminaison d'enregistrement MSISDN pour GTAF afin d'enregistrer les MSISDN pour les notifications avec le DPA.

API Google Mobile Data Plan Sharing

Mars 2018

Cette mise à jour inclut les modifications suivantes apportées à l'API Google Mobile Data Plan Sharing :

  1. Présentation de nouveaux appels d'API permettant à un opérateur de transmettre des informations sur les offres de vente incitative à GTAF, qui les transmettra ensuite aux appareils des utilisateurs. Ces nouveaux appels permettent à un opérateur de proposer des offres à Google.
  2. Ajoute un champ d'horodatage de la dernière mise à jour dans un PlanGroup.
  3. Supprime le champ du pourcentage de crédit de données de la période flexible.