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 un lien formel 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
  • Service ou ensemble de services fournis au compte Merchant Center

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é.

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 :

  • Agrégation de comptes : cette fonctionnalité modélise la relation entre un compte avancé et les comptes auxquels il fournit des services. Le fournisseur de services (le compte avancé) bénéficie d'un accès complet et illimité aux sous-comptes associés. externalAccountId correspond ici à l'identifiant du compte Merchant Center. Lorsque vous créez un sous-compte, le externalAccountId doit être omis, car il sera attribué à l'ID du compte lors de sa création.

  • 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.

  • 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é.

  • 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.

Poignée de mains

Pour établir un service, le compte qui le fournit et celui qui le reçoit doivent 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 une proposition, la refuse ou l'approuve 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 connexion :

  • 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.

  • 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, la procédure d'établissement de la connexion habituelle s'applique (proposition du fournisseur de services ou de l'entreprise, suivie de l'acceptation de l'autre partie).

  • 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.

  • Comparaison 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 qui représente l'entreprise que vous gérez.
  3. Service :
    • accountAggregation, si vous créez ces comptes en tant que sous-comptes de votre compte avancé. Toutefois, cette méthode est déconseillée. Le service préféré est accountManagement.
    • accountManagement, si vous établissez ce service après la création du compte pour des comptes qui ne sont pas des sous-comptes de votre compte avancé.

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