API de parceria de feeds locais

Com o programa de parceria de feeds locais, os varejistas podem participar de anúncios de inventário local e listagens de produtos locais sem custo financeiro sem precisar criar feeds principais e de inventário de produtos locais. Os varejistas podem fornecer as informações de vendas e inventário a um provedor de dados confiável que pode compartilhar essas informações com o Google. Para conferir a lista de parceiros de dados compatíveis, consulte Sobre o programa de parceria de feeds locais.

Para adicionar o inventário de produtos locais, faça upload de um feed de inventário de produtos locais. O feed de inventário de produtos locais fornece uma lista de itens que podem ser vendidos na loja com atributos que os descrevem.

Para adicionar o provedor de dados de inventário ao Merchant Center, forneça os detalhes dele neste formulário.

Extrair o status de integração de um varejista

Você pode usar o método GetLfpState para recuperar o estado das propriedades no nível do comerciante relacionadas à integração de parceria de feeds locais. Com base nas propriedades fornecidas, você pode verificar se a integração está funcionando como esperado ou se alguma ação adicional é necessária.

GET https://merchantapi.googleapis.com/lfp/v1beta/accounts/{ACCOUNT_ID}/lfpState/{TARGET_MERCHANT_ID}

Inserir um inventário

Para inserir um inventário, use a seguinte solicitação:

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

{
 "availability": "in stock",
 "collectionTime": "2024-01-08T08:00:00Z",
 "contentLanguage": "en",
 "gtin": "gtin",
 "offerId": "{OFFER_ID}",
 "pickupMethod": "buy",
 "pickupSla": "same day",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "regionCode": "US",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

Você vai receber a seguinte resposta:

{
 "name": "accounts/{merchantId}/lfpInventories/{TARGETMERCHANT_ID}~{STORE_CODE}~{OFFER_ID}",
 "targetAccount": "{TARGETMERCHANT_ID}",
 "storeCode": "123",
 "offerId": "{OFFER_ID}",
 "regionCode": "US",
 "contentLanguage": "en",
 "gtin": "gtin",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "availability": "in stock",
 "collectionTime": "2024-01-08T08:00:00Z",
 "pickupMethod": "buy",
 "pickupSla": "same day",
 "feedLabel": "US"
}

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

Inserir uma venda

Para inserir uma venda, use a seguinte solicitação:

POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpSales:insert

{
 "contentLanguage": "en",
 "gtin": "gtin",
 "offerId": "offerId",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "quantity": 2,
 "regionCode": "US",
 "saleTime": "2024-01-08T08:00:00Z",
 "storeCode": "123",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

Você vai receber a seguinte resposta:

{
 "name": "accounts/1000005718521947/lfpSales/{UUID}",
 "targetAccount": "{TARGETMERCHANT_ID}",
 "storeCode": "123",
 "offerId": "offerId",
 "regionCode": "US",
 "contentLanguage": "en",
 "gtin": "gtin",
 "price": {
   "amountMicros": "1000000",
   "currencyCode": "USD"
 },
 "quantity": "2",
 "saleTime": "2024-01-08T08:00:00Z",
 "uid": "{UUID}",
 "feedLabel": "US"
}

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

Inserir uma loja

Para inserir uma loja, use a seguinte solicitação:

POST https://merchantapi.googleapis.com/lfp/v1beta/{PARENT}/lfpStores:insert

{
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "storeCode": "{STORE_CODE}",
 "targetAccount": "{TARGETMERCHANT_ID}"
}

Você vai receber a seguinte resposta:

{
 "name": "accounts/{MERCHANT_ID}/lfpStores/{TARGETMERCHANT_ID}~{STORE_CODE}",
 "targetAccount": "1000005718454644",
 "storeCode": "{STORE_CODE}",
 "storeAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
 "matchingState": "STORE_MATCHING_STATE_MATCHED"
}

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

Enviar uma notificação para um varejista

É possível usar o método SendLfpNotification para enviar uma notificação a um revendedor. Por exemplo, é possível usar esse método para enviar uma notificação de integração ao varejista.

POST https://merchantapi.googleapis.com/lfp/v1beta/accounts/{accountId}/lfpNotifications:send

{
  "target_account": {targetMerchantId},
  "email_address": {emailAddress},
  "type": {Type}
}

Substitua:

  • {accountId}: o identificador exclusivo da sua conta do Merchant Center
  • {targetMerchantId}: o identificador exclusivo da conta para a qual você quer enviar a notificação
  • {emailAddress}: o endereço de e-mail da conta para a qual você quer enviar a notificação.
  • {Type}: só é possível transmitir o valor da string ONBOARDING_UI neste campo.