Service Accounts

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

  1. 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 :
    1. Accédez à la console Google APIs.
    2. 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.
    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. 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.

    7. Vous serez redirigé vers la page "Comptes de service" sur laquelle vous pouvez accéder à votre nouveau compte de service.
    8. 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.
  2. 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. Accédez à Accès au compte dans les paramètres de votre compte Merchant Center.
    3. 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éé.

    4. 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.
    5. 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.
    6. Répétez la procédure pour tous les autres comptes de service que vous souhaitez ajouter.
  3. 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.