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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/inventory	POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert
Identificadores	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{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 venda:

	API Content	API Merchant
URL	POST https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/sale	POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpSales:insert
Identificadores	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store	POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpStores:insert
Identificadores	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store	POST https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores:insert	{MERCHANT_ID} /pos/{TARGETMERCHANT_ID}	{PARENT}	parent está no formato accounts/{IFP_PARTNER_ACCOUNT_ID}
delete	DELETE https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE}	DELETE https://merchantapi.googleapis.com/lfp/v1beta/{name=accounts/*/lfpStores/*}	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE}	{NAME}	name está no formato accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}
get	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE}	GET https://merchantapi.googleapis.com/lfp/v1beta/{name=accounts/*/lfpStores/*}	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store/{STORE_CODE}	{NAME}	name está no formato accounts/{IFP_PARTNER_ACCOUNT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}
list	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store	GET https://merchantapi.googleapis.com/lfp/v1beta/{parent=accounts/*}/lfpStores	/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{PARENT}	{PARENT} está no formato accounts/{IFP_PARTNER_ACCOUNT_ID}

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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store	POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpInventories:insert	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{PARENT}	parent está no formato accounts/{IFP_PARTNER_ACCOUNT_ID}

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/{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}/store	POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpSales:insert	{MERCHANT_ID}/pos/{TARGETMERCHANT_ID}	{PARENT}	{PARENT} está no formato accounts/{IFP_PARTNER_ACCOUNT_ID}

Recursos

Confira o que mudou para o recurso de loja na API de parceria de feeds locais. Os campos não incluídos aqui não são alterados.

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	Novo campo adicionado para diferenciar diferentes inventários
Sem suporte	targetAccount: integer	A conta do comerciante para inserir inventários.
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 arquivo 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 é aceito na 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	Novo campo adicionado para diferenciar diferentes inventários
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.