Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
La sous-API Accounts de l'API Merchant vous permet de créer, de configurer et de gérer vos comptes Google Merchant Center de manière programmatique. Il propose une suite complète d'outils permettant de gérer l'ensemble du cycle de vie et les configurations de base de vos comptes Merchant Center. Cette API est essentielle pour les entreprises et les fournisseurs tiers qui souhaitent automatiser la configuration des comptes et la maintenance continue.
Avec la sous-API Accounts, vous pouvez effectuer les opérations suivantes :
Effectuer les opérations de base sur les comptes Merchant Center : créer des comptes Merchant Center, récupérer leurs informations, mettre à jour les paramètres de base, surveiller les problèmes au niveau du compte, lister les comptes auxquels vous avez accès et supprimer des comptes si nécessaire.
Définissez les informations sur votre entreprise et votre présence en ligne : configurez les informations essentielles sur votre entreprise (comme l'adresse et les coordonnées), les attributs d'identité que vous avez déclarés vous-même, et configurez le site Web de votre boutique en ligne en spécifiant, validant et revendiquant l'URL de votre page d'accueil. C'est essentiel pour la représentation de votre entreprise.
Gérer l'accès des utilisateurs et les préférences de communication : découvrez comment contrôler qui peut accéder à votre compte Merchant Center, définir ses autorisations spécifiques et configurer ses préférences de notification par e-mail pour les informations et les mises à jour importantes concernant le compte.
Gérer l'inscription et la participation aux programmes : gérez votre inscription à différents programmes Merchant Center (comme les fiches gratuites ou les annonces Shopping), gérez votre état de participation et comprenez les exigences spécifiques aux programmes pour élargir la couverture de vos produits.
Configurer la logistique : livraison, retours et régions : configurez les paramètres de livraison au niveau de votre compte, définissez vos conditions de retour en ligne pour les clients et créez des régions géographiques pour un ciblage et une prestation de services précis.
Exploitez les intégrations avancées et l'association de comptes : découvrez comment gérer les paramètres pour les expériences omnicanales, associer des comptes Google My Business et des fournisseurs de flux locaux partenaires (LFP), et établir et gérer des relations de service avec d'autres comptes, tels que des fournisseurs ou des agences tiers.
Cet ensemble de guides fournit des instructions détaillées et des exemples pour les cas d'utilisation courants :
Créer un compte : découvrez comment créer un compte Merchant Center de manière programmatique.
Relations : découvrez comment les relations de service entre différents comptes Merchant Center (par exemple, avec des comptes avancés ou des fournisseurs tiers) sont structurées et gérées.
Associer une fiche d'établissement Google : associez votre compte Merchant Center à votre fiche d'établissement Google pour améliorer votre présence commerciale locale.
Contrôler l'accès à votre compte : gérez les autorisations et les rôles des utilisateurs dans votre compte Merchant Center pour contrôler qui peut effectuer des actions spécifiques.
Gérer les notifications par e-mail Merchant Center : personnalisez les notifications par e-mail que vous et les autres utilisateurs recevez pour les alertes, les actualités et les conseils concernant le compte.
Gérer les paramètres de la page d'accueil : définissez, validez et revendiquez l'URL du site Web de votre boutique en ligne. Il s'agit d'une étape essentielle pour la validation du compte et la participation au programme.
Migration de Content API : pour en savoir plus sur la migration depuis Content API for Shopping, consultez "Migrer la gestion des comptes".
Structure et relations des comptes Merchant Center
L'écosystème Merchant Center est compatible avec différentes structures de compte pour répondre aux besoins variés des entreprises. Ces comptes peuvent également établir des relations entre eux, où un compte (un fournisseur de services) propose des services spécifiques à un autre. La sous-API Accounts vous permet d'interagir avec ces types et leurs relations, et de les gérer.
Comptes marchands
Il s'agit d'un compte Merchant Center, généralement utilisé par une entreprise individuelle pour gérer directement ses propres fiches produit et programmes.
Cas d'utilisation courants :
Les petites et moyennes entreprises qui gèrent leur propre présence e-commerce.
Les marchands qui souhaitent contrôler directement la configuration de leur compte Google Merchant Center.
Marchands qui utilisent des plates-formes d'e-commerce où la plate-forme les aide à créer et à gérer leur compte.
Relations et services :
Les comptes marchands peuvent être associés à des fournisseurs de services pour obtenir de l'aide sur des tâches telles que la gestion des données produit ou la gestion des comptes et des campagnes.
Comptes avancés
Un compte avancé est un compte spécialisé dans Google Merchant Center. Il est conçu pour les entreprises et les plates-formes qui doivent gérer plusieurs comptes Merchant Center à grande échelle.
Cas d'utilisation courants :
Créateurs de boutiques : plates-formes d'e-commerce permettant aux marchands de créer et de gérer leurs boutiques en ligne.
Places de marché : plates-formes en ligne qui hébergent plusieurs marchands individuels vendant leurs produits.
Marchands ayant plusieurs marques : ces marchands possèdent plusieurs marques et vendent des produits dans des magasins physiques ou en ligne sur plusieurs domaines.
Marchands internationaux : marchands qui vendent des produits dans plusieurs pays et domaines.
Partenaires de distribution : entités qui aident les marchands à lister leurs produits sur différents canaux marketing et qui proposent souvent des services associés.
Relations et services :
Bien que tous les comptes avancés gèrent plusieurs comptes marchands, la configuration et l'utilisation optimales des relations et des services diffèrent souvent en fonction du modèle économique spécifique. Il est essentiel de comprendre ces différences pour utiliser efficacement l'API. Voici quelques bonnes pratiques recommandées pour les cas d'utilisation courants :
Créateurs de magasins et partenaires de distribution
Ces partenaires doivent créer un compte avancé et établir des relations avec les marchands avec lesquels ils travaillent.
Pour les comptes Merchant Center existants : la plate-forme doit établir un lien de service Account Management avec le compte individuel existant du marchand. Cela permet à la plate-forme de gérer certains aspects du compte avec l'autorisation du marchand.
Pour les nouveaux marchands sans compte : la plate-forme peut utiliser l'API pour créer un compte Merchant Center individuel pour le marchand. Vous pouvez créer un compte sous le compte avancé de la plate-forme à l'aide du service Account Aggregation.
Places de marché
Les places de marché utilisent un compte avancé par domaine et créent des comptes de vendeur avec le service Account Aggregation. Il est courant que les places de marché utilisent plusieurs types de vendeurs, dont certains nécessitent une configuration supplémentaire par l'équipe d'assistance de Google. La revendication de domaine et la gestion du programme sont effectuées au niveau du compte avancé et sont héritées par les comptes de vendeur. Pour en savoir plus, consultez l'article du Centre d'aide sur la structure de compte Marketplace valide.
Compte de vendeur appartenant à une place de marché : compte dédié aux produits de la place de marché. Cela permet à la place de marché d'utiliser la reconnaissance de sa marque, les notes des vendeurs et des stratégies de campagne propriétaires spécifiques.
Comptes à un seul vendeur : chaque compte contient des produits d'un seul vendeur tiers. Cette structure est idéale pour les grands vendeurs qui ont besoin d'attributs distincts et spécifiques ou qui diffusent des campagnes publicitaires propres à leur entreprise.
Comptes multivendeur : un seul compte contient les produits de plusieurs vendeurs tiers, ce qui simplifie la gestion des comptes et des produits.
Pour en savoir plus, consultez l'article du Centre d'aide sur les comptes multiseller.
Marchands ayant plusieurs marques
Les entreprises multimarques utilisent généralement un compte avancé pour gérer les comptes individuels de chaque marque, associés à l'aide d'un service Account Aggregation. Cela permet aux marques d'opérer de manière indépendante (par exemple, pour les revendications de sites Web ou les données produit), tandis que le compte avancé simplifie les fonctions centralisées telles que l'accès des utilisateurs, les rapports et parfois la supervision des campagnes.
Marchands internationaux
Les marchands internationaux gèrent leur présence mondiale à l'aide d'un compte avancé, avec des comptes individuels par pays ou région associés à l'aide d'un service Account
Aggregation. Leur configuration varie souvent en fonction de la structure du domaine :
Domaine unique (avec des sous-domaines/chemins par pays) : le domaine principal est généralement revendiqué au niveau du compte avancé et hérité par les comptes régionaux. Ces comptes régionaux se concentrent ensuite sur la gestion des données produit, des prix et de la disponibilité localisés.
Plusieurs domaines spécifiques à un pays : chaque compte régional revendique son propre domaine spécifique. Dans ce modèle, les comptes individuels gèrent les opérations locales, tandis que le compte avancé est principalement utilisé pour les fonctions centralisées telles que l'accès des utilisateurs, les rapports globaux et la gestion globale des campagnes.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/07/25 (UTC)."],[[["\u003cp\u003eThe Merchant Accounts API enables programmatic creation and management of merchant accounts, users, and sub-accounts.\u003c/p\u003e\n"],["\u003cp\u003eThird-party providers can leverage the API to build interfaces for merchants to manage their account details.\u003c/p\u003e\n"],["\u003cp\u003eGet started by creating your first merchant account and verifying its connection to the Merchant API for seamless integration.\u003c/p\u003e\n"],["\u003cp\u003eComprehensive details about the API can be found in the \u003ccode\u003eAccount\u003c/code\u003e reference documentation.\u003c/p\u003e\n"]]],["The Merchant Accounts API facilitates programmatic creation and management of merchant accounts, users, and sub-accounts. Third-party developers can build interfaces for merchants to manage their account details. Key actions include creating a merchant account, verifying its API access, and creating/managing sub-accounts. Information on controlling account access is also provided. The `Account` reference documentation offers further details on the API. Guides are provided on creating and configuring accounts, managing sub-accounts and managing account access.\n"],null,["# Overview of Accounts sub-API\n\nThe Accounts sub-API within the Merchant API lets you programmatically create,\nconfigure, and manage your Google Merchant Center accounts. It offers a\ncomprehensive suite of tools for managing the entire lifecycle and core\nconfigurations of your Merchant Center accounts. This API is essential for\nbusinesses and third-party providers looking to automate account setup and\nongoing maintenance.\n\nWith the Accounts sub-API, you can do the following:\n\n- **Perform core Merchant Center account operations:** Creating new Merchant Center accounts, retrieving their details, updating core settings, monitoring for account-level issues, listing accounts you can access, and deleting accounts when necessary.\n- **Establish your business information and online store presence:** Configure your essential business details (like address and contact information), self-declared identity attributes, and set up your online store's website by specifying, verifying, and claiming your homepage URL. This is key to how your business is represented.\n- **Manage user access and communication preferences:** Discover how to control who can access your Merchant Center account, define their specific permissions, and configure their email notification preferences for important account updates and news.\n- **Manage program enrollment and participation:** Manage your enrollment in various Merchant Center programs (like Free listings or Shopping ads), manage your participation status, and understand program-specific requirements to expand your product's reach.\n- **Configure logistics: shipping, returns, and regions:** Set up your account-level shipping settings, define your online return policies for customers, and create geographical regions for precise targeting and service delivery.\n- **Leverage advanced integrations and account linking:** Learn to manage settings for omnichannel experiences, link to Google Business Profile accounts and local feeds partnership (LFP) providers, and establish and manage service relationships with other accounts, such as third-party providers or agencies.\n\nThis set of guides provides detailed instructions and examples for common use\ncases:\n\n- **[Create an account](//developers.google.com/merchant/api/guides/accounts/create-and-configure):** Learn the steps to programmatically establish a new Merchant Center account.\n- **[Create and manage sub-accounts](/merchant/api/guides/accounts/sub-accounts):** Discover how to create and oversee accounts if you operate an [advanced account](//support.google.com/merchants/answer/14089347), essential for managing multiple sellers or brands.\n- **[Relationships](//developers.google.com/merchant/api/guides/accounts/relationships):** Understand how service relationships between different Merchant Center accounts (e.g., with advanced accounts or third-party providers) are structured and managed.\n- **[Link a Google Business Profile](//developers.google.com/merchant/api/guides/accounts/link-business-profile):** Connect your Merchant Center account with your Google Business Profile to enhance your local business presence.\n- **[Control access to your account](//developers.google.com/merchant/api/guides/accounts/control-access):** Manage user permissions and roles within your Merchant Center account to control who can perform specific actions.\n- **[Manage Merchant Center email notifications](//developers.google.com/merchant/api/guides/accounts/email-notifications):** Customize the email notifications you and other users receive for account alerts, news, and tips.\n- **[Manage homepage settings](//developers.google.com/merchant/api/guides/accounts/manage-homepage-settings):** Set, verify, and claim your online store's website URL, a crucial step for account verification and program participation.\n- **[Content API migration](//developers.google.com/merchant/api/guides/compatibility/accounts):** To learn about the migration from Content API for Shopping, see Migrate account management.\n\nMerchant Center account structure and relationships\n---------------------------------------------------\n\nThe Merchant Center ecosystem supports different account structures to cater to\nvarious business needs. These accounts can also form relationships with each\nother, where one account (a service provider) offers specific services to\nanother. The Accounts sub-API lets you interact with and manage these types and\ntheir relationships.\n\n### Merchant Accounts\n\nThis is a Merchant Center account, typically used by an individual business to\nmanage their own product listings and programs directly.\n\n**Common Use Cases:**\n\n- Small to medium-sized businesses managing their own ecommerce presence.\n- Merchants who want direct control over their Google Merchant Center setup.\n- Merchants who use ecommerce platforms where the platform helps create and manage their account.\n\n**Relationships and services:**\n\nMerchant accounts can be linked to service providers for assistance with tasks\nlike product data management or account and campaign management.\n\n### Advanced Accounts\n\nAn [advanced account](//support.google.com/merchants/answer/14089347) is a specialized account within Google\nMerchant Center. It's designed for businesses and platforms that need to manage\nmultiple Merchant Center accounts at scale.\n| **Important:** Some API methods are not applicable to advanced accounts. Refer to individual method documentation for details on applicability.\n\n**Common use cases:**\n\n- **Store builders:** Ecommerce platforms that enable merchants to create and operate their online stores.\n- **Marketplaces:** Online platforms that host multiple individual merchants selling their products.\n- **Merchants that own multiple brands:** These merchants own multiple brands and sell products in physical stores or online on multiple domains.\n- **International retailers:** Retailers selling products across multiple countries and domains.\n- **Channel partners:** Entities that help merchants list their products on various marketing channels and often provide related services.\n\n**Relationships and Services:**\n\nWhile all advanced accounts manage multiple merchant accounts, the optimal\nconfiguration and use of relationships and services often differ based on the\nspecific business model. Understanding these distinctions is key to leveraging\nthe API effectively. The following are recommended best practices for common use\ncases:\n\n#### Store builders and Channel partners\n\nThese partners should create an advanced account and establish relationships\nwith the merchants they work with.\n\n- **For existing Merchant Center accounts:** The platform should establish an `Account Management` service link with the merchant's existing individual account. This allows the platform to manage aspects of the account with the merchant's consent.\n- **For new merchants without an account:** The platform can use the API to create a new individual Merchant Center account for the merchant. A new account can be created under the platform's advanced account using the `Account Aggregation` service.\n\n| **Important:** The setup for Channel Partners can resemble that of Store Builders, especially if they provide services using store builder app stores. In these instances, the account relationship and service configurations may be analogous. Refer to the [Storebuilder Blueprint guide](//developers.google.com/merchant/storebuilder/online) for integration best practices.\n\n#### Marketplaces\n\nMarketplaces operate one advanced account per domain and create seller accounts\nwith the `Account Aggregation` service. It is common for marketplaces to use\nmultiple seller types, some of which require additional configuration by\nGoogle's support team. The domain claim and program management is done on the\nadvanced account level and inherited by the seller accounts. For additional\ndetails refer to the\n[valid marketplace account structure](//support.google.com/merchants/answer/14228975) help center\narticle.\n\n- **Marketplace-owned seller account:** A dedicated account for the marketplace's own products. This allows the marketplace to use its brand recognition, seller ratings, and specific 1P campaign strategies.\n- **Single-seller accounts:** Each account contains products for a single third-party seller. This structure is ideal for larger sellers requiring distinct, seller-specific attributes or running seller-specific advertising campaigns.\n- **Multi-Seller accounts:** A single account contains products from multiple third-party sellers, which simplifies the account and product management. For additional details refer to the [multi-seller accounts](//support.google.com/merchants/answer/15108683) help center article.\n\n#### Merchants that own multiple brands\n\nMulti-brand businesses typically use an advanced account to manage individual\naccounts for each brand, linked using an `Account Aggregation` service. This\nallows brands to operate independently (e.g., website claims, product data)\nwhile the advanced account simplifies centralized functions like user access,\nreporting, and sometimes campaign oversight.\n\n#### International retailers\n\nInternational retailers manage their global presence using an advanced account,\nwith individual accounts per country or region linked using an `Account\nAggregation` service. Their setup often varies based on domain structure:\n\n- **Single domain (with country subdomains/paths):** The main domain is typically claimed at the advanced account level and inherited by regional accounts. These regional accounts then focus on managing localized product data, pricing, and availability.\n- **Multiple country-specific domains:** Each regional account claims its own specific domain. In this model, the individual accounts handle local operations, while the advanced account is primarily used for centralized functions like user access, global reporting, and overarching campaign management."]]
