Journal des modifications

API Data Plan Agent

Décembre 2019

  1. Introduction de la définition de l'API registre CPID que l'APD doit implémenter.
  2. Ajout de suggestions pour générer le CPID et le stocker lorsque le client demande un nouveau CPID.
  3. Ajout d'une documentation expliquant comment choisir le CPID à utiliser pour envoyer des notifications.
  4. Clarification de la manière de déterminer les préférences linguistiques de l'utilisateur lorsque la GTAF appelle le DPA et lorsque le DPA appelle le GTAF.

octobre 2019

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

Septembre 2019

  1. Ajout de la compatibilité avec les notifications d'expiration des données, à la différence des notifications d'avertissement d'expiration des données.

Juillet 2019

  1. Clarifications apportées aux valeurs possibles des identifiants client.
  2. Ajout de la compatibilité avec les notifications de recharge de compte
  3. Assouplir les exigences concernant la génération de CPID pour ne pas exiger un nouveau CPID chaque fois que le point de terminaison CPID est appelé
  4. Ajoutez de la documentation pour les différentes réponses d'erreur de la 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 exigeant que les opérateurs acceptent un _clientid comme paramètre de requête.
  2. Mise à jour de l'API Mobile Data Plan Sharing qui permet aux opérateurs de partager avec Google les informations sur le forfait d'un utilisateur pour un client particulier.
  3. L'ordre dans lequel les offres sont présentées à l'utilisateur peut être différent de celui dans lequel les offres sont présentées aux GTAF.
  4. Le GTAF peut partager plus de 10 forfaits avec l'interface utilisateur du forfait Internet mobile.

Mai 2019

  1. Veuillez indiquer une date d'expiration, sauf si le forfait n'expire pas.
  2. Conformément à la norme RFC 6749, marquez le jeton token_type comme obligatoire dans la réponse du serveur OAuth.
  3. Renvoyez le type de notifications envoyées à l'utilisateur lorsque l'opérateur transmet l'état du forfait à GTAF.

Avril 2019

  1. AccountInfo est obligatoire pour les abonnés prépayés.
  2. Mettez à jour la méthode de génération de CPID recommandée 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 Internet mobile. La modification est rétrocompatible.
  4. Ajout de la possibilité d'envoyer des notifications lorsqu'un utilisateur dépense un solde de compte à l'aide des données d'un état de paiement à l'usage.
  5. Suppression de la prise en charge des fenêtres d'horaires flexibles dans les modules du plan. La modification est rétrocompatible. Ainsi, si un opérateur nous envoie des fenêtres avec horaires flexibles, la réponse sera acceptée.

Mars 2019

  1. Supprimez offerInfo.promoMessage de l'ensemble des champs obligatoires. MDP n'utilise pas ce champ pour présenter des offres aux utilisateurs.
  2. Correction d'un bug dans la documentation indiquant que le CPID doit être encodé au format URL À la place, le GTAF encode le CPID conformément au protocole RFC2396.
  3. Ajout d'exigences pour les notifications push.

Février 2019

  1. Suppression de la compatibilité avec PlanOffer avec Google via l'API de partage de forfait.

Janvier 2019

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

novembre 2018

  1. Ajout de la compatibilité avec les notifications d'activation de forfait.
  2. Ajout d'une assistance pour une catégorie de trafic du module de forfait APP_STORE.

Septembre 2018

  1. Ajout d'une API pour signaler le consentement de l'utilisateur aux opérateurs.
  2. Ajout de la compatibilité avec les plans qui actualisent périodiquement leur quota vers PlanModule et Offer.
  3. Ajout de la prise en charge des notifications d'expiration.
  4. PlanModuleState a été renommé PlanState. Cette modification de la documentation 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. Mise à jour supprimée, obtenir des méthodes pour l'état et les offres du forfait.
  2. Possibilité de renseigner le niveau de solde approximatif en même temps que le solde d'octets ou le solde temporel.
  3. Ajout d'un type de connexion à une offre
  4. Ajout du champ État du module de forfait à 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é en Plan. Il s'agit d'une modification de la documentation qui ne devrait pas affecter les opérateurs.
  6. Ajout du champ formOfPayment à PlanOffer, ce qui permet à un opérateur de spécifier la manière dont l'utilisateur sera facturé pour l'achat. Cette valeur est déduite par défaut du solde du forfait.

Mai 2018

  1. Mise à jour de la réponse CPID pour garantir 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 d'un nom de module et d'octets utilisés pour un PlanModule.
  4. Ajout d'un rappel de réponse d'achat à la GTAF.

Mars 2018

Cette mise à jour inclut les modifications suivantes apportées à l'API Data Plan Agent. Ces modifications sont relatives à la version 4.2 de l'API Data Plan, qui sont hébergées sur cette page.

  1. Abandonne les appels d'API suivants :
    1. Interroger le 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 appelée pour l'état du forfait Internet. Pour en savoir plus sur la nouvelle URL, cliquez ici. Le DPA doit renvoyer une instance de PlanStatus.
  3. Modifie l'URL appelée pour les offres du forfait. Pour en savoir plus sur la nouvelle URL, cliquez ici. Le DPA doit renvoyer une instance de PlanOffer.
  4. Modifie le corps de la demande envoyée à l'APD lors de l'achat d'un forfait. Notez que l'appel d'API est identique. 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 changé. Nous utilisons le type de devise défini par Google Buffers. En réponse à un achat réussi, le corps de la réponse doit contenir une instance de TransactionResponse.
  6. Si plan_id n'est pas spécifié, l'API d'éligibilité DOIT renvoyer tous les forfaits de données auxquels l'utilisateur est éligible. Auparavant, cette opération était facultative.
  7. Ajoute un point de terminaison d'enregistrement MSISDN pour la GTAF afin d'enregistrer les MSISDN pour les notifications avec l'APD.

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ésente de nouveaux appels d'API permettant à un opérateur de transmettre les informations sur les offres de vente incitative au GTAF afin de les transmettre aux appareils des utilisateurs. Ces nouveaux appels permettent à un opérateur de transmettre des offres à Google.
  2. Introduit un champ de date et d'heure de la dernière mise à jour dans un groupe de plans.
  3. Supprime le champ de pourcentage de crédit des données de la fenêtre flexible.