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 |
|
|
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 |
|
|
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. |