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 admitidos, consulta Acerca del programa de socios de feeds locales.

Puedes agregar inventario de productos locales subiendo un feed de inventario de productos locales.

Para que se agregue tu proveedor de datos de inventario a Merchant Center, proporciona tus detalles en Comentarios sobre el proveedor de datos de puntos de venta para mostrar productos locales en Google.

Para obtener información sobre la migración desde Content API for Shopping, consulta Migra la asociación de feeds locales.

Recupera el estado de incorporación de un comercio

Puedes usar el método lfpMerchantStates.get para recuperar el estado de las propiedades a nivel del comercio relacionadas con la integración de la asociación de feeds locales. Según 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/v1/accounts/{ACCOUNT_ID}/lfpMerchantStates/{TARGET_MERCHANT_ID}

Cómo insertar un inventario

Para insertar un inventario, usa la siguiente solicitud:

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

Reemplaza lo siguiente:

  • {PARENT}: El formato es accounts/{ACCOUNT_ID}, donde {ACCOUNT_ID} es el identificador único de la cuenta de Merchant Center.
  • {OFFER_ID}: Es el identificador único del producto.
  • {STORE_CODE}: Es el identificador de la tienda del comercio.
  • {TARGETMERCHANT_ID}: Es el ID de la cuenta de la empresa para la que deseas enviar el inventario.

Verás 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 venta

Para insertar una venta, usa la siguiente solicitud:

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

Reemplaza lo siguiente:

  • {TARGETMERCHANT_ID}: Es el ID de la cuenta de la empresa para la que se enviará la venta.

Verás 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 Method: accounts.lfpSales.insert.

Cómo insertar una tienda

Para insertar una tienda, usa la siguiente solicitud:

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

Reemplaza lo siguiente:

  • {STORE_CODE}: Es un identificador único de la tienda.
  • {TARGETMERCHANT_ID}: Es el ID de la cuenta de la empresa para la que se enviará la tienda.

Verás 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 accounts.lfpStores.insert.

Envía una notificación a un comercio

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

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

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

Reemplaza lo siguiente:

  • {ACCOUNT_ID}: Es el identificador único de tu cuenta de Merchant Center.
  • {TARGETMERCHANT_ID}: Es el identificador único de la cuenta a la que deseas enviar la notificación.
  • {EMAIL_ADDRESS}: Es la dirección de correo electrónico de la cuenta a la que deseas enviar la notificación.
  • {TYPE}: En este campo, solo puedes pasar el valor de cadena ONBOARDING_UI.