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 sem custo financeiro de produtos disponíveis na loja física 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 com suporte, 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.

Para adicionar o provedor de dados de inventário ao Merchant Center, forneça seus detalhes em Feedback do provedor de dados de ponto de venda para mostrar produtos locais no Google.

Para saber mais sobre a migração da API Content for Shopping, consulte Migrar a parceria de feeds locais.

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.