Aperçu

Pour utiliser efficacement l'API Merchant, il est important de comprendre les concepts d'enregistrement, d'authentification et d'autorisation. Ils ont des objectifs distincts pour garantir un accès sécurisé et correct aux données Merchant Center.

Terminologie

L'enregistrement, l'authentification et l'autorisation sont liés, mais chacun a une signification et un objectif distincts.

  • Authentification : dans ce processus, le service vérifie l'identité de l'utilisateur ou de l'application qui effectue une requête API. L'API Merchant utilise des mécanismes Google standards tels que OAuth 2.0. L'utilisation de clés API pour l'authentification n'est pas acceptée et entraîne des erreurs d'authentification. Pour en savoir plus, consultez Authentifier les requêtes et S'authentifier avec votre propre compte.
  • Autorisation : ce processus détermine les actions que l'utilisateur ou l'application authentifiés sont autorisés à effectuer à l'aide d'un compte Merchant Center. Elle répond à la question "Que pouvez-vous faire ?" en fonction des rôles et des autorisations accordés à l'utilisateur authentifié dans le compte Merchant Center. Par exemple, un utilisateur peut être autorisé à lire les données produit, mais pas à modifier les paramètres du compte.
  • Enregistrement : pour l'API Merchant, il s'agit d'un processus de configuration unique qui permet à Google de vous envoyer des annonces importantes sur le service pour les comptes marchands que vous gérez. L'enregistrement ajoute vos adresses e-mail de développeur à votre compte Merchant Center principal et l'associe aux ID de projet Google Cloud que vous utilisez pour l'authentification. Cette association permet à votre application de recevoir des annonces sur le service pour tous les comptes marchands que vous gérez. Pour en savoir plus, consultez Créer un projet Google Cloud.

Inscription

Le processus d'enregistrement est crucial pour permettre à votre application d'utiliser l'API Merchant. Voici quelques points à retenir :

Prérequis

Pour vous inscrire à l'API Merchant, vous devez disposer des éléments suivants :

  • Compte Merchant Center : vous devez disposer d'un compte Merchant Center.
  • Accès administrateur : le compte utilisateur Google que vous utilisez pour lancer l'appel d'enregistrement doit disposer de droits d'administrateur sur le compte Merchant Center que vous enregistrez.
  • Projet Google Cloud : votre application doit être associée à un projet Google Cloud. Ce projet fournit les identifiants nécessaires (comme les ID client OAuth 2.0) pour que votre application s'authentifie.

Pourquoi vous ne pouvez pas enregistrer un projet Google Cloud partagé

Les outils tels que Google OAuth Playground et APIs Explorer utilisent des projets Google Cloud partagés appartenant à Google. Vous ne pouvez pas vous inscrire avec des projets partagés pour les raisons suivantes :

  • Ils sont destinés aux tests et à l'exploration, et non à l'identité des applications de production.
  • Enregistrer ces adresses impliquerait d'associer l'outil partagé à vos données Merchant Center spécifiques, ce qui pourrait entraîner des communications indésirables.

Votre application a besoin de son propre projet Google Cloud dédié afin que les communications de l'API Merchant que Google vous envoie restent pertinentes pour votre utilisation réelle.

Toutefois, vous pouvez utiliser les applications Web OAuth Playground et API Explorer pour utiliser l'API Merchant à des fins d'expérimentation et de cas d'utilisation hors production.

Trouver votre ID de projet Google Cloud

Vous trouverez l'ID du projet et le numéro du projet dans la console Google Cloud. Pour en savoir plus, consultez Trouver le nom, le numéro et l'ID du projet.

Effectuer l'appel d'enregistrement

Enregistrez-vous à l'aide de la méthode registerGcp dans la sous-API Accounts. Cet appel associe votre numéro de projet Google Cloud au compte Merchant Center.

Au cours de la procédure, vous devez fournir une adresse e-mail associée à un utilisateur individuel que vous utilisez pour appeler l'API. Cette adresse e-mail doit appartenir à un utilisateur disposant d'un accès administrateur au compte Merchant Center.

À propos du champ d'adresse e-mail

Une communication efficace est essentielle. Google envoie des informations importantes, des annonces obligatoires sur le service, des enquêtes auprès des développeurs et d'autres opportunités liées à la Merchant API. Une bonne gestion des contacts permet de s'assurer que ces informations parviennent aux bonnes personnes.

  • Objectif : Google utilise cette adresse e-mail comme contact principal pour les communications liées aux API.
  • Whose email (Adresse e-mail de qui) : il doit s'agir de l'adresse e-mail d'un développeur ou d'un contact technique clé responsable de l'intégration de l'API.
  • Bonnes pratiques :
    • À FAIRE : Utilisez l'adresse e-mail professionnelle d'une personne.
    • À ÉVITER : utiliser des alias de groupe généraux ou des adresses e-mail de compte de service. Nous destinons les communications à des destinataires humains.

La ressource users pour la gestion des contacts

Bien que l'adresse e-mail de l'appel d'enregistrement définisse un contact initial, la méthode la plus efficace pour gérer les contacts et les autorisations consiste à utiliser la ressource accounts.users de l'API Merchant ou les paramètres de gestion des utilisateurs dans l'UI Merchant Center. Pour en savoir plus sur l'utilisation de Merchant Center, consultez Gérer les utilisateurs de votre compte.

Pour profiter de ces fonctionnalités :

  1. Ajoutez tous les développeurs : ajoutez les développeurs travaillant sur l'intégration de l'API en tant qu'utilisateurs du compte Merchant Center.
  2. Attribuer le rôle API_DEVELOPER : en plus des rôles standards (Administrateur, Standard), vous pouvez attribuer le rôle API_DEVELOPER aux utilisateurs. En particulier, attribuez ce rôle aux utilisateurs qui doivent recevoir des communications liées à l'API. Vous pouvez le combiner avec d'autres rôles.
  3. Avantages :
    • Séparation claire : dissocie la gestion des contacts de l'API de l'enregistrement unique.
    • Flexibilité : mettez à jour les contacts à mesure que les membres de l'équipe changent.
    • Communication ciblée : permet de s'assurer que les actualités spécifiques aux API sont envoyées aux personnes concernées.

Même si vous avez fourni une adresse e-mail lors de l'inscription, nous vous recommandons vivement de gérer les contacts de l'API en ajoutant des utilisateurs disposant du rôle API_DEVELOPER.

Références

Pour en savoir plus, consultez les ressources suivantes :

Précédent
Known issues
Suivant
Access client accounts