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.

Différences majeures

  • 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 Content API 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, auparavant gérée en définissant le champ googleMyBusinessLink, dispose désormais d'une méthode dédiée, gbpAccounts.linkGbpAccount.
  • Création d'un compte client en tant que service : la création d'un compte client sous un compte avancé est désormais considérée comme une proposition de service accountAggregationà l'aide de la accounts.createAndConfigure méthode. Pour en savoir plus sur les comptes, consultez la page API Merchant Accounts. Aucune négociation 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 et de services de compte :

URL de requête de l'API Merchant

  • 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 API Merchant Disponibilité et notes
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 clients) accounts.createAndConfigure Utilisez cette méthode avec un service accountAggregation pour créer un compte client sous 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) Ressource AccountRelationship L'association à Google Ads est gérée depuis l'interface utilisateur Google Ads. Le lien obtenu est représenté par une AccountRelationship dans l'API Merchant, qui peut être affichée, mais pas créée 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 API dédiées pour chaque changement d'état du cycle de vie du service.
AccountsLinkRequest.linkType AccountService.service_type La chaîne linkType générique 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 de la fiche d'établissement Google est remplacé par un message de requête dédié pour la méthode linkGbpAccount.
Account.adsLinks AccountRelationship Les liens Google Ads sont représentés par une ressource AccountRelationship où le provider est providers/GOOGLE_ADS. Cette relation est généralement gérée depuis l'interface utilisateur Google Ads.