Servicio de inventario local

El servicio de inventario local te permite crear y actualizar instancias del recurso de inventario local, que contiene campos que pueden tener valores diferentes para distintas ubicaciones de tiendas físicas. Cada instancia de inventario local es un elemento secundario de un recurso de producto existente y hereda los campos de datos del producto del recurso superior. Por ejemplo, puedes tener un producto con un precio y una cantidad diferentes en tiendas diferentes, pero que comparte un ID, una descripción y otros datos de productos en todas ellas. Los datos del inventario local se usan en los programas Plataformas locales de Google y Anuncios del inventario local.

En esta guía, se explica lo que necesitas antes de comenzar a usar el servicio de inventario local, se describen los campos y métodos disponibles y se proporciona un ejemplo de una solicitud de servicio.

Requisitos previos

  • Para usar el servicio de inventario local, debes crear un Perfil de Negocio, vincularlo a tu cuenta de Merchant Center, verificar tu empresa y configurar los códigos de tienda del Perfil de Negocio.

  • Tu cuenta de Merchant Center debe estar inscrita en un programa local, ya sea Plataformas locales de Google o Anuncios del inventario local. Para obtener más información sobre el uso de anuncios del inventario local a través de Content API, consulta Comienza a usar anuncios del inventario local.

  • El servicio de inventario local crea instancias de inventario local para productos locales existentes. Primero debes crear productos locales con el servicio de productos de Content API o los feeds de datos de Merchant Center. Para ello, establece el campo channel en local. Luego, puedes usar el servicio de inventario local a fin de crear instancias de inventario local para cada storecode de Perfil de Negocio en el que se vende el producto.

Campos

Cada instancia del inventario local contiene un conjunto de campos asociados con una ubicación de tienda específica a través del campo storeCode (que defines en tu Perfil de Negocio). Solo se requieren storecode y productId para todas las solicitudes. Todos los demás campos son opcionales:

  • Obligatorio para todas las solicitudes: storeCode, productId (en la URL)
  • Opcional: quantity, price, salePrice, salePriceEffectiveDate, availability, pickupMethod, pickupSla y instoreProductLocation

Para obtener una lista completa de los campos del inventario local y sus descripciones, consulta la página de referencia de localinventory.

Métodos

El servicio de inventario local solo incluye dos métodos:

localinventory.insert

localinventory.insert te permite crear una instancia de inventario local para un solo producto local.

En este ejemplo, se muestra cómo usar el servicio de inventario local para crear una venta en la tienda desde el 24 de febrero de 2021 a la 1:00 p.m. (GMT-8) hasta el 28 de febrero de 2021 a las 3:30 p.m. (GMT-8). La solicitud también actualiza la cantidad disponible de la instancia del inventario local. A diferencia de los feeds complementarios para datos de productos no locales, los campos que no se incluyen en el cuerpo de la solicitud se reemplazan con esta llamada:

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId/localinventory

{
  "storeCode": “1235”,
  "salePrice": {
     "value": “100.00”,
     "currency": “USD”
   },
  "salePriceEffectiveDate": “2021-02-24T13:00-0800/2021-02-28T15:30-0800”,
  "quantity": 200,
}

localinventory.custombatch

localinventory.custombatch te permite crear varias instancias de inventario local para un solo producto local en varias tiendas o crear instancias de inventario local para varios productos locales.