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 locais sem precisar criar feeds principais e de inventário de produtos locais. Os varejistas podem fornecer 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.

É possível adicionar inventário de produtos locais fazendo upload de um feed de inventário de produtos locais.

Para adicionar seu provedor de dados de inventário ao Merchant Center, envie seus detalhes em Feedback do provedor de dados do 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.

Recuperar o status de integração de um varejista

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

GET https://merchantapi.googleapis.com/lfp/v1/accounts/{ACCOUNT_ID}/lfpMerchantStates/{TARGET_MERCHANT_ID}

Inserir um inventário

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

POST https://merchantapi.googleapis.com/lfp/v1/{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}"
}

Substitua:

  • {PARENT}: o formato é accounts/{ACCOUNT_ID}, em que {ACCOUNT_ID} é o identificador exclusivo da conta do Merchant Center.
  • {OFFER_ID}: o identificador exclusivo do produto.
  • {STORE_CODE}: o identificador da loja do comerciante.
  • {TARGETMERCHANT_ID}: o ID da conta da empresa para a qual você quer enviar o inventário.

Você vai encontrar 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 promoção

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

POST https://merchantapi.googleapis.com/lfp/v1/{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}"
}

Substitua:

  • {TARGETMERCHANT_ID}: o ID da conta da empresa para enviar a venda.

Você vai encontrar 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/v1/{PARENT}/lfpStores:insert

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

Substitua:

  • {STORE_CODE}: um identificador exclusivo da loja.
  • {TARGETMERCHANT_ID}: o ID da conta da empresa que vai enviar a loja.

Você vai encontrar 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 ver mais informações, consulte accounts.lfpStores.insert.

Enviar uma notificação a um varejista

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

POST https://merchantapi.googleapis.com/lfp/v1/accounts/{ACCOUNT_ID}/lfpNotifications:send

{
  "target_account": {TARGETMERCHANT_ID},
  "email_address": {EMAIL_ADDRESS},
  "type": {TYPE}
}

Substitua:

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