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} | parentestá no formatoaccounts/{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} | nameestá no formatoaccounts/{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} | nameestá no formatoaccounts/{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 formatoaccounts/{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} | parentestá no formatoaccounts/{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 formatoaccounts/{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 | targetCountryfoi renomeado comoregionCode | 
| websiteUrl: string | websiteUri: string | websiteUrlfoi renomeado comowebsiteUri | 
| kind: string | Sem suporte | kindnã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 | targetCountryfoi renomeado comoregionCodeO código de território CLDR do país em que o produto é vendido. | 
| itemId: string | offerId: string | itemIdfoi renomeado comoofferId | 
| quantity: string | quantity: string | quantityagora é 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 | timestampfoi renomeado comocollectionTime | 
| kind: string | Sem suporte | O kindnã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 | itemIdfoi renomeado comoofferId | 
|  | 
 | A definição de preço mudou. Para mais informações, consulte Preços. | 
| timestamp: string | saleTime: string | timestampfoi renomeado comosaleTime | 
| kind: string | Sem suporte | O kindnão é compatível com a API de parceria de feeds locais. |