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 pour le langage concerné, dans le dépôt googleads/googleads-shopping-samples sur GitHub.
Pour configurer la bibliothèque cliente de l'API Google pour Python, procédez comme suit :
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/
Pour télécharger les identifiants de votre compte de service, procédez comme suit :
- Accédez à Merchant Center. Dans le menu Paramètres, sélectionnez Content API.
- Cliquez sur Authentification.
- Cliquez sur [+] CRÉER UNE CLÉ API .
- Si vous y êtes invité, lisez et acceptez les conditions d'utilisation.
Le téléchargement de la nouvelle clé se lance automatiquement.
Renommez le fichier d'identifiants téléchargé service-account.json.
Déplacez le fichier service-account.json dans votre répertoire home directory/shopping-samples/content/.
Dans home directory/shopping-samples/content/, créez un fichier merchant-info.json vide.
Dans merchant-info.json, saisissez le texte suivant :
{ "merchantId": your Merchant Center merchant ID, "accountSampleUser": "the email address associated with your Merchant Center account" }
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 s'agit pas nécessairement de votre répertoire d'accueil ni de ~/shopping-samples/content/.
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.
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.