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.

Para agregar inventario de productos locales, sube 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 del punto de venta para mostrar productos locales en Google.

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

Recupera el estado de incorporación de un minorista

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}

Inserta 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.

Deberías ver 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.

Inserta 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 deseas enviar la venta.

Deberías ver 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.

Inserta 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 deseas enviar la tienda.

Deberías ver 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 minorista

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

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}: Solo puedes pasar el valor de cadena ONBOARDING_UI en este campo.