Guide d'intégration

Obtenir une clé privée

Utiliser l'interface d'intégration

Pour l'intégrer à l'API, vous devez créer un projet Google Cloud. Créez ensuite un compte de service et obtenez une clé privée. Pour commencer, cliquez sur le bouton suivant :

Créer un compte de service

Générer manuellement une clé

Si l'interface ci-dessus ne fonctionne pas, veuillez essayer ce qui suit :

  1. Accédez à la console Google Cloud.
  2. Choisissez le projet à l'aide duquel l'API sera accessible.
  3. Dans le menu "IAM et administration" à gauche, recherchez les comptes de service et créez-en un qui sera le propriétaire du projet.
  4. Une fois le compte de service créé, vous devriez recevoir une clé privée.

Ajouter un compte de service à la liste blanche

Une fois que vous avez créé un compte de service :

  1. Contactez l'équipe GTAF à l'adresse mdp-support@google.com avec un compte Google qui est le propriétaire du projet. Nous ajouterons le compte Google à la liste blanche pour qu'il puisse accéder aux points de terminaison de l'API Mobile Data Plan Sharing.
  2. Associez le compte de service au fournisseur sur le portail Google ISP. Le transporteur peut effectuer cette association en accédant à Accès à l'API.

Activer la bibliothèque

Une fois l'adresse ajoutée à la liste blanche :

  1. Consultez le site Google Cloud Console.
  2. Assurez-vous d'avoir sélectionné le bon projet dans le menu déroulant de la barre de menu supérieure.
  3. Activez l'API Mobile Data Plan Sharing dans la bibliothèque d'API.
  4. Activez l'API Preprod Mobile Data Plan Sharing dans la bibliothèque d'API.

Tester l'accès à l'API

Pour tester votre accès aux méthodes côté Google :

  1. Installez oauth2l.

  2. Obtenez un jeton d'accès pour votre compte de service comme suit. your-service-account-key-file.json est un fichier de clé de votre compte de service.

    > oauth2l fetch --json your-service-account-key-file.json dataplansharing

    Notez que le jeton d'accès expire au bout d'une heure environ. Avant d'exécuter à nouveau la commande ci-dessus pour un nouveau jeton d'accès, exécutez oauth2l reset pour vider le cache local.

  3. Émettez des appels de test comme suit. YOUR-ASN doit être l'un des ASN que vous nous avez envoyés lors de la configuration de GTAF pendant le processus d'intégration. ACCESS-TOKEN-OBTAINED correspond au résultat de la commande oauth2l fetch ci-dessus. PLAN_STATUS est le corps de la requête PlanStatus que vous souhaitez envoyer à GTAF.

    > url_domain="mobiledataplansharing.googleapis.com"
> url_path="v1/operators/YOUR-ASN/clients/mobiledataplan/users/USER_KEY/planStatus"
> curl -H "Content-Type: application/json" \
       -d 'PLAN_STATUS' \
       -X POST "https://$url_domain/$url_path?access_token=ACCESS-TOKEN-OBTAINED"

Appels d'API programmatiques

Suivez les instructions pour effectuer des appels autorisés aux méthodes côté Google, avec le champ d'application OAuth suivant :

https://www.googleapis.com/auth/dataplansharing

Partager la propriété d'un projet

Bien que la configuration initiale implique un seul compte Google, il est conseillé qu'un groupe d'utilisateurs autorisés soit propriétaire du projet. Dans la console Google Cloud, sous le menu "IAM et administration", vous pouvez ajouter de nouveaux membres (y compris un compte de groupe Google) en tant que propriétaires du projet.