Migrar parceria de feeds locais

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

Novos recursos

Além dos recursos da API Content, a API Merchant oferece as seguintes novas funcionalidades:

  • Um método para recuperar o estado das propriedades no nível da empresa relacionadas à integração de parceria de feeds locais.
  • Um método para enviar uma notificação a um varejista

Para mais detalhes sobre esses métodos, consulte API Local Feeds Partnership.

Solicitações

Use o seguinte formato de URL de solicitação para a API Local Feeds Partnership:

POST https://merchantapi.googleapis.com/lfp/v1/{PARENT}/lfpInventories:insert

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

Confira um exemplo de comparação entre a API Content for Shopping e 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/v1/{PARENT}/lfpInventories:insert
Identificadores {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT}

Confira um exemplo de comparação entre a API Content for Shopping e a API de parceria de feeds locais para a solicitação de inserção de uma promoção:

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/v1/{PARENT}/lfpSales:insert
Identificadores {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT}

Confira um exemplo de comparação entre a API Content for Shopping e 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/v1/{PARENT}/lfpStores:insert
Identificadores {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT}

Métodos

Confira o que mudou nos métodos da API Store na API do programa 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/v1/{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/v1/{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/v1/{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/v1/{parent=accounts/*}/lfpStores /{MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT} {PARENT} está no formato accounts/{IFP_PARTNER_ACCOUNT_ID}

Confira o que mudou nos métodos da API Inventory na API do programa 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/v1/{PARENT}/lfpInventories:insert {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT} parent está no formato accounts/{IFP_PARTNER_ACCOUNT_ID}

Confira o que mudou nos métodos da API de vendas 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/v1/{PARENT}/lfpSales:insert {MERCHANT_ID}/pos/{TARGETMERCHANT_ID} {PARENT} {PARENT} está no formato accounts/{IFP_PARTNER_ACCOUNT_ID}

Recursos

Confira o que mudou no recurso de loja na API do programa 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 Adicionamos um novo campo para diferenciar as lojas.
Sem suporte targetAccount: integer A conta do Merchant Center em que os inventários serão inseridos.
targetCountry: string regionCode: string targetCountry foi renomeado como regionCode
websiteUrl: string websiteUri: string websiteUrl foi renomeado como websiteUri
kind: string Sem suporte O kind não é aceito na 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 Adição de um novo campo para diferenciar inventários
Sem suporte targetAccount: integer A conta do Merchant Center em que 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 em que o produto é vendido.
itemId: string offerId: string itemId foi renomeado como offerId
quantity: string quantity: string 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 O kind não é aceito na API de parceria de feeds locais.

Veja o que mudou para inserir 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 Adição de um novo campo para diferenciar inventários
Sem suporte targetAccount:integer A conta do Merchant Center em que as vendas serão inseridas.
targetCountry: string regionCode: string O código de território CLDR do país em que 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 O kind não é aceito na API de parceria de feeds locais.