Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A sub-API Accounts na API Merchant permite criar, configurar e gerenciar programaticamente suas contas do Google Merchant Center. Ele oferece um conjunto abrangente de ferramentas para gerenciar todo o ciclo de vida e as configurações principais das suas contas do Merchant Center. Essa API é essencial para empresas e provedores terceirizados que querem automatizar a configuração de contas e a manutenção contínua.
Com a sub-API Accounts, é possível fazer o seguinte:
Realizar operações básicas da conta do Merchant Center:criar novas contas do Merchant Center, recuperar detalhes, atualizar configurações principais, monitorar problemas no nível da conta, listar as contas a que você tem acesso e excluir contas quando necessário.
Estabeleça as informações comerciais e a presença da loja on-line:configure
os detalhes essenciais da empresa (como endereço e informações de contato),
os atributos de identidade autodeclarados e o site da loja on-line
especificando, verificando e reivindicando o URL da página inicial. Isso é fundamental para a representação da sua empresa.
Gerenciar o acesso do usuário e as preferências de comunicação:saiba como controlar quem pode acessar sua conta do Merchant Center, definir permissões específicas e configurar as preferências de notificação por e-mail para atualizações e notícias importantes da conta.
Gerenciar a inscrição e a participação em programas:gerencie sua inscrição em vários programas do Merchant Center (como listagens sem custo financeiro ou anúncios do Shopping), o status de participação e entenda os requisitos específicos de cada programa para ampliar o alcance do seu produto.
Configure a logística: frete, devoluções e regiões:defina as configurações de frete no nível da conta, crie políticas de devolução on-line para os clientes e crie regiões geográficas para segmentação precisa e entrega de serviços.
Aproveite integrações avançadas e a vinculação de contas:aprenda a gerenciar configurações para experiências omnichannel, vincule contas do Perfil da Empresa no Google e provedores de parceria de feeds locais (LFP, na sigla em inglês) e estabeleça e gerencie relações de serviço com outras contas, como provedores ou agências terceirizadas.
Este conjunto de guias fornece instruções detalhadas e exemplos para casos de uso
comuns:
Criar uma conta:saiba como estabelecer uma nova conta do Merchant Center de forma programática.
Relacionamentos:entenda como os relacionamentos de serviço entre diferentes contas do Merchant Center (por exemplo, com contas avançadas ou provedores terceirizados) são estruturados e gerenciados.
Controle o acesso à sua conta:gerencie as permissões e funções dos usuários na sua conta do Merchant Center para controlar quem pode realizar ações específicas.
Gerenciar as configurações da página inicial:defina, verifique e reivindique o URL do site da sua loja on-line, uma etapa crucial para a verificação da conta e a participação no programa.
Migração da API Content:para saber mais sobre a migração da API Content for Shopping, consulte "Migrar o gerenciamento de contas".
Estrutura e relações da conta do Merchant Center
O ecossistema do Merchant Center oferece suporte a diferentes estruturas de conta para atender a várias necessidades comerciais. Essas contas também podem formar relacionamentos entre si, em que uma conta (um provedor de serviços) oferece serviços específicos a outra. A sub-API Accounts permite interagir com esses tipos e gerenciar eles e as relações entre eles.
Contas do comerciante
É uma conta do Merchant Center, geralmente usada por uma empresa individual para gerenciar diretamente as informações e os programas de produtos.
Casos de uso comuns:
Pequenas e médias empresas que gerenciam a própria presença no e-commerce.
Comerciantes que querem controle direto sobre a configuração do Google Merchant Center.
Comerciantes que usam plataformas de e-commerce que ajudam a criar e gerenciar a conta.
Relacionamentos e serviços:
As contas do comerciante podem ser vinculadas a provedores de serviços para receber ajuda com tarefas
como gerenciamento de dados de produtos ou de contas e campanhas.
Contas avançadas
Uma conta avançada é uma conta especializada no Google Merchant Center. Ele foi criado para empresas e plataformas que precisam gerenciar várias contas do Merchant Center em grande escala.
Casos de uso comuns:
Criadores de lojas:plataformas de e-commerce que permitem que os comerciantes criem e
operem lojas on-line.
Marketplaces:plataformas on-line que hospedam vários comerciantes individuais vendendo produtos.
Comerciantes com várias marcas:são proprietários de várias marcas e vendem produtos em lojas físicas ou on-line em vários domínios.
Varejistas internacionais:vendem produtos em vários países e domínios.
Parceiros de canal:entidades que ajudam os comerciantes a listar produtos em vários canais de marketing e geralmente oferecem serviços relacionados.
Relacionamentos e serviços:
Embora todas as contas avançadas gerenciem várias contas de comerciante, a configuração e o uso ideais de relacionamentos e serviços geralmente variam de acordo com o modelo de negócios específico. Entender essas distinções é fundamental para usar a API de forma eficaz. Confira a seguir as práticas recomendadas para casos de uso comuns:
Criadores de lojas e parceiros de canal
Esses parceiros precisam criar uma conta avançada e estabelecer relações com os comerciantes com quem trabalham.
Para contas atuais do Merchant Center:a plataforma precisa estabelecer um link de serviço Account Management com a conta individual do comerciante. Isso permite que a plataforma gerencie aspectos da conta com o consentimento do comerciante.
Para novos comerciantes sem uma conta:a plataforma pode usar a API para criar uma conta individual do Merchant Center para o comerciante. É possível criar uma nova conta na conta avançada da plataforma usando o serviço Account Aggregation.
Mercados
Os marketplaces operam uma conta avançada por domínio e criam contas de vendedor
com o serviço Account Aggregation. É comum que os marketplaces usem vários tipos de vendedores, alguns dos quais exigem configuração adicional pela equipe de suporte do Google. A reivindicação de domínio e o gerenciamento do programa são feitos no nível da conta avançada e herdados pelas contas de vendedor. Para mais detalhes, consulte o artigo da Central de Ajuda sobre estrutura de conta válida do marketplace.
Conta de vendedor do marketplace:uma conta dedicada aos produtos do próprio marketplace. Isso permite que o marketplace use o reconhecimento da marca, as classificações do vendedor e estratégias específicas de campanha própria.
Contas de vendedor único:cada conta tem produtos de um único vendedor terceirizado. Essa estrutura é ideal para vendedores maiores que precisam de atributos distintos e específicos ou que veiculam campanhas publicitárias específicas.
Contas de vários vendedores:uma única conta contém produtos de vários vendedores terceirizados, o que simplifica o gerenciamento de contas e produtos.
Para mais detalhes, consulte o artigo da Central de Ajuda sobre contas de vários vendedores.
Comerciantes com várias marcas
Empresas com várias marcas geralmente usam uma conta avançada para gerenciar contas individuais de cada marca, vinculadas usando um serviço Account Aggregation. Isso permite que as marcas operem de forma independente (por exemplo, reivindicações de sites, dados de produtos), enquanto a conta avançada simplifica funções centralizadas, como acesso de usuários, relatórios e, às vezes, supervisão de campanhas.
Varejistas internacionais
Os varejistas internacionais gerenciam a presença global usando uma conta avançada,
com contas individuais por país ou região vinculadas usando um serviço Account
Aggregation. A configuração geralmente varia de acordo com a estrutura do domínio:
Domínio único (com subdomínios/caminhos de país): o domínio principal geralmente é reivindicado no nível da conta avançada e herdado pelas contas regionais. Essas contas regionais se concentram no gerenciamento de dados, preços e disponibilidade de produtos localizados.
Vários domínios específicos de países:cada conta regional reivindica um domínio específico. Nesse modelo, as contas individuais processam operações locais, enquanto a conta avançada é usada principalmente para funções centralizadas, como acesso de usuários, relatórios globais e gerenciamento geral de campanhas.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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."]]
