Configurer une bibliothèque cliente

Nous vous recommandons d'utiliser Content API via les bibliothèques clientes de l'API Google. Celles-ci sont disponibles pour de nombreux langages de programmation courants et simplifient les tâches standards de l'API, comme l'authentification des utilisateurs, l'envoi de requêtes et l'analyse des réponses. Dans ce guide, nous nous appuyons sur les exemples de code de Content API pour vous montrer comment configurer la bibliothèque cliente de l'API Google pour Python, afin de l'utiliser avec Content API. Pour plus d'informations sur la configuration de 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 :

  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/

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

    1. Accédez à Merchant Center. Dans le menu Paramètres, sélectionnez Content API.
    2. Cliquez sur Authentification.
    3. Cliquez sur [+] CRÉER UNE CLÉ API .
    4. Si vous y êtes invité, lisez et acceptez les conditions d'utilisation.

    Le téléchargement de la nouvelle clé se lance automatiquement.

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

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

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

  6. Dans merchant-info.json, saisissez le texte suivant :

    {
    "merchantId": your Merchant Center merchant ID,
    "accountSampleUser": "the email address associated with your Merchant Center account"
    }
    
  7. 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/.

  8. 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.

  9. 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.