Gestión del catálogo

​

Descripción general

La Catalog API es una solución de comercio que brinda 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 fundamental que habilita la gestión programática del catálogo y otorga a los anunciantes un mayor 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 con su handle. Actualmente, un usuario solo puede crear un catálogo. 

La Catalog API admite 2 formas de incorporar productos:

1. Scheduled Feed: el usuario puede agregar una URL de feed (CSV, TSV y XML) que se recuperará periódicamente (X actualmente admite archivos 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 metadata adicional a sus productos y crear conjuntos de productos especiales para mostrar estos productos mediante funciones de comercio orgánicas 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 agregar 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.

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

• Product Catalogs - Creación de un contenedor para información de productos
• Products -  Adición, actualización, visualización y eliminación sincrónica de productos de los catálogos
• Product Sets -  Clasificación de productos en grupos según la información del producto
• Schedule Feeds - Configuración de la ingesta asíncrona de datos de productos basados en archivos en los catálogos

​

Requisitos previos para la Catalog API

Los endpoints de la Catalog API están disponibles actualmente solo mediante acceso anticipado. Para solicitar acceso, póngase en contacto con su representante de X.

Debe aceptar los Términos del servicio a través de X Shopping Manager.

Para obtener detalles sobre Shopping Manager y las especificaciones de productos, consulte la Guía de especificaciones de productos.

​

Límites de velocidad 

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

​

Catálogo de productos

Método HTTP	Límite de tasa
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 en lote

Método HTTP	Límite de tasa
GET /product_catalogs/:product_catalog_id/products	1,000 por 15 minutos
PUT /product_catalogs/:product_catalog_id/products	600 por 15 minutos
DELETE /product_catalogs/:product_catalog_id/products	150 por 15 minutos

​

Conjuntos de productos

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

​

Feeds de productos

Método HTTP	Límite de tasa
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