Esta página explica como fazer upload e gerenciar seus produtos de forma programática. Com a API Merchant Products, é possível inserir ou atualizar um produto em uma fonte de dados, recuperar um produto da sua conta e excluir um produto de uma fonte de dados.
A API Merchant Products contém dois recursos.
productInputsrepresenta as partes de entrada dos seus produtos.productsrepresenta os produtos processados que foram criados com base nas partes de entrada.
O productInputs pode ser principal e complementar, dependendo se ele é
enviado para uma
fonte de dados principal
ou uma
fonte de dados complementar.
Cada product será criado a partir de um único productInput principal e qualquer
número de productInputs complementares.
É possível usar a API Merchant Products para criar catálogos de lojas on-line ou locais. Esses produtos podem aparecer em vários destinos de compras.
Você pode usar o recurso productInputs depois de criar sua conta do Merchant Center, configurar sua primeira fonte de dados e fazer upload de um conjunto inicial de produtos pela API.
Embora os comerciantes possam fazer upload de produtos usando um arquivo chamado PrimaryProductDataSource, há várias vantagens em criar e excluir produtos usando a API Merchant. Essas vantagens incluem tempo de resposta mais rápido e a capacidade de atualizar produtos em tempo real, sem a necessidade de gerenciar arquivos grandes. Pode levar até várias horas para que as mudanças de produtos feitas por chamadas de API sejam mostradas no banco de dados do Shopping.
Pré-requisitos
Se você não tiver uma fonte de dados, crie uma usando a API Merchant DataSources ou o Merchant Center.
Se você já tiver criado uma fonte de dados usando a interface do Merchant Center ou a API, poderá usar a API Merchant Products para adicionar seus produtos. Se você estiver usando a API Content for Shopping para adicionar produtos, consulte o guia de migração para entender como começar a usar a API Merchant Products.
Você é responsável por obedecer às políticas de anúncios do Shopping e listagens sem custo financeiro. Os anúncios do Shopping se reservam o direito de aplicar essas políticas e responder adequadamente se encontrarmos conteúdo ou comportamento que viole essas políticas.
Recursos
O recurso products permite recuperar informações do produto do banco de dados do
Shopping.
O recurso
productInput
representa os dados de entrada que você envia para um produto. Ela também fornece
métodos que permitem atualizar ou excluir informações de produtos uma por vez ou
muitas de uma vez no modo de lote. Um
recurso productInput precisa ter os seguintes campos:
channel: o canal do produto.offerId: o identificador exclusivo do produto.contentLanguage: o código de idioma ISO 639-1 de duas letras do produto.feedLabel: o rótulo do feed do produto.
Faça upload de uma entrada de produto na sua conta
Para fazer upload de uma entrada de produto na sua conta, use o
método accounts.productInputs.insert. É necessário transmitir o
identificador exclusivo da fonte de dados principal ou complementar.
Extrair um produto processado da sua conta
Para recuperar um produto processado da sua conta, use o
método accounts.products.get. Pode levar alguns minutos para
o produto processado aparecer após a inserção.
É possível acessar o nome do recurso do produto processado no campo product
na
resposta de accounts.productInputs.insert.
Excluir uma entrada de produto da sua conta
Para excluir uma entrada de produto da sua conta, use o
método accounts.productInputs.delete. É necessário transmitir o
identificador exclusivo da fonte de dados principal ou complementar à qual o produto
pertence para excluir um item usando a API Merchant Products.
Listar produtos da sua conta
Para listar os produtos processados na sua conta, use o método
accounts.products.list.