Gestión de catálogos

​

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 central que habilita la gestión programática de catálogos y otorga a los anunciantes mayor control sobre cómo se incorporan y actualizan sus catálogos.

Un catálogo reúne todo lo relacionado con los productos del usuario y los conjuntos de productos, 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 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 en 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 exhibirlos mediante 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 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 la información de productos
• Products -  Adición, actualización, visualización y eliminación síncronas de productos en los catálogos
• Product Sets -  Clasificación de productos en grupos según la información del producto
• Schedule Feeds - Configuración de la incorporación 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 más información sobre Shopping Manager y las especificaciones de productos, consulte la Guía de especificaciones de productos.

​

Límites de uso 

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

​

Catálogo de productos

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

​

API de productos por lotes

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