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 os seguintes novos recursos:
- Um método para recuperar o estado das propriedades no nível da empresa relacionadas à integração da parceria de feeds locais
- Um método para enviar uma notificação a um varejista
Para mais detalhes sobre esses métodos, consulte 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/v1/{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/v1/{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/v1/{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/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 da loja na API de parceria de feeds locais. Os campos não incluídos aqui não foram alterados.
| API Content for Shopping | API Merchant | Descrição |
| Sem suporte | name: string |
Adicionado 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 é 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 foram alterados.
| API Content for Shopping | API Merchant | Descrição |
| Sem suporte | name: string |
Adicionado novo campo para diferenciar inventários |
| Sem suporte | targetAccount: integer |
A conta do Merchant Center para inserir inventários. |
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 |
|
|
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 foram alterados.
| API Content for Shopping | API Merchant | Descrição |
| Sem suporte | name: string |
Adicionado novo campo para diferenciar inventários |
| Sem suporte | targetAccount:integer |
A conta do Merchant Center para inserir vendas |
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ço. |
timestamp: string |
saleTime: string |
timestamp foi renomeado como saleTime |
kind: string |
Sem suporte | kind não é aceito na API de parceria de feeds locais. |