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.
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.
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
enlocal
. Luego, puedes usar el servicio de inventario local para crear instancias de inventario local para cadastorecode
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
yinstoreProductLocation
.
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.