Migrer la gestion de compte

L'API Accounts est divisée en une collection de ressources pour vous permettre de gérer plus efficacement vos comptes Merchant Center et de contrôler plus précisément les 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 l'API Content Shopping, la ressource Account était un objet monolithique contenant toutes les informations, du nom du compte et de l'URL du site Web aux listes d'utilisateurs et aux informations sur l'entreprise.

L'API Merchant divise cette ressource en plusieurs ressources plus petites et plus ciblées. Cette modification permet d'effectuer des appels d'API plus ciblés et plus efficaces. Par exemple, pour modifier uniquement l'adresse de votre établissement, vous devez désormais envoyer une requête PATCH à la ressource BusinessInfo au lieu de modifier l'intégralité de l'objet Account.

Voici un résumé de la façon dont les concepts de la ressource Account de Content API for Shopping correspondent aux nouvelles ressources de l'API Merchant :

• Les informations de base sur le compte (ID, nom, paramètres de contenu pour adultes) restent dans la ressource Account.
• Les informations sur l'entreprise (adresse, numéro de téléphone, service client) sont désormais gérées par la ressource BusinessInfo.
• La revendication et l'URL du site Web sont gérées par la ressource Homepage.
• La gestion des utilisateurs est gérée par la ressource User.
• Les relations de compte (liens vers des comptes avancés, des fournisseurs tiers et d'autres services Google) sont gérées par les ressources AccountRelationship et AccountService.
• Les attributs sur l'identité de l'entreprise (par exemple, "Propriétaire d'entreprise noir" ou "Établissement détenu par des femmes") sont gérés par la ressource BusinessIdentity.
• Les contrats de conditions d'utilisation, une nouvelle fonctionnalité, sont gérés par les ressources TermsOfService et TermsOfServiceAgreementState.

Les nouvelles fonctionnalités

L'API Merchant 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.
• Accès aux comptes par alias : accédez aux comptes au format providerId~accountAlias. Les entreprises qui gèrent plusieurs comptes peuvent ainsi utiliser leurs propres identifiants de compte de manière cohérente.

Requêtes

Ce tableau compare les 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 de 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 un 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 principales 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.

Demander une comparaison

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 informations de 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 en sortie uniquement. L'identifiant principal est la ressource name.
name	account_name	Nom lisible du compte.
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, comme son adresse et ses coordonnées de service client. Il remplace l'objet businessInformation dans Content API for Shopping.

Demander une comparaison

Description de la requête	Content API for Shopping	API Merchant
Obtenir des informations sur un é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 valider et revendiquer ce site, utilisez la ressource Homepage. Cette action remplace le champ websiteUrl et la méthode accounts.claimwebsite de Content API for Shopping.

Demander une comparaison

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
Modifier 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
Revendiquer la page d'accueil	POST /content/v2.1/{merchantId}/accounts/{accountId}/claimwebsite	POST /accounts/v1/accounts/{account}/homepage:claim
Dissocier 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 qui est défini sur true si la page d'accueil a été 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 d'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.

Demander une comparaison

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)	API Merchant (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 de compte

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

Demander une comparaison

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 au niveau du compte

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

Gérer l'identité de votre entreprise

Utilisez la ressource BusinessIdentity pour déclarer vous-même les attributs de votre entreprise. Cette action remplace l'objet businessIdentity dans Content API for Shopping.

Demander une comparaison

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'établissement	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)	Le booléen est remplacé par un enum (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 un énuméré plus descriptif (PROMOTIONS_CONSENT_GIVEN, PROMOTIONS_CONSENT_DENIED).

Répertorier les comptes

Dans Content API for Shopping, le seul type de compte avancé était le multicompte (MC), qui exposait une méthode accounts.list permettant de lister les sous-comptes du multicompte donné. Les comptes avancés de l'API Merchant sont beaucoup plus puissants, car ils permettent d'utiliser un plus large éventail de types de comptes et de relations. Pour permettre une migration simple des comptes avancés, l'API Merchant fournit un équivalent direct à la méthode accounts.list de Content API for Shopping sous la forme d'une méthode accounts.listSubaccounts. Nous lançons une nouvelle méthode accounts.list plus performante qui permet de filtrer les comptes de manière avancée.

Demander une comparaison

Description de la requête	Content API for Shopping	API Merchant
Lister les sous-comptes	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 la requête)

Content API for Shopping (accounts.list)	API Merchant (accounts.listSubaccounts)	Remarques
merchant_id (paramètre du chemin d'accès)	provider (paramètre du chemin d'accès)	ID du compte avancé au format accounts/{account}.
max_results	page_size	Nombre maximal de comptes à renvoyer.