Servicio de inventario local

Nos gustaría presentar la versión beta de la API de Merchant. Es la nueva versión de Content API y el futuro.

El servicio de inventario local te permite crear y actualizar instancias del recurso de inventario local, que contienen campos que pueden tener valores diferentes para diferentes 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 diferentes tiendas, pero que comparte un ID, una descripción y otros datos del producto en todas las tiendas. Los datos del inventario local se usan para 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.

Nota: En la versión 2.1 de Content API, el servicio de inventario local y los feeds complementarios reemplazan al servicio de inventario de la versión 2. Para realizar actualizaciones parciales de datos de productos no locales con la versión 2.1 de la API, usa feeds complementarios. Para realizar actualizaciones complementarias de productos locales, usa el servicio de localinventory.

Requisitos previos

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

• Tu cuenta de Merchant Center debe estar inscrita en un programa local, ya sea en las plataformas locales de Google o en los anuncios del inventario local. Si quieres obtener más información para usar los anuncios del inventario local a través de Content API, consulta Comienza a usar los anuncios del inventario local.

  Nota: Si tu cuenta de Merchant Center no está inscrita en un programa local y configuras el campo channel de un producto como local mediante el método Products.insert, se mostrará el siguiente error: “channel Canal no válido: local”.

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

Campos

Cada instancia del inventario local contiene un conjunto de campos asociados con la ubicación de una 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 oferta 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). Con la solicitud, también se actualiza la cantidad disponible para la instancia del inventario local. A diferencia de los feeds complementarios para datos de productos que no son locales, esta llamada reemplaza los campos que no están incluidos en el cuerpo de la solicitud:

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.

Nota: No es posible recuperar, enumerar ni borrar instancias de inventario local. Para ver los datos del inventario local en Merchant Center, selecciona un producto local en la página Todos los productos y, luego, expande la sección Inventario local. En la tabla, se muestran los datos del inventario local de cada código de tienda.