Migrar parceria de feeds locais

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

Novos recursos

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

  • 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 a API de parceria de feeds locais.

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 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/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 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 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 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/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 "store" 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 Adicionado um novo campo para diferenciar lojas
Sem suporte targetAccount: integer A conta do Merchant Center 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 permanecem inalterados.

API Content for Shopping API Merchant Descrição
Sem suporte name: string Adicionado um novo campo para diferenciar diferentes 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 agora é 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ços.
timestamp: string collectionTime: string timestamp foi renomeado como collectionTime
kind: string Sem suporte O 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 permanecem inalterados.

API Content for Shopping API Merchant Descrição
Sem suporte name: string Adicionado um novo campo para diferenciar diferentes 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ços.
timestamp: string saleTime: string timestamp foi renomeado como saleTime
kind: string Sem suporte O kind não é compatível com a API de parceria de feeds locais.