Guide d'intégration

Obtenir une clé privée

Utiliser l'interface d'intégration

Pour intégrer l'API, vous devez créer un projet Google Cloud. Ensuite, créez 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ération manuelle de la clé

Si l'interface ci-dessus ne fonctionne pas, procédez comme suit:

  1. Accédez à Google Cloud Console.
  2. Choisissez le projet via lequel l'API sera accessible.
  3. Dans le menu d'administration d'IAM (sur la 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 le 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 en utilisant un compte Google propriétaire du projet. Nous allons ajouter le compte Google à la liste blanche pour accéder aux points de terminaison de l'API Mobile Data Plan Sharing.
  2. Associez le compte de service à l'opérateur sur le portail du FAI Google. L'opérateur peut effectuer cette association en accédant à API Access (Accès API).

Activer la bibliothèque

Une fois la liste blanche ajoutée:

  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 aux API

Pour tester votre accès aux méthodes secondaires 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 clé de votre compte de service.

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

    Notez que le jeton d'accès expire dans l'heure qui suit. Avant de réexécuter la commande ci-dessus pour obtenir un nouveau jeton d'accès, exécutez oauth2l reset pour vider le cache local.

  3. Testez les appels comme suit. YOUR-ASN doit correspondre à l'un des ASN que vous nous envoyez lorsque nous avons configuré la GTAF pendant le processus d'intégration. ACCESS-TOKEN-OBTAINED est le résultat de la commande oauth2l fetch ci-dessus. PLAN_STATUS est le corps de la requête PlanStatus que vous souhaitez envoyer au 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 sur les 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 recommandé qu'un groupe d'utilisateurs autorisés ait la propriété du projet. Dans Google Cloud Console, sous IAM et menu d'administration, vous pouvez ajouter des membres (y compris des comptes Google Groupes) en tant que propriétaires du projet.