API de socios de feeds locales

El programa de socios de feeds locales permite que los minoristas participen en los anuncios del inventario local y las fichas de productos locales gratuitas sin tener que crear sus propios feeds de inventario de productos locales o principales. Los minoristas pueden proporcionar su información de ventas y de inventario a un proveedor de datos de confianza que pueda compartir esa información con Google. Para obtener la lista de socios de datos compatibles, consulta Acerca del programa de socios de feeds locales.

Para agregar el inventario de productos locales, sube un feed de inventario de productos locales. El feed de inventario de productos locales proporciona una lista de los artículos que se pueden vender en la tienda con atributos que los describen.

Para que tu proveedor de datos de inventario se agregue a Merchant Center, proporciona sus detalles en este formulario.

Cómo recuperar el estado de integración de un minorista

Puedes usar el método GetLfpState para recuperar el estado de las propiedades a nivel del comercio relacionadas con la integración de la asociación de feeds locales. En función de las propiedades proporcionadas, puedes verificar si la integración funciona según lo previsto o si se requiere alguna acción adicional.

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

Cómo insertar un inventario

Para insertar un inventario, usa la siguiente solicitud:

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}"
}

Es probable que veas la siguiente respuesta:

{
 "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 obtener más información, consulta Método: accounts.lfpInventories.insert.

Cómo insertar una oferta

Para insertar una venta, usa la siguiente solicitud:

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}"
}

Es probable que veas la siguiente respuesta:

{
 "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 obtener más información, consulta Método: accounts.lfpSales.insert.

Cómo insertar una tienda

Para insertar una tienda, usa la siguiente solicitud:

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}"
}

Es probable que veas la siguiente respuesta:

{
 "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 obtener más información, consulta Método: accounts.lfpStores.insert.

Cómo enviar una notificación a un minorista

Puedes usar el método SendLfpNotification para enviar una notificación a un minorista. Por ejemplo, puedes usar este método para enviar una notificación de integración al minorista.

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

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

Reemplaza lo siguiente:

  • {accountId}: El identificador único de tu cuenta de Merchant Center
  • {targetMerchantId}: El identificador único de la cuenta a la que deseas enviar la notificación
  • {emailAddress}: Es la dirección de correo electrónico de la cuenta a la que deseas enviar la notificación.
  • {Type}: Solo puedes pasar el valor de cadena ONBOARDING_UI en este campo.