Migrer l'association de compte

La gestion des relations entre les comptes est passée d'une seule méthode link dans Content API for Shopping à un système plus précis et explicite dans l'API Merchant. La nouvelle API utilise des ressources dédiées telles que AccountRelationship et AccountService pour définir les services spécifiques qu'un compte fournit à un autre. Pour en savoir plus, consultez Relations entre les comptes.

Principales différences

  • Ressources dédiées aux relations et aux services : dans l'API Merchant, la ressource AccountRelationship définit la connexion entre un fournisseur de services et un marchand, tandis que la ressource AccountService spécifie le service exact fourni (par exemple, accountAggregation). Cela remplace les champs génériques linkType et services de l'API Content for Shopping.
  • Méthodes d'action explicites : au lieu d'une seule méthode link avec un paramètre action, l'API Merchant utilise des méthodes distinctes pour gérer les services, telles que propose, approve et reject.
  • Association dédiée à une fiche d'établissement Google : l'association à une fiche d'établissement Google, qui était auparavant gérée en définissant le champ googleMyBusinessLink, dispose désormais d'une méthode dédiée, gbpAccounts.linkGbpAccount.
  • Création de comptes client en tant que service : la création d'un compte client sous un compte avancé est désormais traitée comme une proposition de service accountAggregation à l'aide de la méthode accounts.createAndConfigure. Pour en savoir plus sur les comptes, consultez la page API Merchant Accounts. Aucune poignée de main n'est nécessaire, car l'utilisateur a accès à la fois au compte avancé et au compte client.

Requêtes

L'API Merchant fournit des points de terminaison spécifiques pour gérer différents types de liens de compte et de services :

URL des requêtes Merchant API

  • Proposer un nouveau service : POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/services:propose
  • Approuver un service : POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:approve
  • Refuser un service : POST https://merchantapi.googleapis.com/accounts/v1/ {name=accounts/*/services/*}:reject
  • Associer une fiche d'établissement Google : POST https://merchantapi.googleapis.com/accounts/v1/ {parent=accounts/*}/gbpAccounts:linkGbpAccount
  • Créer un compte client (lien d'agrégation de comptes) : POST https://merchantapi.googleapis.com/accounts/v1/ accounts:createAndConfigure

Comparaison des URL de requête

Description de la requête Content API for Shopping API Merchant
Associer des comptes (par exemple, des plates-formes tierces) POST .../v2.1/{merchantId}/accounts/{accountId}/link POST .../v1/{parent=accounts/*}/services:propose
Associer une fiche d'établissement Google PUT .../v2.1/{merchantId}/accounts/{accountId} (avec le champ googleMyBusinessLink) POST .../v1/{parent=accounts/*}/gbpAccounts:linkGbpAccount
Créer un compte client POST .../v2.1/{merchantId}/accounts POST .../v1/accounts:createAndConfigure

Méthodes

Méthode Content API for Shopping Méthode de l'API Merchant Disponibilité et remarques
accounts.link accountServices.propose Utilisez cette méthode pour lancer un nouveau service avec un autre compte.
accounts.link (avec action: "approve") accountServices.approve Utilisez cette méthode pour approuver une proposition de service en attente.
accounts.link (avec action: "remove") accountServices.reject Utilisez cette méthode pour refuser un service en attente ou établi.
accounts.insert (pour les comptes client) accounts.createAndConfigure Utilisez cette méthode avec un service accountAggregation pour créer un compte client dans un compte avancé.
accounts.update (avec googleMyBusinessLink) gbpAccounts.linkGbpAccount Utilisez cette méthode dédiée pour associer un compte Merchant Center à une fiche d'établissement Google.
accounts.update (avec adsLinks) AccountRelationship ressource L'association à Google Ads est gérée depuis l'UI Google Ads. Le lien obtenu est représenté par un AccountRelationship dans l'API Merchant. Vous pouvez l'afficher, mais pas le créer directement.

Modifications détaillées des champs

Content API for Shopping API Merchant Description
AccountsLinkRequest.action Méthodes propose, approve, reject Le champ action unique est remplacé par des méthodes d'API dédiées pour chaque changement d'état dans le cycle de vie du service.
AccountsLinkRequest.linkType AccountService.service_type La chaîne générique linkType est remplacée par un champ service_type structuré dans la ressource AccountService, tel que productsManagement ou accountAggregation.
AccountsLinkRequest.services AccountService.service_type La liste des services basés sur des chaînes est désormais représentée par le service_type spécifique choisi dans la ressource AccountService.
AccountsLinkRequest.linkedAccountId ProposeAccountServiceRequest.provider L'ID du compte fournissant le service est désormais spécifié dans le champ provider de la requête propose.
Account.googleMyBusinessLink LinkGbpAccountRequest L'objet contenant les détails du lien vers la fiche d'établissement Google est remplacé par un message de requête dédié pour la méthode linkGbpAccount.
Account.adsLinks AccountRelationship Les associations Google Ads sont représentées par une ressource AccountRelationship dont le provider est providers/GOOGLE_ADS. Cette association est généralement gérée depuis l'UI Google Ads.