Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Com a sub-API Products, é possível gerenciar de forma programática seu inventário de produtos no Google Merchant Center. Você pode criar, recuperar, atualizar e excluir produtos,
o que oferece a flexibilidade de integrar seus sistemas diretamente ao Google.
Um conceito importante na API Merchant é a distinção entre os dados enviados e o produto final usado pelo Google. Essa separação oferece um modelo mais claro do ciclo de vida dos dados de produtos e permite um controle mais preciso sobre as informações dos itens. A API reflete isso com dois recursos principais:
ProductInput:representa os dados brutos de produtos que você envia a uma fonte de dados específica.
Pense nisso como a linha que você envia em um arquivo de feed ou os dados que você envia com uma chamada de API antes que qualquer processamento do Merchant Center aconteça. Você usa esse recurso para todas as operações de gravação (insert, patch, delete).
Product:é um recurso somente leitura que representa o produto final processado
como ele aparece no Merchant Center e nas plataformas do Google. Ele é criado com base em um ProductInput principal e zero ou mais recursos ProductInput suplementares depois que todas as regras de feed e o processamento são aplicados. Esse recurso inclui o status final do produto e problemas de qualidade dos dados.
Você usa esse recurso para todas as operações de leitura (get, list).
O formato e os requisitos de todos os atributos de produto enviados usando o recurso
ProductInput são definidos na especificação de dados de
produtos.
O que você pode fazer com a sub-API Products
A sub-API Products permite realizar as seguintes tarefas principais: Confira os guias para instruções detalhadas e exemplos de código de cada caso de uso.
Adicionar e gerenciar produtos: saiba como adicionar novos produtos à sua conta, fornecer dados complementares para os itens atuais e excluir produtos que você não vende mais.
Atualize seus produtos com frequência: saiba como fazer atualizações parciais e eficientes nos atributos que mudam com frequência, como preço e disponibilidade.
Liste os dados e problemas dos seus produtos: saiba como recuperar os produtos processados, verificar o status de aprovação deles para diferentes destinos e identificar problemas de qualidade de dados que possam estar afetando a visibilidade.
Antes de começar
Antes de usar a sub-API Products, crie pelo menos uma fonte de dados da API na sua conta do Merchant Center. A sub-API Products só pode inserir ou atualizar produtos em fontes de dados do tipo API. Para instruções, consulte o guia Gerenciar origens de dados da API para uploads de produtos.
[[["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-08-22 UTC."],[[["\u003cp\u003eThe Merchant Products API allows you to programmatically manage your product data, including inserting, updating, retrieving, and deleting products.\u003c/p\u003e\n"],["\u003cp\u003eProducts are managed through two key resources: \u003ccode\u003eproductInputs\u003c/code\u003e (representing input data) and \u003ccode\u003eproducts\u003c/code\u003e (representing processed products in the Shopping database).\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eproductInputs\u003c/code\u003e can be primary or supplementary and are used to construct the final \u003ccode\u003eproduct\u003c/code\u003e that appears in your online or local store catalogs.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers advantages over file-based uploads, such as faster response times and real-time updates.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the API, ensure you have a data source set up and are familiar with Shopping Ads and free listings policies.\u003c/p\u003e\n"]]],["The Merchant Products API allows programmatic product data management via `productInputs` and `products` resources. Actions include inserting `productInput` data with required fields like `channel`, `offerId`, `contentLanguage`, and `feedLabel` using `accounts.productInputs.insert`. Processed products can be retrieved using `accounts.products.get` and listed with `accounts.products.list`. Product inputs are deleted using `accounts.productInputs.delete`, specifying the data source. Products are built from primary and supplemental data sources, enabling real-time catalog management. You can use Batch mode to manage many products.\n"],null,[]]