Configurer une bibliothèque cliente

Découvrez l'API Merchant (bêta), qui succède officiellement à Content API for Shopping.

Tenez-vous informé des nouvelles fonctionnalités, des corrections de bugs et des mises à jour de la version bêta de l'API Merchant.

Découvrez comment gérer votre entreprise et vos produits sur Google, et comment accéder de manière programmatique à des données, des insights et des fonctionnalités uniques à grande échelle. Commencer

Nous vous recommandons d'utiliser les bibliothèques clientes des API Google pour configurer Content API for Shopping. Ce guide prend les bibliothèques clientes Content API pour Python en exemple, mais elles sont disponibles pour de nombreux langages de programmation très utilisés et simplifient les tâches courantes de l'API telles que l'authentification, l'envoi de requêtes et l'analyse des réponses. Pour configurer les bibliothèques clientes pour d'autres langages, consultez le fichier README.md du langage concerné, dans le dépôt googleads/googleads-shopping-samples sur GitHub.

Remarque :Vous devez installer plusieurs bibliothèques obligatoires pour utiliser l'exemple de code en Python. C'est pourquoi nous vous recommandons de créer un environnement virtuel Python avant de continuer. Pour en savoir plus, consultez la page Installer des packages à l'aide de pip et des environnements virtuels.

Pour configurer la bibliothèque cliente de l'API Google pour Python, procédez comme suit:

1. Créez un répertoire pour les fichiers de configuration et d'authentification de la bibliothèque cliente. Dans votre répertoire d'accueil, créez les répertoires suivants:

   ~/shopping-samples/content/

   Remarque :Ce chemin d'accès ainsi que le nom du fichier merchant-info.json créé à l'étape 5 sont définis dans le fichier python/shopping/content/common.py qui se trouve dans le répertoire d'exemples de Content API téléchargé à l'étape 7.

2. Pour télécharger les identifiants de votre compte de service, procédez comme suit:

   1. Accédez à la bibliothèque d'API Google.
   2. Sélectionnez un projet dans le menu en haut de la page. Si vous n'en avez pas encore, créez-en un en cliquant sur Nouveau projet.
   3. Si vous n'avez pas déjà activé Content API for Shopping pour ce projet, recherchez-la dans la liste des API Google et activez-la.
   4. Dans la barre latérale de gauche, sélectionnez Credentials (Identifiants). Vous devrez peut-être cliquer sur la flèche vers la gauche dans l'angle supérieur gauche pour voir cette option.
   5. Pour configurer un compte de service, sélectionnez Créer des identifiants, puis Compte de service.
   6. Nommez le nouveau compte de service. Il servira également de nom d'utilisateur par défaut pour l'ID de compte de service. Enregistrez cet ID, y compris la partie située après le caractère "@", car vous en aurez besoin par la suite. Cliquez sur Créer, parcourez les étapes facultatives permettant d'accorder l'accès au projet et aux utilisateurs, puis cliquez sur OK.
   7. Vous serez redirigé vers la page "Comptes de service" sur laquelle vous pouvez accéder à votre nouveau compte de service.

3. Pour obtenir une clé privée JSON, cliquez sur le compte de service, puis sur l'onglet Clés. Cliquez sur Ajouter une clé > Créer une clé, puis sélectionnez "JSON" comme type de clé. Cliquez sur Créer pour télécharger la clé privée sur votre ordinateur. Le téléchargement de la nouvelle clé se lance automatiquement.

4. Renommez le fichier d'identifiants téléchargé service-account.json.

   Remarque :Ce nom de fichier est défini dans le fichier _constants.py, qui se trouve sous python/shopping/content/ dans le répertoire d'exemples de Content API téléchargé à l'étape 7.

5. Déplacez le fichier service-account.json dans votre répertoire home directory/shopping-samples/content/.

6. Dans home directory/shopping-samples/content/, créez un fichier merchant-info.json vide.

7. Dans merchant-info.json, ajoutez le texte suivant:

   {
   "merchantId": your Merchant Center merchant ID,
   "accountSampleUser": "the email address associated with your Merchant Center account"
   }
   

8. Ajoutez le nouveau compte de service en tant qu'utilisateur à votre compte Merchant Center. Si vous êtes un développeur tiers, vous devez demander à votre client d'effectuer cette étape pour vous.

   1. Accédez à votre compte Merchant Center.
   2. Dans les paramètres de votre compte Merchant Center, sélectionnez Personnes et accès.

   3. Cliquez sur + Ajouter une personne, puis utilisez l'ID de compte de service comme adresse e-mail du nouvel utilisateur.

      Remarque :Si vous n'avez pas noté l'ID du compte de service précédemment, accédez à la page d'administration des comptes de service et sélectionnez le projet que vous avez créé.

   4. L'utilisation du service Accounts nécessite un accès administrateur. Sélectionnez donc Administrateur.

   5. Cliquez sur Ajouter un utilisateur pour enregistrer les préférences et revenir à la liste des utilisateurs. L'ID du compte de service est listé avec le rôle utilisateur choisi.

   6. Répétez la procédure pour tous les autres comptes de service que vous souhaitez ajouter.

9. Clonez (ou téléchargez et décompressez) le dépôt GitHub googleads/googleads-shopping-samples vers n'importe quel emplacement sur votre ordinateur. Il ne doit pas nécessairement s'agir de votre répertoire d'accueil ni de ~/shopping-samples/content/.

10. Si vous avez téléchargé et décompressé le dépôt au lieu de le cloner, remplacez le nom du répertoire non compressé par googleads-shopping-samples.

11. Pour installer les exemples de dépendances requis, accédez à googleads-shopping-samples/python/ dans une fenêtre de terminal, puis exécutez la commande suivante:

    pip install -r requirements.txt
    

La bibliothèque cliente de l'API Google pour Python est désormais configurée et prête à être utilisée avec Content API. Dans la section suivante, vous allez créer et envoyer une requête pour insérer un nouveau produit.