Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La sub-API de Accounts dentro de la API de Merchant te permite crear, configurar y administrar tus cuentas de Google Merchant Center de forma programática. Ofrece un conjunto integral de herramientas para administrar todo el ciclo de vida y las configuraciones principales de tus cuentas de Merchant Center. Esta API es fundamental para las empresas y los proveedores externos que desean automatizar la configuración de cuentas y el mantenimiento continuo.
Con la sub-API de Accounts, puedes hacer lo siguiente:
Realizar operaciones básicas de la cuenta de Merchant Center: Crear cuentas nuevas de Merchant Center, recuperar sus detalles, actualizar la configuración principal, supervisar los problemas a nivel de la cuenta, enumerar las cuentas a las que puedes acceder y borrar cuentas cuando sea necesario
Establece la información de tu empresa y la presencia de tu tienda en línea: Configura los detalles esenciales de tu empresa (como la dirección y la información de contacto), los atributos de identidad autodeclarados y el sitio web de tu tienda en línea. Para ello, especifica, verifica y reclama la URL de tu página principal. Esto es fundamental para la forma en que se representa tu empresa.
Administra el acceso de los usuarios y las preferencias de comunicación: Descubre cómo controlar quién puede acceder a tu cuenta de Merchant Center, definir sus permisos específicos y configurar sus preferencias de notificaciones por correo electrónico para recibir actualizaciones y noticias importantes sobre la cuenta.
Administra la inscripción y la participación en los programas: Administra tu inscripción en varios programas de Merchant Center (como las fichas gratuitas o los anuncios de Shopping), administra tu estado de participación y comprende los requisitos específicos de cada programa para expandir el alcance de tus productos.
Configura la logística: envíos, devoluciones y regiones: Establece la configuración de envío a nivel de la cuenta, define tus políticas de devoluciones en línea para los clientes y crea regiones geográficas para segmentar con precisión y ofrecer servicios.
Aprovecha las integraciones avanzadas y la vinculación de cuentas: Aprende a administrar la configuración de las experiencias omnicanal, vincularte a las cuentas del Perfil de Negocio de Google y a los proveedores de la asociación de feeds locales (LFP), y establecer y administrar relaciones de servicio con otras cuentas, como proveedores o agencias externos.
En este conjunto de guías, se proporcionan instrucciones y ejemplos detallados para casos de uso comunes:
Crea una cuenta: Conoce los pasos para establecer una nueva cuenta de Merchant Center de forma programática.
Relaciones: Comprende cómo se estructuran y administran las relaciones de servicio entre diferentes cuentas de Merchant Center (p.ej., con cuentas avanzadas o proveedores externos).
Vincula un Perfil de Negocio de Google: Conecta tu cuenta de Merchant Center con tu Perfil de Negocio de Google para mejorar la presencia de tu empresa local.
Controla el acceso a tu cuenta: Administra los permisos y los roles de los usuarios en tu cuenta de Merchant Center para controlar quién puede realizar acciones específicas.
Administra la configuración de la página principal: Establece, verifica y reclama la URL del sitio web de tu tienda en línea, un paso fundamental para la verificación de la cuenta y la participación en el programa.
Migración de Content API: Para obtener información sobre la migración desde Content API for Shopping, consulta Migra la administración de cuentas.
Estructura y relaciones de la cuenta de Merchant Center
El ecosistema de Merchant Center admite diferentes estructuras de cuentas para satisfacer diversas necesidades comerciales. Estas cuentas también pueden formar relaciones entre sí, en las que una cuenta (un proveedor de servicios) ofrece servicios específicos a otra. La sub-API de Accounts te permite interactuar con estos tipos y sus relaciones, y administrarlos.
Cuentas de comerciante
Esta es una cuenta de Merchant Center que, por lo general, usa una empresa individual para administrar directamente sus fichas de productos y programas.
Casos de uso habituales:
Pequeñas y medianas empresas que administran su propia presencia de comercio electrónico
Comerciantes que desean tener control directo sobre su configuración de Google Merchant Center
Comerciantes que usan plataformas de comercio electrónico en las que la plataforma ayuda a crear y administrar su cuenta
Relaciones y servicios:
Las cuentas de comerciante se pueden vincular a proveedores de servicios para obtener ayuda con tareas como la administración de datos de productos o la administración de cuentas y campañas.
Cuentas avanzadas
Una cuenta avanzada es una cuenta especializada dentro de Google Merchant Center. Está diseñada para empresas y plataformas que necesitan administrar varias cuentas de Merchant Center a gran escala.
Casos de uso habituales:
Creadores de tiendas: Son plataformas de comercio electrónico que permiten a los comercios crear y operar sus tiendas en línea.
Mercados: Son plataformas en línea que alojan a varios comercios individuales que venden sus productos.
Comercios con varias marcas: Son propietarios de varias marcas y venden productos en tiendas físicas o en línea en varios dominios.
Minoristas internacionales: Son minoristas que venden productos en varios países y dominios.
Socios de canal: Son entidades que ayudan a los comercios a publicar sus productos en varios canales de marketing y, a menudo, proporcionan servicios relacionados.
Relaciones y servicios:
Si bien todas las cuentas avanzadas administran varias cuentas de comerciante, la configuración y el uso óptimos de las relaciones y los servicios suelen diferir según el modelo de negocio específico. Comprender estas distinciones es clave para aprovechar la API de manera eficaz. A continuación, se incluyen prácticas recomendadas para casos de uso comunes:
Creadores de tiendas y socios de canal
Estos socios deben crear una cuenta avanzada y establecer relaciones con los comercios con los que trabajan.
Para las cuentas existentes de Merchant Center: La plataforma debe establecer un vínculo de servicio Account Management con la cuenta individual existente del comercio. Esto permite que la plataforma administre aspectos de la cuenta con el consentimiento del comercio.
Para los comercios nuevos que no tienen una cuenta: La plataforma puede usar la API para crear una cuenta individual nueva de Merchant Center para el comercio. Se puede crear una cuenta nueva en la cuenta avanzada de la plataforma con el servicio Account Aggregation.
Mercados
Los mercados operan una cuenta avanzada por dominio y crean cuentas de vendedor con el servicio Account Aggregation. Es común que los mercados usen varios tipos de vendedores, algunos de los cuales requieren configuración adicional por parte del equipo de asistencia al cliente de Google. El reclamo de dominio y la administración del programa se realizan a nivel de la cuenta avanzada y las heredan las cuentas de vendedor. Para obtener más detalles, consulta el artículo del Centro de ayuda sobre la estructura de cuentas de mercado válida.
Cuenta de vendedor propietario del mercado: Es una cuenta exclusiva para los productos propios del mercado. Esto permite que el mercado use su reconocimiento de marca, las calificaciones del vendedor y las estrategias específicas de las campañas de 1P.
Cuentas de un solo vendedor: Cada cuenta contiene productos de un solo vendedor externo. Esta estructura es ideal para los vendedores más grandes que requieren atributos distintos y específicos del vendedor, o que publican campañas publicitarias específicas del vendedor.
Cuentas de varios vendedores: Una sola cuenta contiene productos de varios vendedores externos, lo que simplifica la administración de la cuenta y los productos.
Para obtener más detalles, consulta el artículo del Centro de ayuda sobre las cuentas de varios vendedores.
Comercios que tienen varias marcas
Por lo general, las empresas con varias marcas utilizan una cuenta avanzada para administrar las cuentas individuales de cada marca, vinculadas a través de un servicio de Account Aggregation. Esto permite que las marcas operen de forma independiente (p.ej., reclamos del sitio web, datos de productos), mientras que la cuenta avanzada simplifica las funciones centralizadas, como el acceso de los usuarios, los informes y, a veces, la supervisión de las campañas.
Minoristas internacionales
Los comercios minoristas internacionales administran su presencia global con una cuenta avanzada, con cuentas individuales por país o región vinculadas a través de un servicio de Account
Aggregation. Su configuración suele variar según la estructura del dominio:
Un solo dominio (con subdominios o rutas de acceso de país): Por lo general, el dominio principal se reclama a nivel de la cuenta avanzada y lo heredan las cuentas regionales. Luego, estas cuentas regionales se enfocan en administrar los datos, los precios y la disponibilidad de los productos localizados.
Varios dominios específicos de cada país: Cada cuenta regional reclama su propio dominio específico. En este modelo, las cuentas individuales manejan las operaciones locales, mientras que la cuenta avanzada se usa principalmente para funciones centralizadas, como el acceso de usuarios, la generación de informes globales y la administración general de campañas.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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."]]
