Migrar parceria de feeds locais

Você pode usar a API Merchant para compartilhar seus inventários, lojas e dados de vendas com o Google e melhorar a visibilidade e o gerenciamento.

Novos recursos

Além dos recursos da API Content, a API Merchant oferece os seguintes novos recursos:

• Um método para recuperar o estado das propriedades no nível do comerciante relacionadas à integração de parcerias de feeds locais
• um método para enviar uma notificação a um varejista;

Para mais detalhes sobre esses métodos, consulte a API de parceria de feeds locais.

Solicitações

Use o seguinte formato de URL de solicitação para a API de parceria de feeds locais:

POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert

Para mais informações, consulte Método: accounts.lfpInventories.insert.

Confira um exemplo de comparação da API Content for Shopping com a API de parceria de feeds locais para a solicitação de inserção de um inventário:

	API Content	API Merchant
URL	POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/inventory	POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert
Identificadores	{merchantId}/pos/{targetMerchantId}	{parent}

Este é um exemplo de comparação da API Content for Shopping com a API de parceria de feeds locais para a solicitação de inserção de uma venda:

	API Content	API Merchant
URL	POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/sale	POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpSales:insert
Identificadores	{merchantId}/pos/{targetMerchantId}	{parent}

Confira um exemplo de comparação da API Content for Shopping com a API de parceria de feeds locais para a solicitação de inserção de uma loja:

	API Content	API Merchant
URL	POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store	POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpStores:insert
Identificadores	{merchantId}/pos/{targetMerchantId}	{parent}

Métodos

Confira o que mudou para os métodos da API Store na API de parceria de feeds locais:

Método	URL na API Content for Shopping	URL na API Merchant	Identificadores na API Content for Shopping	Identificadores na API Merchant	Descrição
insert	POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store	POST https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores:insert	{merchantId} /pos/{targetMerchantId}	{parent}	parent está no formato accounts/{lfpPartnerAccountId}
delete	DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store/{storeCode}	DELETE https://merchantapi.googleapis.com/lfp/v1beta/{name=accounts/*/lfpStores/*}	{merchantId}/pos/{targetMerchantId}/store/{storeCode}	{name}	name está no formato accounts/{lfpPartnerAccountId}/lfpStores/{targetMerchantId}~{storeCode}
get	GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store/{storeCode}	GET https://merchantapi.googleapis.com/lfp/v1beta/{name=accounts/*/lfpStores/*}	{merchantId}/pos/{targetMerchantId}/store/{storeCode}	{name}	name está no formato accounts/{lfpPartnerAccountId}/lfpStores/{targetMerchantId}~{storeCode}
list	GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store	GET https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores	/{merchantId}/pos/{targetMerchantId}	{parent}	{parent} está no formato accounts/{lfpPartnerAccountId}

Confira o que mudou para os métodos da API de inventário na API de parceria de feeds locais:

Método	URL na API Content for Shopping	URL na API Merchant	Identificadores na API Content for Shopping	Identificadores na API Merchant	Descrição
insert	POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store	POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpInventories:insert	{merchantId}/pos/{targetMerchantId}	{parent}	parent está no formato accounts/{lfpPartnerAccountId}

Confira o que mudou para os métodos da API Sales na API de parceria de feeds locais:

Método	URL na API Content for Shopping	URL na API Merchant	Identificadores na API Content for Shopping	Identificadores na API Merchant	Descrição
insert	POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/pos/{targetMerchantId}/store	POST https://merchantapi.googleapis.com/lfp/v1beta/{parent}/lfpSales:insert	{merchantId}/pos/{targetMerchantId}	{parent}	{parent} está no formato accounts/{lfpPartnerAccountId}

Recursos

Veja o que mudou para o recurso de loja na API de parceria de feeds locais. Os campos não incluídos aqui permanecem inalterados.

API Content for Shopping	API Merchant	Descrição
Sem suporte	name: string	Novo campo adicionado para diferenciar lojas diferentes
Sem suporte	targetAccount: integer	A conta do comerciante para inserir inventários
targetCountry: string	regionCode: string	targetCountry foi renomeado como regionCode
websiteUrl: string	websiteUri: string	websiteUrl foi renomeado como websiteUri
kind: string	Sem suporte	kind não é compatível com a API de parceria de feeds locais

Confira o que mudou na inserção de um inventário. Os campos não incluídos aqui não são alterados.

API Content for Shopping	API Merchant	Descrição
Sem suporte	name: string	Um novo campo foi adicionado para diferenciar inventários diferentes
Sem suporte	targetAccount: integer	A conta do comerciante para a qual os inventários serão inseridos.
targetCountry: string	regionCode: string	targetCountry foi renomeado como regionCode O código de território CLDR do país onde o produto é vendido.
itemId: string	offerId: string	itemId foi renomeado como offerId
quantity: string	quantity: string	O quantity foi atualizado para ser opcional
Sem suporte	availability: string	availability é obrigatório
price: { object (Price) }	price: { object (Price) }	A definição de preço mudou. Para mais informações, consulte Preço.
timestamp: string	collectionTime: string	timestamp foi renomeado como collectionTime
kind: string	Sem suporte	kind não é compatível com a API de parceria de feeds locais.

Confira o que mudou na inserção de uma venda. Os campos não incluídos aqui não são alterados.

API Content for Shopping	API Merchant	Descrição
Sem suporte	name: string	Um novo campo foi adicionado para diferenciar inventários diferentes
Sem suporte	targetAccount:integer	A conta do comerciante para inserir as vendas
targetCountry: string	regionCode: string	O código de território CLDR do país onde o produto é vendido.
itemId: string	offerId: string	itemId foi renomeado como offerId
price: { object (Price) }	price: { object (Price) }	A definição de preço mudou. Para mais informações, consulte Preço.
timestamp: string	saleTime: string	timestamp foi renomeado como saleTime
kind: string	Sem suporte	kind não é compatível com a API de parceria de feeds locais.