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 for 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. Ce changement permet d'effectuer des appels d'API plus ciblés et 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 mettre à jour 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 Merchant API :

• Les informations principales du compte (ID, nom, paramètres de contenu pour adultes) restent dans la ressource Account.
• Les informations sur l'établissement (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, "détenue par une personne noire" ou "détenue par une femme") 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

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 par e-mail à l'aide du champ user.verificationMailSettings.verificationMailMode au profit de la validation basée sur l'API à l'aide de la nouvelle méthode accounts.verifySelf.
• 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 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 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 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.

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 et adult_content)	GET /accounts/v1/accounts/{account}
Créer un sous-compte	POST /content/v2.1/{merchantId}/accounts	POST /accounts/v1/accounts:createAndConfigure
Modifier les informations de votre 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)	Merchant API (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 dans un format lisible.
language	language_code	Le nom du champ est désormais language_code.

Gérer les informations sur votre établissement

Utilisez la ressource BusinessInfo pour gérer les informations publiques sur votre entreprise, comme votre adresse et vos coordonnées du 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 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 votre é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)	Merchant API (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
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)	Merchant API (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 pour 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
Modifier 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 enum répété.
Non disponible	state	Un nouveau champ en sortie seule 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. Merchant API 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)	Merchant API (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 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)	Merchant API (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 un énumérateur 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 comptes du multicompte donné. Les comptes avancés dans Merchant API sont beaucoup plus puissants et permettent un plus grand nombre de types de comptes et de relations. Pour faciliter la migration des comptes avancés, Merchant API fournit un équivalent direct à 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 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)	Merchant API (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.