> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Gestión de catálogos

<div id="overview">
  ## Overview
</div>

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](https://developer.x.com/en/docs/x-ads-api/catalog-management/api-reference/product-catalogs) - Crear un contenedor para la información de producto
* [Products](https://developer.x.com/en/docs/x-ads-api/catalog-management/api-reference/products) -  Añadir, actualizar, ver y eliminar productos de los catálogos de forma síncrona
* [Product Sets](https://developer.x.com/en/docs/x-ads-api/catalog-management/api-reference/product-sets) -  Ordenar productos en grupos basados en la información del producto
* [Schedule Feeds](https://developer.x.com/en/docs/twitter-ads-api/catalog-management/api-reference/scheduled-feeds) - Configurar la incorporación asíncrona de datos de productos basados en archivos en los catálogos

<div id="prerequisites-for-the-catalog-api">
  ### Requisitos previos para la API de Catálogo
</div>

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](https://ads.x.com/shopping_manager).

Para obtener más detalles sobre X Shopping Manager y las especificaciones de productos, consulta la [guía de especificaciones de productos](https://business.x.com/en/help/shopping-specs.html).

<div id="rate-limits">
  ### Límites de tasa
</div>

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

<div id="product-catalog">
  #### Catálogo de productos
</div>

| 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     |

<div id="batch-products-api">
  #### API de productos por lotes
</div>

| 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   |

<div id="product-sets">
  #### Conjuntos de productos
</div>

| 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   |

<div id="product-feeds">
  #### Feeds de productos
</div>

| 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     |