Conditions préalables

Avant d'utiliser l'API Google Wallet pour une intégration, effectuez la procédure suivante :

1. Demander un compte d'émetteur pour l'API Google Wallet

Un compte d'émetteur est nécessaire pour créer et distribuer des cartes pour Google Wallet. Pour obtenir ce compte, inscrivez-vous à Google Pay & Wallet Console. Une fois inscrit, accédez à la page API Google Wallet, puis cliquez sur Créer votre première carte. Une fois que vous avez accepté les conditions d'utilisation, vous pouvez commencer à créer une classe de carte.

Ensuite, vous pouvez également essayer l'atelier de programmation.

2. Activer l'API Wallet

• Connectez-vous à Google Cloud Platform et activez l'API Google Wallet pour votre projet GCP.
• Si vous n'avez pas encore de projet GCP, créez-en un.
• Activez l'API Google Wallet.

3. Créer un compte de service

Vous devez disposer d'un compte de service et d'une clé de compte de service pour appeler l'API Google Wallet. Le compte de service est l'identité qui appelle l'API Google Wallet. La clé du compte de service contient une clé privée que votre application utilise pour s'authentifier auprès de l'API Google Wallet.

Remarque : La clé du compte de service est très sensible et doit rester confidentielle. Si elle n'est pas sécurisée, un tiers peut l'utiliser pour effectuer des appels d'API en votre nom. Si elle est compromise, vous devez immédiatement la révoquer, en générer une nouvelle et mettre à jour votre application pour qu'elle utilise la nouvelle clé.

Créez un compte de service :

• 1. Créez un compte de service dans la console Google Cloud, en fournissant les informations suivantes :
  • Nom du compte de service (par exemple, Client Web Wallet)
  • ID du compte de service (par exemple, my-service-account)
• 2. Cliquez sur CRÉER ET CONTINUER.
• 3. Cliquez sur OK.

Créez une clé de compte de service :

• 1. Sélectionnez votre compte de service. Exemple : [e-mail].
• 2. Cliquez sur l'élément de menu CLÉS en haut de la page.
• 3. Cliquez sur AJOUTER UNE CLÉ, puis sur Créer une clé.
• 4. Sélectionnez le type de clé JSON.
• 5. Cliquez sur CRÉER pour créer et télécharger la clé du compte de service.

4. Autoriser le compte de service

Pour appeler l'API, vous devez autoriser le compte de service. Pour cela, vous devez lui donner un accès suffisant pour qu'il puisse gérer votre compte émetteur.

• Accédez à la page Utilisateurs dans Google Pay and Wallet Console.
• 1. Cliquez sur Inviter un utilisateur.
• 2. Ajoutez l'adresse e-mail du compte de service. Exemple : [e-mail].
• 3. Sélectionnez le niveau d'accès Développeur.
• 4. Cliquez sur Inviter.

5. Créez une classe.

Avant de pouvoir créer et ajouter un TransitObject, vous devez créer une TransitClass. Pour cela, connectez-vous à Google  Pay and Wallet Console, accédez à la page API Google Wallet et créez une classe de transports en commun.

1. Vérifiez que vous vous trouvez dans l'onglet Gérer.
2. Le message Vous êtes en mode démo s'affiche si vous créez une carte pour la première fois.
3. Toujours en mode démo, cliquez sur Configurer des comptes de test pour ajouter des comptes de test. Seuls ces comptes peuvent enregistrer les cartes lorsque votre compte d'émetteur est en mode démo.
4. Cliquez sur Créer une classe.
5. Sélectionnez Transports en commun.
6. Remplissez tous les champs obligatoires marqués d'un astérisque (*).
7. Cliquez sur Créer une classe.

Répétez cette procédure si vous avez besoin de plusieurs titres de transport.

Reportez-vous au modèle de mise en page pour découvrir comment ces attributs sont représentés dans la carte.

Remarque : Si vous devez gérer et créer un titre de transport de manière dynamique, envisagez d'automatiser la création de classes de transports en commun à l'aide de l'API Web.

Une fois que vous avez créé une classe de transports en commun, passez à Ajouter des cartes à Google Wallet.