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 entreprise. 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 est composée des attributs suivants :

• Le compte Merchant Center qui reçoit 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 de compte de Content API for Shopping). L'alias peut être attribué à l'aide du champ facultatif account_id_alias dans 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 traits d'union, 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 plusieurs de ces services lors de la création du compte.

• Agrégation de comptes : ce service associe un compte avancé à un autre compte, ce qui lui accorde un accès complet et illimité. Il est généralement utilisé par les places de marché, les détaillants multimarques ou les détaillants internationaux qui ont besoin d'un contrôle centralisé sur les comptes imbriqués. Si vous êtes une plate-forme de commerce électronique ou un partenaire de distribution, nous vous recommandons d'utiliser plutôt accountManagement. Lorsque vous créez un compte à l'aide de l'agrégation de comptes, vous devez omettre externalAccountId.

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

• Shopping comparatif : représente la relation avec un service de shopping comparatif (CSS) qui gère le compte Merchant Center.

• Gestion des fiches locales : 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 des comptes : ce service permet au fournisseur d'effectuer des actions administratives sur le compte Merchant Center, telles que la configuration des paramètres du compte, la gestion des utilisateurs ou la mise à jour des informations sur l'entreprise. L'entreprise 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 provider, ce qui est l'approche recommandée pour les plates-formes d'e-commerce et les partenaires de distribution. 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, telles que les sources de données et les règles. Lorsqu'il est ajouté lors de la création d'un compte, il est généralement combiné à 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 autoriser la connexion. Ce processus d'autorisation est appelé "poignée de mains".

La poignée de mains est un processus en deux étapes :

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

Une fois qu'une proposition a été acceptée, le service est approuvé et considéré comme entièrement établi. Tous les droits d'accès conférés au fournisseur de services sont désormais accordés aux utilisateurs qualifiés (voir les droits d'accès ci-dessous).

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

Comportement de la poignée de mains spécifique au service

Vous trouverez ci-dessous une description des exigences spécifiques de la poignée de mains pour chaque service :

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

• Shopping comparatif : ce service est automatiquement approuvé lorsqu'il est ajouté lors de la création d'un compte à l'aide de createAndConfigure.

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

• Gestion des fiches locales : pour ce service, la poignée de mains est proposée dans une méthode dédiée et les approbations sont effectuées dans l'autre système (par exemple, 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 normal de poignée de mains s'applique lorsque vous utilisez propose. Si le service est ajouté lors de la création d'un compte à l'aide de createAndConfigure, il est automatiquement approuvé.

• Gestion des produits : pour ce service, le processus normal de poignée de mains s'applique (proposition d'une partie, suivie de l'acceptation de l'autre).

Droits d'accès

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

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

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

• Shopping comparatif : par défaut, ce service fournit 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. Au lieu de cela, il permet à 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. Contactez notre équipe d'assistance si vous êtes un fournisseur de services et que vous souhaitez utiliser cette fonctionnalité. Si vous avez déjà été approuvé pour la méthode accounts.link pour la gestion des produits dans Content API for Shopping, vous pouvez utiliser ce service dans l'API Merchant sans autre approbation.

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

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

Application des relations 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 comment les différents concepts sont mappés à la structure de votre compte :

1. Fournisseur de services : votre compte avancé.
2. Compte qui reçoit le service : compte Merchant Center qui représente l'entreprise que vous gérez.
3. Service:
   • accountManagement: il s'agit du service recommandé pour les plates-formes de commerce électronique et les partenaires de distribution qui créent de nouveaux comptes pour le compte de marchands. Il crée un compte appartenant au marchand, associé à vous pour la gestion. Cela correspond à la structure Merchant Center préféré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 de commerce électronique 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.