Gérer les associations de comptes

Vous pouvez utiliser l'API Accounts pour gérer les relations entre votre compte Merchant Center et d'autres fournisseurs de services. Une relation est une connexion formelle qui permet à un fournisseur de proposer des services spécifiques à votre établissement. Un service définit les autorisations et les fonctionnalités accordées au fournisseur, telles que la gestion des produits ou des campagnes. Par exemple, associer votre compte Merchant Center à un compte Google Ads permet à ce dernier d'utiliser vos données produit pour diffuser des campagnes publicitaires.

Une relation se compose des attributs suivants :

  • Compte Merchant Center recevant le service
  • Le fournisseur de services
  • Le service ou l'ensemble de services fournis au compte Merchant Center

Alias

Les fournisseurs de services peuvent associer un alias aux comptes qu'ils gèrent (cela équivaut au champ seller_id qui était présent dans la ressource account de Content API for Shopping). L'alias peut être attribué à l'aide du champ facultatif account_id_alias de la ressource AccountRelationship et sert d'identifiant personnalisé. L'alias doit comporter entre 1 et 50 caractères choisis parmi les lettres ASCII, les chiffres décimaux, les tirets, les traits de soulignement, les points ou les tildes ([A-Za-z0-9_~.-]{1,50}).

La structure d'URL permettant d'accéder à un compte à l'aide de son alias est la suivante : GET /accounts/v1/accounts/{provider}~{account_id_alias}.

Services

Dans l'API Accounts, les comptes peuvent recevoir les services suivants. Vous pouvez ajouter la plupart de ces services lors de la création de votre compte.

  • Agrégation de comptes : ce service associe un compte avancé à un autre compte, ce qui permet au compte avancé d'y accéder de manière complète et sans restriction. Il est généralement utilisé par les places de marché, les marchands multimarques ou les marchands internationaux qui ont besoin d'un contrôle centralisé sur les comptes imbriqués. Si vous êtes une plate-forme d'e-commerce ou un partenaire de canal, nous vous recommandons d'utiliser plutôt accountManagement. Lorsque vous créez un compte à l'aide de l'agrégation de comptes, le externalAccountId doit être omis.

  • Gestion des campagnes : ce service modélise l'association entre un compte Merchant Center et un compte Google Ads. Il permet au compte Ads d'accéder aux données produit et de compte nécessaires pour diffuser des campagnes publicitaires. Dans ce cas, le fournisseur de services est GOOGLE_ADS et externalAccountId correspond à l'ID du compte Google Ads. Ce service peut également être proposé à un compte existant.

  • Comparateur de prix : représente la relation avec un service de comparateur de prix (CSS) qui gère le compte Merchant Center.

  • Gestion des fiches locales : cela représente la relation avec un responsable de magasin pour gérer l'inventaire et les fiches locales à l'aide d'une fiche d'établissement Google.

  • Gestion du compte : ce service permet au fournisseur d'effectuer des actions administratives sur le compte Merchant Center, comme configurer les paramètres du compte, gérer les utilisateurs ou mettre à jour les informations sur l'entreprise. L'établissement peut également restreindre l'accès accordé. Lorsqu'il est utilisé lors de la création d'un compte, ce service crée un compte associé au fournisseur, ce qui est l'approche recommandée pour les plates-formes d'e-commerce et les partenaires de chaîne. Il peut également être proposé à un compte existant.

  • Gestion des produits : ce service permet aux fournisseurs de gérer les produits et les fonctionnalités associées, comme les sources de données et les règles. Lorsqu'il est ajouté lors de la création du compte, il est généralement associé à accountManagement ou accountAggregation. Ce service peut également être proposé à un compte existant.

Poignée de mains

Pour établir un service, le compte qui le fournit et celui qui le reçoit doivent tous deux autoriser la connexion. Ce processus d'autorisation est appelé "handshake" (poignée de main).

Le handshake se déroule en deux étapes :

  1. Une partie propose un lien de service.
  2. L'autre partie approuve ou refuse la proposition.

Une fois la proposition acceptée, le service est approuvé et considéré comme entièrement établi. Tout droit d'accès conféré au fournisseur de services est désormais accordé aux utilisateurs qualifiés (voir Droits d'accès ci-dessous).

Notez que l'utilisateur qui crée, refuse ou approuve une proposition doit disposer des droits d'accès ADMIN sur le compte à l'origine du processus. Ainsi, si le fournisseur de services propose un service, l'utilisateur qui fait la proposition doit être ADMIN sur le compte du fournisseur de services, et l'utilisateur qui accepte ou refuse la proposition doit être ADMIN sur le compte destinataire.

Comportement d'établissement de connexion spécifique au service

Vous trouverez ci-dessous une description des exigences spécifiques à chaque service concernant l'établissement de la liaison :

  • Agrégation de comptes : ce service ne peut être établi que lors de la création d'un compte. Le fournisseur de services doit être un compte avancé. Le service est automatiquement approuvé, car les utilisateurs du compte avancé disposent d'un accès ADMIN complet au compte en cours de création.

  • Comparaison de prix : ce service est automatiquement approuvé lorsqu'il est ajouté lors de la création du compte à l'aide de createAndConfigure.

  • Gestion des campagnes : bien que ce processus suive la procédure d'établissement de la liaison habituelle, les propositions sont faites dans un système (par exemple, Google Ads) et les approbations dans l'autre (par exemple, dans Merchant Center ou via l'API Merchant).

  • Gestion des fiches locales : pour ce service, la poignée de main est proposée dans une méthode dédiée et les approbations sont effectuées dans l'autre système (par exemple, la fiche d'établissement Google). Vous trouverez la procédure détaillée dans le Guide pour associer une fiche d'établissement Google.

  • Gestion des comptes : pour ce service, le processus d'établissement de connexion habituel s'applique lorsque vous utilisez propose. Si le service est ajouté lors de la création du compte à l'aide de createAndConfigure, il est automatiquement approuvé.

  • Gestion des produits : pour ce service, la procédure d'établissement de la connexion habituelle s'applique (proposition par une partie, suivie de l'acceptation de l'autre).

Droits d'accès

Chaque type de service offre un certain niveau d'accès aux utilisateurs du fournisseur de services sur le compte concerné :

  • Agrégation de comptes : ce service fournit des droits ADMIN complets.

  • Gestion des campagnes : ce service fournit un droit d'accès limité, permettant au compte Ads associé d'accéder aux produits et aux informations de base du compte.

  • Comparateur de prix : ce service fournit, par défaut, des droits ADMIN complets. Toutefois, l'entreprise peut restreindre l'accès accordé dans Merchant Center.

  • Gestion des fiches locales : ce service ne fournit aucun droit d'accès direct. Il permet plutôt à la fiche de synchroniser ses produits avec le compte Merchant Center.

Important : Les droits d'accès décrits pour les types de services suivants ne s'appliquent qu'aux fournisseurs de services approuvés. Si vous êtes un fournisseur de services et que vous souhaitez utiliser cette fonctionnalité, contactez notre équipe d'assistance. Si vous avez déjà été approuvé pour la méthode accounts.link de gestion des produits dans Content API for Shopping, vous pouvez utiliser ce service dans Merchant API sans autre approbation.

  • Gestion de compte : ce service fournit, par défaut, des droits ADMIN complets.

  • Gestion des produits : ce service fournit des droits ADMIN complets. Notez que, à l'avenir, cela sera limité aux droits d'accès liés aux produits.

Comment les relations s'appliquent aux plates-formes tierces

Si vous êtes une plate-forme tierce qui gère des comptes pour le compte d'autres entreprises, vous trouverez ci-dessous la correspondance entre les différents concepts et la structure de votre compte :

  1. Fournisseur de services : votre compte avancé.
  2. Compte bénéficiant du service : compte Merchant Center représentant l'entreprise que vous gérez.
  3. Service :
    • accountManagement : il s'agit du service recommandé pour les plates-formes d'e-commerce et les partenaires de distribution qui créent des comptes pour le compte de marchands. Il crée un compte dont le marchand est propriétaire et qui est associé à vous pour la gestion. Cela correspond à la structure Merchant Center recommandée pour ce cas d'utilisation.
    • accountAggregation : ce service associe votre compte avancé à un autre compte. Bien qu'il soit compatible, il n'est pas recommandé pour les plates-formes d'e-commerce et les partenaires de distribution.

Pour savoir comment configurer un compte avancé et l'associer à de nouveaux comptes Merchant Center, consultez Créer des comptes.