rocket
Découvrez l'
API Merchant, qui remplace officiellement Content API for Shopping.
update
Dernières actualités
concernant les nouvelles fonctionnalités, les corrections de bugs et les mises à jour de l'API Merchant.
add_alert
Remarque : Content API for Shopping sera abandonnée le 18 août 2026.
Service Accounts
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Les comptes de service sont des comptes Google spéciaux au moyen desquels les applications peuvent accéder par programmation aux API Google via OAuth 2.0. Un compte de service utilise un flux OAuth 2.0 qui ne nécessite aucune autorisation humaine.
Il utilise à la place un fichier de clé auquel seule votre application a accès. Ce guide explique comment accéder à Content API for Shopping à l'aide des comptes de service.
Remarque:Les applications qui utilisent des comptes de service pour l'authentification ne peuvent accéder qu'à votre propre compte Merchant Center. Si vous écrivez une application tierce qui doit accéder aux comptes Merchant Center de vos clients, consultez plutôt le guide Autoriser les requêtes.
Prérequis
Procédure d'utilisation d'un Service Account pour accéder à Content API for Shopping
- Générez des identifiants de compte de service ou accédez aux identifiants publics que vous avez déjà générés. Vous devez créer un ID client OAuth 2.0 et obtenir un fichier de clé privée *.json :
- Accédez à la console Google APIs.
- Sélectionnez un projet dans le menu déroulant 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 déjà 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 Credentials (Identifiants).
Vous devrez peut-être cliquer sur la flèche vers la gauche dans l'angle supérieur 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.
Le choix du rôle pour le compte de service n'a aucune incidence sur les appels pouvant être effectués auprès de Content API. En effet, l'accès aux méthodes de Content API est déterminé par le rôle associé à l'ID du compte de service dans Merchant Center. Si vous ne savez pas quoi choisir, sélectionnez simplement Projet > Lecteur.
- 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.
- 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.
- Accédez à votre compte Merchant Center.
- Accédez à Accès au compte dans les paramètres de votre compte Merchant Center.
- Cliquez sur + Ajouter un utilisateur et utilisez l'ID de compte de service comme adresse e-mail du nouvel utilisateur.
Si vous n'avez pas noté l'ID de compte de service précédemment, accédez à la page d'administration Comptes de service et sélectionnez le projet que vous avez créé.
- Spécifiez les préférences d'accès des utilisateurs et de notifications par e-mail pour le compte de service. Sachez que l'utilisation du service
Accounts nécessite un accès administrateur.
- Cliquez sur Ajouter un utilisateur pour enregistrer les préférences et revenir à la liste des utilisateurs. L'ID de compte de service doit s'afficher avec le rôle utilisateur choisi.
- Répétez la procédure pour tous les autres comptes de service que vous souhaitez ajouter.
- Vous pouvez maintenant accéder à votre compte Merchant Center à l'aide du compte de service via le flux Identifiants par défaut de l'application Google ou directement via le flux du compte de service. Les exemples de Content API for Shopping montrent comment utiliser ces deux flux pour les identifiants de compte de service dans chaque langage de programmation compatible.
Consultez les exemples de code pour tester votre nouveau compte de service et connaître les modifications nécessaires pour utiliser les comptes de service dans votre propre code.
Questions fréquentes
- Puis-je me connecter à l'interface utilisateur Merchant Center avec mon compte de service ?
- Non, les comptes de service ne sont pas des comptes Google standards. Ils ne peuvent pas accéder à l'interface utilisateur de Merchant Center.
- À quelle fréquence dois-je actualiser les jetons d'accès au compte de service ?
- Les jetons d'accès expirent une heure après leur émission par le serveur d'autorisation Google OAuth 2.0. Lorsqu'un jeton d'accès expire, l'application doit récupérer un autre jeton d'accès à l'aide de la bibliothèque cliente.
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/29 (UTC).
[null,null,["Dernière mise à jour le 2025/08/29 (UTC)."],[[["\u003cp\u003eService accounts enable applications to programmatically access Google APIs, including the Content API for Shopping, using OAuth 2.0 without human intervention.\u003c/p\u003e\n"],["\u003cp\u003eTo utilize service accounts, you need to generate service account credentials, add the service account as a user in your Merchant Center account, and then access your Merchant Center account using either the Google Application Default Credentials flow or the service account flow.\u003c/p\u003e\n"],["\u003cp\u003eApplications authenticated with service accounts can only access your own Merchant Center account; for third-party applications needing access to client accounts, refer to the Authorizing Requests guide.\u003c/p\u003e\n"],["\u003cp\u003eService accounts cannot be used to sign in to the Merchant Center UI and access tokens expire after one hour, requiring the application to fetch a new one using the client library.\u003c/p\u003e\n"]]],["Service accounts allow applications to access the Content API for Shopping programmatically. Key actions include: generating service account credentials by creating an OAuth 2.0 Client ID and a JSON private key file via the Google API Console, and adding the service account as a user within the Merchant Center account, specifying access and notification preferences. To access the Merchant center, you can use Google Application Default Credentials or a service account flow, with example code available. Access tokens expire hourly, requiring renewal.\n"],null,["# Service accounts are special Google accounts that can be used by\napplications to access Google APIs programmatically via OAuth 2.0. A service\naccount uses an OAuth 2.0 flow that does not require human authorization.\nInstead, it uses a key file that only your application can access. This guide\ndiscusses how to access the Content API for Shopping with service accounts.\n\n**Note:** Applications using service accounts\nfor authentication can only access your own Merchant Center account. If you are\nwriting a third-party application that needs access to your clients' Merchant\nCenter accounts, please see the [Authorizing Requests](/shopping-content/guides/how-tos/authorizing)\nguide instead.\n\nPrerequisites\n-------------\n\n- A [Merchant Center](//merchants.google.com/) account.\n\nSteps to using a service account to access the Content API for Shopping\n-----------------------------------------------------------------------\n\n1. Generate service account credentials or access the public credentials you've already generated. You will need to create an OAuth 2.0 Client ID and obtain a \\*.json private key file:\n 1. Go to the [Google API Console](https://console.cloud.google.com/apis/library).\n 2. Select a project in the drop-down menu at the top of the page. If you do not have one yet, create one by clicking **NEW PROJECT**.\n 3. If you have not 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\n The choice of role for the service account will not\n have any effect on what calls can be made to the Content API, as access to\n Content API methods is determined instead by the role associated with the\n service account ID in Merchant Center. If you are unsure what to pick, just\n pick **Project \\\u003e Viewer**.\n 7. You will be directed to the Service Accounts page where your new service account can be accessed.\n 8. To obtain a JSON private key, click on the service account, then the **KEYS** tab. Click **ADD KEY \\\u003e Create new key** and then select JSON as the key type. Click **CREATE** to download the private key to your computer.\n2. Add the new service account as a user to your Merchant Center account. If you are a third-party developer, you will need to have your client do this step for you.\n 1. Go to your [Merchant\n Center account](//merchants.google.com/).\n 2. Go to **Account Access** in the settings of your Merchant Center account.\n 3. Click **+ Add user** and use the service account ID as the email address for the new user.\n\n If you did not take note of the\n service account ID earlier, go to the [Service\n Accounts](//console.developers.google.com/iam-admin/serviceaccounts/) administration page and select the project you created.\n 4. Specify the **User access** and **Email notifications** preferences for the service account. Note that the use of the `Accounts` service requires **Admin** access.\n 5. Click **Add user** to save preferences and be returned to the list of users. The service account ID should be listed with the chosen user role.\n 6. Repeat the process for all other service accounts you want to add.\n3. Now you can access your Merchant Center account using the service account either by using the [Google Application\n Default Credentials](/identity/protocols/application-default-credentials) flow or by using the [service account flow](/identity/protocols/OAuth2ServiceAccount) directly. The Content API for Shopping [Samples](/shopping-content/guides/libraries) show how to use both flows for service account credentials in each supported programming language. Please check out the code samples to try out your new service account and to learn what changes you will need to use service accounts in your own code.\n\nFrequently asked questions\n--------------------------\n\nCan I sign in to the Merchant Center UI with my service account?\n: No, service accounts are not regular Google accounts and cannot access the\n Merchant Center UI.\n\nHow often do I need to refresh service account access tokens?\n: Access tokens expire one hour after they are issued by the Google OAuth 2.0\n Authorization Server. When an access token expires, the application should use\n the client library to fetch another access token."]]
