Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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.
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 :
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.
Si vous n'avez pas encore activé Content API for Shopping pour ce projet, recherchez-la dans la liste des API Google et activez-la.
Dans la barre latérale de gauche, sélectionnez Identifiants. Vous devrez peut-être cliquer sur la flèche vers la gauche en haut à gauche pour voir cette option.
Pour configurer un compte de service, sélectionnez Créer des identifiants, puis Compte de service.
Attribuez un nom au 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.
Vous serez redirigé vers la page "Comptes de service" sur laquelle vous pouvez accéder à votre nouveau compte de service.
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.
La nouvelle clé est téléchargée 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":yourMerchantCentermerchantID,"accountSampleUser":"the email address associated with your Merchant Center account"}
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.
Dans les paramètres de votre compte Merchant Center, sélectionnez Personnes et accès.
Cliquez sur + Ajouter une personne, puis utilisez l'ID de compte de service comme adresse e-mail du nouvel utilisateur.
L'utilisation du service Accounts nécessite un accès administrateur. Sélectionnez donc Administrateur.
Cliquez sur Ajouter un utilisateur pour enregistrer les préférences et revenir à la liste des utilisateurs. L'ID de compte de service s'affiche avec le rôle utilisateur choisi.
Répétez la procédure pour tous les autres comptes de service que vous souhaitez ajouter.
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/.
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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/13 (UTC).
[null,null,["Dernière mise à jour le 2025/08/13 (UTC)."],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and represents the future of product data integration.\u003c/p\u003e\n"],["\u003cp\u003eTo use the Merchant API, you need to set up the Google API client libraries, which are available for various programming languages and simplify API interactions.\u003c/p\u003e\n"],["\u003cp\u003eSetup involves creating necessary directories, downloading service account credentials, configuring a \u003ccode\u003emerchant-info.json\u003c/code\u003e file, and adding the service account to your Merchant Center account.\u003c/p\u003e\n"],["\u003cp\u003eYou'll need to clone the \u003ccode\u003egoogleads/googleads-shopping-samples\u003c/code\u003e GitHub repo and install the required dependencies using \u003ccode\u003epip install -r requirements.txt\u003c/code\u003e.\u003c/p\u003e\n"]]],["The content details the setup for using the Google API client library with the new Merchant API beta, an evolution of the Content API for Shopping. Key steps include: creating directories for configuration and authentication files; downloading service account credentials (including generating a JSON private key); setting up `merchant-info.json` with Merchant Center ID and email; adding the service account as a Merchant Center user with Admin access; cloning or downloading the `googleads-shopping-samples` repository; and installing required Python dependencies via `pip`.\n"],null,["# Set up a client library\n\nWe recommend using the\n[Google API client libraries](/api-client-library) to set\nup the Content API for Shopping. This guide uses the Python Content API client\nlibraries as an example, but they're available for many popular programming\nlanguages and simplify common API tasks like authentication, sending requests,\nand parsing responses. For help setting up client libraries for\nother languages, see the **README.md** for the language within the\n[googleads/googleads-shopping-samples](//github.com/googleads/googleads-shopping-samples)\nrepo on GitHub.\n| **Note:** You need to install several required libraries to use the sample code in Python. For this reason, we recommend creating a Python virtual environment before you proceed. For more information, see [Installing packages using pip and virtual environments](//packaging.python.org/guides/installing-using-pip-and-virtual-environments/).\n\nTo set up the Google API client library for Python, complete the following steps:\n\n1. Create a directory for the client library's configuration and authentication\n files. Within your home directory, create the following directories:\n\n **\\~/shopping-samples/content/**\n | **Note:** This path, as well as the filename for the **merchant-info.json** file created in step 5, are defined in the **python/shopping/content/common.py** file within the Content API samples directory downloaded in step 7.\n2. To download your service account credentials, complete the following steps:\n\n 1. Go to the [Google API library](//console.cloud.google.com/apis/library).\n 2. Select a project in the menu at the top of the page. If you don't have one yet, create one by clicking **New project**.\n 3. If you haven't already enabled the Content API for Shopping for this project, then search for it in the list of Google APIs and enable it.\n 4. In the sidebar on the left, select **Credentials**. You may need to click the left-pointing arrow at the top left to see this.\n 5. To set up a service account, select **Create credentials** , and then **Service account**.\n 6. Name the new service account. This also serves as the default username for the service account ID. Record the service account ID, including the part after the '@' character, for later use. Click **Create** , then go through the optional steps of granting access to project and users, and click **Done**.\n 7. You will be directed to the Service Accounts page where your new service account can be accessed.\n3. To obtain a JSON private key, click the service account, then the **Keys**\n tab. Click **Add key** \\\u003e **Create new key** , and then select JSON as the\n key type. Click **Create** to download the private key to your computer.\n The new key downloads automatically.\n\n4. Rename the downloaded credentials file to **service-account.json**.\n\n | **Note:** This filename is defined in the **_constants.py** file, which is located in **python/shopping/content/** within the Content API samples directory downloaded in step 7.\n5. Move the **service-account.json** file to your\n **\u003cvar translate=\"no\"\u003ehome directory\u003c/var\u003e/shopping-samples/content/**.\n\n6. In your **\u003cvar translate=\"no\"\u003ehome directory\u003c/var\u003e/shopping-samples/content/** , create an\n empty **merchant-info.json** file.\n\n7. In **merchant-info.json**, add the following text:\n\n {\n \"merchantId\": \u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-err\"\u003eyour\u003c/span\u003e\u003cspan class=\"devsite-syntax-w\"\u003e \u003c/span\u003e\u003cspan class=\"devsite-syntax-err\"\u003eMercha\u003c/span\u003e\u003cspan class=\"devsite-syntax-kc\"\u003ent\u003c/span\u003e\u003cspan class=\"devsite-syntax-w\"\u003e \u003c/span\u003e\u003cspan class=\"devsite-syntax-err\"\u003eCe\u003c/span\u003e\u003cspan class=\"devsite-syntax-kc\"\u003enter\u003c/span\u003e\u003cspan class=\"devsite-syntax-w\"\u003e \u003c/span\u003e\u003cspan class=\"devsite-syntax-err\"\u003emercha\u003c/span\u003e\u003cspan class=\"devsite-syntax-kc\"\u003ent\u003c/span\u003e\u003cspan class=\"devsite-syntax-w\"\u003e \u003c/span\u003e\u003cspan class=\"devsite-syntax-err\"\u003eID\u003c/span\u003e\u003c/var\u003e,\n \"accountSampleUser\": \"\u003cvar translate=\"no\"\u003ethe email address associated with your Merchant Center account\u003c/var\u003e\"\n }\n\n8. Add the new service account as a user to your Merchant Center account. If you\n are a third-party developer, you will need to have your client do this step\n for you.\n\n 1. Go to your [Merchant Center account](//merchants.google.com).\n 2. In the settings of your Merchant Center account, select **People and\n access**.\n 3. Click **+ Add person** and use the service account ID as the email address\n for the new user.\n\n | **Note:** If you did not take note of the service account ID earlier, go to the [Service Accounts administration\n | page](//console.developers.google.com/iam-admin/serviceaccounts) and select the project you created.\n 4. The use of the `Accounts` service requires Admin access, so select\n **Admin**.\n\n 5. Click **Add user** to save preferences and be returned to the list of\n users. The service account ID is listed with the chosen user role.\n\n 6. Repeat the process for all other service accounts you want to add.\n\n9. Clone (or download and unzip) the\n [googleads/googleads-shopping-samples](//github.com/googleads/googleads-shopping-samples)\n GitHub repo to any location on your computer; it does not have to be in your\n home directory or in **\\~/shopping-samples/content/**.\n\n10. If you downloaded and unzipped the repo, instead of cloning it, rename the\n unzipped directory to **googleads-shopping-samples**.\n\n11. To install the required sample dependencies, in a terminal window,\n navigate to **googleads-shopping-samples/python/** and run:\n\n pip install -r requirements.txt\n\nYou now have the Google API client library for Python configured and ready to use with the Content API. In the next section, you'll create and send a request to insert a new product."]]
