Nesta página, explicamos como fazer upload e gerenciar seus produtos de maneira 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 excluí-lo de uma fonte de dados.
Você pode usar o recurso
products
para criar um catálogo de lojas on-line, que é uma lista de produtos disponíveis nos anúncios do Shopping. Você pode usar o recurso products depois de criar sua conta do Merchant Center e fazer upload de um conjunto inicial de produtos por meio da API.
Você é responsável por obedecer às políticas de anúncios do Shopping e listagens sem custo financeiro. Os anúncios do Shopping reservam-se o direito de aplicar essas políticas e responder adequadamente se encontrarmos conteúdo ou comportamento que as viole.
O recurso products faz upload de informações do produto para o banco de dados do Shopping Merchant
Center. Ele também fornece vários métodos que permitem acessar, atualizar ou excluir informações do produto, um ou muitos por vez, no modo de lote.
O recurso productInput
representa os dados de entrada enviados para um produto. Um recurso productInput
precisa ter os seguintes campos:
channel: o canal do produto.offerId: o identificador exclusivo do produto. Esse valor é o mesmo para a entrada do produto e o produto processado.contentLanguage: o código de idioma ISO 639-1 de duas letras do produto.feedLabel: o rótulo do feed do produto.
Embora os comerciantes possam carregar produtos usando um arquivo chamado feed principal, há várias vantagens de criar e excluir produtos usando a API Merchant Center. Essas vantagens incluem tempo de resposta mais rápido e a capacidade de atualizar vários produtos em tempo real, sem a necessidade de gerenciar vários feeds complementares. Pode levar várias horas para que as mudanças no produto feitas pelas chamadas de API apareçam no banco de dados do Shopping Merchant Center.
O Google ajuda a manter determinados atributos dos seus produtos automaticamente. Para mais informações, consulte Ativar melhorias automáticas.
Pré-requisitos
Se você não tiver uma fonte de dados, crie uma usando a API Merchant Data sources ou o Merchant Center.
Se você já tem uma fonte de dados criada usando a interface do Merchant Center ou a API, use 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.
Fazer 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 para inserir um
produto usando a API Merchant Products.
Recuperar um produto processado da sua conta
Para recuperar um produto processado da sua conta, use o
método accounts.products.get. Pode levar vários minutos para que
o produto processado apareça após a inserção.
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 a que 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.