Gestión de catálogos

​

Overview

La Catalog API es una solución de comercio que ofrece a los anunciantes la capacidad de configurar feeds de productos, agrupar productos en conjuntos y gestionar de forma integral los productos del catálogo. La Catalog API será una herramienta central que permitirá la gestión programática de catálogos y dará a los anunciantes más control sobre cómo se incorporan y actualizan sus catálogos.

Un catálogo contiene todo lo relacionado con el producto y el conjunto de productos del usuario y está asociado al handle del usuario. Actualmente, un usuario solo puede crear un catálogo. 

La Catalog API admite 2 formas de incorporar productos:

1. Scheduled Feed: el usuario puede añadir una URL de feed (CSV, TSV y XML) que se obtendrá periódicamente (X admite actualmente un archivo de hasta 8 GB)

2. Batch Products API: el usuario puede ver, crear, actualizar y eliminar atributos de productos con solicitudes por lotes (JSON)

Los comercios de X pueden crear conjuntos de productos basados en reglas de filtrado. Al hacerlo, podrán adjuntar metadatos adicionales a sus productos y crear conjuntos de productos especiales para mostrar estos productos a través de funciones de comercio orgánico o anuncios dinámicos de productos. La Catalog API y el administrador de compras de X admiten dos tipos de conjuntos de productos. 

1. Manual: el usuario puede seleccionar hasta 50 productos y establecer un nombre y una descripción

2. Filter: el usuario puede añadir hasta 30 filtros para generar automáticamente conjuntos con productos que cumplan estos filtros. Los tipos de filtros incluyen precio, categoría de producto de Google, tipo de producto, inventario, precio de oferta y campos personalizados.

Catalog API incluye 4 endpoints para gestionar el catálogo:

• Product Catalogs - Crear un contenedor para la información de producto
• Products -  Añadir, actualizar, ver y eliminar productos de los catálogos de forma síncrona
• Product Sets -  Ordenar productos en grupos basados en la información del producto
• Schedule Feeds - Configurar la incorporación asíncrona de datos de productos basados en archivos en los catálogos

​

Requisitos previos para la API de Catálogo

Los endpoints de la API de Catálogo están disponibles actualmente únicamente mediante acceso anticipado. Para solicitar acceso, comunícate con tu representante de X. 

Debes aceptar los términos de servicio a través de X Shopping Manager.

Para obtener más detalles sobre X Shopping Manager y las especificaciones de productos, consulta la guía de especificaciones de productos.

​

Límites de tasa

La siguiente tabla muestra los límites de tasa para cada endpoint.

​

Catálogo de productos

Método HTTP	Límite de solicitudes
GET /product_catalogs	1,000 por 15 minutos
POST /product_catalogs	20 por 15 minutos
PUT /product_catalogs/:product_catalog_id	20 por 15 minutos
DELETE /product_catalogs/:product_catalog_id	20 por 15 minutos

​

API de productos por lotes

Método HTTP	Límite de solicitudes
GET /product_catalogs/:product_catalog_id/products	1.000 por cada 15 minutos
PUT /product_catalogs/:product_catalog_id/products	600 por cada 15 minutos
DELETE /product_catalogs/:product_catalog_id/products	150 por cada 15 minutos

​

Conjuntos de productos

Método HTTP	Límite de solicitudes
GET /product_catalogs/:product_catalog_id/product_sets	2,000 cada 15 minutos
POST /product_catalogs/:product_catalog_id/product_sets	100 cada 15 minutos
PUT /product_catalogs/:product_catalog_id/product_sets/:product_set_id	500 cada 15 minutos
DELETE /product_catalogs/:product_catalog_id/product_sets/:product_set_id	100 cada 15 minutos

​

Feeds de productos

Método HTTP	Límite de solicitudes
GET /product_catalogs/:product_catalog_id/product_feeds	1,000 por 15 minutos
POST /product_catalogs/:product_catalog_id/product_feeds	20 por 15 minutos
PUT /product_catalogs/:product_catalog_id/product_feeds/:product_feed_id	20 por 15 minutos
DELETE /product_catalogs/:product_catalog_id/product_feeds/:product_feed_id	20 por 15 minutos