Migrer la gestion de compte

L'API Accounts est divisée en un ensemble de ressources pour vous permettre de gérer vos comptes Merchant Center plus efficacement, avec un contrôle plus précis des différents aspects de votre compte.

Ce guide explique les principaux changements et vous aide à migrer votre intégration de gestion de compte existante de Content API for Shopping vers Merchant API.

D'une ressource à plusieurs

Dans Content API for Shopping, la ressource Account était un objet monolithique contenant tout, du nom du compte et de l'URL du site Web aux listes d'utilisateurs et aux informations sur l'établissement.

Merchant API divise cette ressource en plusieurs ressources plus petites et plus ciblées. Ce changement permet d'effectuer des appels d'API plus ciblés et plus efficaces. Par exemple, pour ne mettre à jour que votre adresse professionnelle, vous envoyez désormais une requête PATCH à la ressource BusinessInfo au lieu de mettre à jour l'intégralité de l'objet Account.

Voici un résumé de la correspondance entre les concepts de la ressource Account de Content API for Shopping et les nouvelles ressources de l'API Merchant :

Les nouvelles fonctionnalités

Merchant API introduit également de nouvelles fonctionnalités de gestion de compte qui n'étaient pas disponibles dans Content API for Shopping :

  • Conditions d'utilisation : récupérez et acceptez les conditions d'utilisation de manière programmatique à l'aide des ressources TermsOfService et TermsOfServiceAgreementState.
  • Création de compte : la méthode accounts.createAndConfigure permet désormais de créer des comptes avec des relations (comme accountManagement), de définir un alias et de supprimer la validation de l'adresse e-mail à l'aide du champ user.verificationMailSettings.verificationMailMode au profit d'une validation basée sur l'API à l'aide de la nouvelle méthode accounts.verifySelf.
  • Accès au compte par alias : accédez aux comptes au format providerId~accountAlias, ce qui permet aux entreprises qui gèrent plusieurs comptes d'utiliser leurs propres identifiants de compte de manière cohérente.

Requêtes

Ce tableau fournit une comparaison consolidée des URL de requête pour les tâches courantes de gestion de compte entre Content API for Shopping et l'API Merchant.

Description de la requête Content API for Shopping API Merchant
Récupérer le compte GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} GET https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Obtenir un compte par alias Non disponible directement GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}~{alias}
Lister les sous-comptes GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts GET https://merchantapi.googleapis.com/accounts/v1/accounts/{provider}:listSubaccounts
Créer un sous-compte POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts POST https://merchantapi.googleapis.com/accounts/v1/accounts:createAndConfigure
Mettre à jour les données du compte PUT https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} PATCH sur la ressource appropriée. Par exemple, pour modifier le nom du compte : PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Supprimer le sous-compte DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId} DELETE https://merchantapi.googleapis.com/accounts/v1/accounts/{account}
Revendiquer un site Web POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/homepage:claim
Associer les comptes POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/accounts/{accountId}/link POST https://merchantapi.googleapis.com/accounts/v1/accounts/{account}/services:propose

Gérer les informations de base du compte

La ressource Account de l'API Merchant contient les informations essentielles d'un compte Merchant Center, telles que son nom, son ID et ses paramètres de base.

Comparaison des requêtes

Description de la requête Content API for Shopping API Merchant
Obtenir les détails du compte GET /content/v2.1/{merchantId}/accounts/{accountId} (accès aux attributs principaux tels que name, adult_content) GET /accounts/v1/accounts/{account}
Créer un sous-compte POST /content/v2.1/{merchantId}/accounts POST /accounts/v1/accounts:createAndConfigure
Mettre à jour les détails du compte PUT /content/v2.1/{merchantId}/accounts/{accountId} (mise à jour des attributs principaux) PATCH /accounts/v1/accounts/{account}
Supprimer un sous-compte DELETE /content/v2.1/{merchantId}/accounts/{accountId} DELETE /accounts/v1/accounts/{account}

Comparaison détaillée des champs

Content API for Shopping (Account) API Merchant (Account) Remarques
id account_id L'ID numérique est désormais un champ de sortie uniquement. L'identifiant principal est la ressource name.
name account_name Nom du compte lisible par l'humain.
language language_code Le nom du champ est désormais language_code.

Gérer les informations sur l'établissement

Utilisez la ressource BusinessInfo pour gérer les informations publiques sur votre entreprise, telles que votre adresse et les coordonnées du service client. Il remplace l'objet businessInformation dans Content API for Shopping.

Comparaison des requêtes

Description de la requête Content API for Shopping API Merchant
Obtenir des informations sur l'établissement GET /content/v2.1/{merchantId}/accounts/{accountId} (accès à l'attribut business_information) GET /accounts/v1/accounts/{account}/businessInfo
Modifier les informations sur l'établissement PUT /content/v2.1/{merchantId}/accounts/{accountId} (mise à jour de l'attribut business_information) PATCH /accounts/v1/accounts/{account}/businessInfo

Comparaison détaillée des champs

Content API for Shopping (business_information) API Merchant (BusinessInfo) Remarques
phone_number phone Le champ est désormais phone et utilise google.type.PhoneNumber.
customer_service.url customer_service.uri Le nom du champ est désormais uri.

Gérer votre page d'accueil

Pour gérer l'URL du site Web de votre magasin, et effectuer la validation et la revendication, utilisez la ressource Homepage. Cela remplace le champ websiteUrl et la méthode accounts.claimwebsite de Content API for Shopping.

Comparaison des requêtes

Description de la requête Content API for Shopping API Merchant
Obtenir l'URL de la page d'accueil GET /content/v2.1/{merchantId}/accounts/{accountId} (accès à l'attribut website_url) GET /accounts/v1/accounts/{account}/homepage
Mettre à jour l'URL de la page d'accueil PUT /content/v2.1/{merchantId}/accounts/{accountId} (mise à jour de l'attribut website_url) PATCH /accounts/v1/accounts/{account}/homepage
Page d'accueil de la revendication POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite POST /accounts/v1/accounts/{account}/homepage:claim
Supprimer la revendication de la page d'accueil Non disponible POST /accounts/v1/accounts/{account}/homepage:unclaim

Comparaison détaillée des champs

Content API for Shopping (Account) API Merchant (Homepage) Remarques
website_url uri URL de la page d'accueil du magasin.
Non disponible directement claimed Champ booléen défini sur true si la page d'accueil est revendiquée.

Gérer les utilisateurs

La ressource User vous permet de gérer les personnes autorisées à accéder à un compte Merchant Center. Cela remplace le tableau users dans la ressource Account. La principale différence réside dans le processus de création des utilisateurs. Dans l'API Merchant, l'ajout d'un utilisateur envoie une invitation. L'utilisateur doit accepter l'invitation avant de pouvoir accéder au compte.

Comparaison des requêtes

Description de la requête Content API for Shopping API Merchant
Répertorier les utilisateurs GET /content/v2.1/{merchantId}/accounts/{accountId} (accès à l'attribut users) GET /accounts/v1/accounts/{account}/users
Créer un compte utilisateur PUT /content/v2.1/{merchantId}/accounts/{accountId} (mise à jour de l'attribut users) POST /accounts/v1/accounts/{account}/users
Mettre à jour un utilisateur PUT /content/v2.1/{merchantId}/accounts/{accountId} (mise à jour de l'attribut users) PATCH /accounts/v1/accounts/{account}/users/{email}
Supprimer un compte utilisateur PUT /content/v2.1/{merchantId}/accounts/{accountId} (mise à jour de l'attribut users) DELETE /accounts/v1/accounts/{account}/users/{email}

Comparaison détaillée des champs

Content API for Shopping (objet de tableau users) Merchant API (ressource User) Remarques
email_address name (au format accounts/{account}/users/{email}) L'adresse e-mail de l'utilisateur fait désormais partie du nom de la ressource.
admin, order_manager, reporting_manager, etc. access_rights Les droits d'accès sont désormais regroupés dans un champ d'énumération répété.
Non disponible state Un nouveau champ en sortie uniquement indiquant si l'utilisateur est PENDING ou VERIFIED.

Gérer les relations et les services des comptes

Dans Content API for Shopping, les relations étaient gérées avec accounts.link. Merchant API introduit un modèle plus explicite avec les ressources AccountService et AccountRelationship, qui nécessitent un processus de handshake (proposition et acceptation).

Comparaison des requêtes

Description de la requête Content API for Shopping API Merchant
Associer les comptes POST /content/v2.1/{merchantId}/accounts/{accountId}/link POST /accounts/v1/accounts/{account}/services:propose
Lister les comptes associés GET /content/v2.1/{merchantId}/accounts/{accountId}/listlinks GET /accounts/v1/accounts/{account}/relationships et GET /accounts/v1/accounts/{account}/services

Comparaison détaillée des champs

Content API for Shopping (AccountLink) API Merchant (AccountService, AccountRelationship) Remarques
linked_account_id provider (dans AccountService) ID du compte fournissant le service.
service service_type (dans AccountService) Type de service fourni (par exemple, ACCOUNT_AGGREGATION).
status handshake.approval_state (dans AccountService) État de l'association (par exemple, PENDING, ESTABLISHED).

Paramètres de taxes du compte

Le service accounttax de Content API for Shopping n'est pas disponible dans Merchant API. Il n'est plus nécessaire de fournir la taxe de vente américaine. Pour en savoir plus, consultez Mise à jour des spécifications des données produit Merchant Center pour l'année 2025.

Gérer l'identité de l'entreprise

Utilisez la ressource BusinessIdentity pour autodéclarer des attributs concernant votre entreprise. Il remplace l'objet businessIdentity dans Content API for Shopping.

Comparaison des requêtes

Description de la requête Content API for Shopping API Merchant
Obtenir l'identité de l'entreprise GET /content/v2.1/{merchantId}/accounts/{accountId} (accès à l'attribut business_identity) GET /accounts/v1/accounts/{account}/businessIdentity
Modifier l'identité de l'entreprise PUT /content/v2.1/{merchantId}/accounts/{accountId} (mise à jour de l'attribut business_identity) PATCH /accounts/v1/accounts/{account}/businessIdentity

Comparaison détaillée des champs

Content API for Shopping (business_identity) API Merchant (BusinessIdentity) Remarques
black_owned.self_identified (booléen) black_owned.identity_declaration (enum) La valeur booléenne est remplacée par une énumération (SELF_IDENTIFIES_AS, DOES_NOT_SELF_IDENTIFY_AS) pour une déclaration plus explicite. Cela s'applique à tous les attributs d'identité.
include_for_promotions (booléen) promotions_consent (enum) Un booléen global est remplacé par une énumération plus descriptive (PROMOTIONS_CONSENT_GIVEN, PROMOTIONS_CONSENT_DENIED).

Répertorier les comptes

Dans Content API for Shopping, le seul type de compte avancé était un multicompte (MC), qui exposait une méthode accounts.list pour lister les comptes du multicompte donné. Les comptes avancés de Merchant API sont beaucoup plus puissants et permettent d'utiliser un plus grand nombre de types de comptes et de relations. Pour permettre une migration simple des comptes avancés, Merchant API fournit un équivalent direct à la méthode accounts.list de Content API for Shopping en tant que méthode accounts.listSubaccounts. Nous lançons une nouvelle méthode accounts.list plus puissante qui permet un filtrage avancé des comptes.

Comparaison des requêtes

Description de la requête Content API for Shopping API Merchant
Lister les comptes d'un compte avancé GET /content/v2.1/{merchantId}/accounts GET /accounts/v1/accounts/{providerId}:listSubaccounts
Lister tous les comptes accessibles Non disponible GET /accounts/v1/accounts

Comparaison détaillée des champs (paramètres de requête)

Content API for Shopping (accounts.list) API Merchant (accounts.listSubaccounts) Remarques
merchant_id (paramètre de chemin d'accès) provider (paramètre de chemin d'accès) ID du compte avancé au format accounts/{account}.
max_results page_size Nombre maximal de comptes à renvoyer.
Précédent
Refactor code for concurrent requests
Suivant
Migrate accountstatuses to Account Issues