Migrar o gerenciamento de produtos

É possível usar a API Merchant para fazer upload e gerenciar seus produtos de forma programática. O recurso accounts.products permite criar um catálogo de lojas on-line, que é uma lista de produtos e ofertas. Para mais informações sobre como fazer upload e gerenciar seus produtos usando a API Merchant, consulte Visão geral da API Merchant Products.

Mudanças de recurso

Os recursos products e productstatuses da API Content foram substituídos por productInputs e products.

Você pode usar o recurso productInputs da API Merchant para fazer upload das informações do produto. O recurso product da API Merchant pode ser usado para recuperar os produtos processados, incluindo os status.

Requisito de origem de dados

Na API Merchant, é necessário especificar a fonte de dados de destino ao fazer upload de produtos. Ela pode ser uma fonte de dados principal ou complementar. É possível recuperar as fontes de dados atuais usando dataSources.list ou criar uma nova usando dataSources.create.

Como alternativa, use a interface do Merchant Center para gerenciar suas fontes de dados.

Para mais informações sobre as fontes de dados e como criá-las e gerenciá-las, consulte Visão geral da API Merchant Data Sources.

Mudanças no identificador

A API Merchant usa name para identificar o produto. O nome do produto vai seguir o formato accounts/{account}/products/{product}, em que {product} tem o formato channel~language~feedLabel~offerId.

Os recursos da API Content usavam : em vez de ~ entre cada valor no ID: channel:language:feedLabel:offerId.

Todas as chamadas da API Merchant retornam o novo formato com ~ entre os valores do ID. Recomendamos armazenar o novo campo name da resposta e usá-lo em chamadas futuras.

Métodos

Confira uma comparação dos métodos de produtos na API Content for Shopping e na API Merchant Products:

API Content for Shopping	API Merchant Products
products.custombatch	Indisponível
products.insert	productInputs.insert
products.update	Ainda não disponível
products.delete	productInputs.delete
products.get	products.get
products.list	products.list
productstatuses.custombatch	Indisponível
productstatuses.get	products.get
productstatuses.list	products.list

Solicitações

Método da API Content	URL na API Content for Shopping	URL na API Merchant Products	Identificador na API Content	Identificador na API Merchant Products
products.insert	POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products	POST https://merchantapi.googleapis.com/products/v1beta/{PARENT}/productsInputs:insert?dataSource=accounts/{MERCHANT_ID}/dataSources/{DATASOURCE_ID}	MERCHANT_ID	PARENT=accounts/{MERCHANT_ID}
products.update	PATCH https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}	Indisponível
products.delete	DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}	DELETE https://merchantapi.googleapis.com/products/v1beta/{NAME}?dataSource=accounts/{MERCHANT_ID}/dataSources/{DATASOURCE_ID}	MERCHANT_ID, PRODUCT_ID	NAME=accounts/{MERCHANT_ID}/productInputs/{PRODUCT_ID_WITH_TILDES}
products.get	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products/{PRODUCT_ID}	GET https://merchantapi.googleapis.com/products/v1beta/{NAME}	MERCHANT_ID, PRODUCT_ID	NAME=accounts/{MERCHANT_ID}/products/{PRODUCT_ID_WITH_TILDES}
products.list	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/products	GET https://merchantapi.googleapis.com/products/v1beta/{PARENT}/products	MERCHANT_ID	PARENT=accounts/{MERCHANT_ID}
productstatuses.get	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/productstatuses/{PRODUCT_ID}	GET https://merchantapi.googleapis.com/products/v1beta/{NAME}	MERCHANT_ID, PRODUCT_ID	NAME=accounts/{MERCHANT_ID}/products/{PRODUCT_ID_WITH_TILDES}
productstatuses.list	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/productstatuses	GET https://merchantapi.googleapis.com/products/v1beta/{PARENT}/products	MERCHANT_ID	PARENT=accounts/{MERCHANT_ID}