API Local Feeds Partnership

O Programa de Parceria de Feeds Locais permite que os varejistas participem de anúncios de inventário local e listagens de produtos locais incluídas sem precisar criar os próprios 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 ver a lista de parceiros de dados aceitos, consulte Sobre o programa de parceria de feeds locais.

Para adicionar um inventário de produtos locais, faça upload de um feed de inventário de produtos locais.

Para adicionar seu provedor de dados de inventário ao Merchant Center, informe seus detalhes em Feedback do provedor de dados de ponto de venda para mostrar produtos disponíveis na loja física no Google.

Para aprender 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

Use o método lfpMerchantStates.get para recuperar o estado das propriedades no nível do comerciante relacionadas à integração do programa de parcerias de feeds locais. Com base nas propriedades fornecidas, é possível verificar se a integração está funcionando como esperado ou se é necessário realizar alguma outra ação.

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": "{TARGET_MERCHANT_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.
  • {TARGET_MERCHANT_ID}: o ID da conta da empresa para que você quer enviar o inventário.

A resposta será assim:

{
 "name": "accounts/{ACCOUNT_ID}/lfpInventories/{TARGET_MERCHANT_ID}~{STORE_CODE}~{OFFER_ID}",
 "targetAccount": "{TARGET_MERCHANT_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 promoção, 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": "{TARGET_MERCHANT_ID}"
}

Substitua:

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

A resposta será assim:

{
 "name": "accounts/{ACCOUNT_ID}/lfpSales/{UUID}",
 "targetAccount": "{TARGET_MERCHANT_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": "{TARGET_MERCHANT_ID}"
}

Substitua:

  • {STORE_CODE}: um identificador exclusivo da loja.
  • {TARGET_MERCHANT_ID}: o ID da conta da empresa para enviar a loja.

A resposta será assim:

{
 "name": "accounts/{ACCOUNT_ID}/lfpStores/{TARGET_MERCHANT_ID}~{STORE_CODE}",
 "targetAccount": "{TARGET_MERCHANT_ID}",
 "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 para 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 sua 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 onde você quer enviar a notificação.
  • {TYPE}: só é possível transmitir o valor de string ONBOARDING_UI nesse campo.