{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-@l10n/es/api/liveops/index.yaml","sidebar":"sidebar-@l10n/es/liveops-en.sidebars.yaml"},"props":{"definitionId":"@l10n/es/api/liveops/index.yaml","dynamicMarkdocComponents":[],"baseSlug":"/es/api/liveops","seo":{"title":"Descripción general","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"Los límites de uso de promociones le permiten restringir el número de veces que un usuario específico puede usar una promoción. También puede configurar restablecimientos programados de los límites.\n\nLos límites se almacenan en el lado de Xsolla y se configuran en la configuración de la promoción en [Cuenta del editor](https://publisher.xsolla.com/0/projects/0/storefront/promotions) o a través del objeto `limits` en las siguientes llamadas API:\n* [Crear promoción de descuento para un artículo](/es/api/liveops/promotions-discounts/create-item-promotion/) o [Actualizar promoción de descuento](/es/api/liveops/promotions-discounts/update-item-promotion)\n* [Crear promoción de bonificación](/es/api/liveops/promotions-bonuses/create-bonus-promotion/) o [Actualizar la promoción de bonificación](/es/api/liveops/promotions-bonuses/update-bonus-promotion)\n\nLa información de los límites se devuelve en el objeto `items.promotions.limits` en las siguientes llamadas API para recuperar el catálogo de artículos:\n* [Obtener lista de artículos virtuales](/es/api/catalog/virtual-items-currency-catalog/get-virtual-items/)\n* [Obtener lista de monedas virtuales](/es/api/catalog/virtual-items-currency-catalog/get-virtual-currency/)\n* [Obtener lista de paquetes de moneda virtual](/es/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package/)\n* [Obtener lista de lotes](/es/api/catalog/bundles-catalog/get-bundle-list/)\n* [Obtener lista de juegos](/es/api/catalog/game-keys-catalog/get-games-list/)\n\nLas llamadas de API en la subsección **Gestión** del grupo **Límites** le permiten recuperar el estado actual de los límites y actualizarlos para un usuario específico; por ejemplo, reiniciar el contador después de realizar una misión o ajustar manualmente la cantidad restante.\n\n<div class=\"note\">\n  <b>Nota:</b><br><br>\n  Para obtener información detallada sobre cómo configurar los límites en el catálogo, consulte la sección <a href=\"/es/liveops/promotion-tools/liveops-number-limits/\">Límites de uso de promociones</a>.\n</div>\n\nPuede configurar [limits.per_user](/es/api/liveops/promotions-discounts/create-item-promotion#promotions-discounts/create-item-promotion/t=request&path=limits): un límite en el número de veces que un solo usuario puede usar una promoción.\n\nLos usuarios no autenticados siempre ven el número máximo de veces que se puede usar la promoción.\n\nPara mostrar los usos restantes de la promoción del usuario con el límite activo aplicado, transmita los datos de autorización del usuario al solicitar el catálogo de artículos.\n\nPara configurar un periodo de restablecimiento programado —diario, semanal o mensual— transmita el objeto `limits.recurrent_schedule` al [crear](/es/api/liveops/promotions-discounts/create-item-promotion#promotions-discounts/create-item-promotion/t=request&path=limits/recurrent_schedule) o [actualizar](/es/api/liveops/promotions-discounts/update-item-promotion#promotions-discounts/update-item-promotion/t=request&path=limits/recurrent_schedule) una promoción.\n\n**Escenario de configuración y aplicación de límites**\n\n1. Crea una promoción usando la llamada API [Crear promoción de descuento para un artículo](/es/api/liveops/promotions-discounts/create-item-promotion/) o [Crear promoción de bonificación](/es/api/liveops/promotions-bonuses/create-bonus-promotion/) y pasa el objeto `limits`.\n2. Solicita el catálogo para un usuario no autenticado: la respuesta devuelve el número máximo de usos de la promoción en el objeto `items.promotions.limits`.\n3. El usuario inicia sesión.\n4. Solicita el catálogo con el token de autorización del usuario: la respuesta devuelve el número restante de usos con el límite activo aplicado.\n5. El usuario selecciona un artículo promocional y hace una compra.\n6. Después del pago realizado correctamente, Xsolla actualiza el valor `items.promotions.limits.per_user`. Cuando llega a `0`, el artículo se devuelve en las llamadas API del catálogo sin descuento ni bonificación.\n7. Puede actualizar el límite usando las llamadas API de la subsección **Gestión**:\n   * [actualizar todos los límites de promoción para un usuario especificado](/es/api/liveops/user-limits-admin/reset-all-user-promotions-limit/) o [actualizar los límites para una promoción específica](/es/api/liveops/user-limits-admin/reset-user-promotion-limit/)\n   * [establecer un valor de límite específico](/es/api/liveops/user-limits-admin/set-user-promotion-limit/)\n   * [aumentar](/es/api/liveops/user-limits-admin/add-user-promotion-limit/) o [disminuir el número disponible de usos](/es/api/liveops/user-limits-admin/remove-user-promotion-limit/)\n8. Recupera el valor de límite actualizado en `items.promotions.limits` en la siguiente solicitud de catálogo realizada con el token de autorización del usuario y lo muestra al usuario.\n\n![Límites de promoción](https://cdn.xsolla.net/developers/current/images/api_docs/promotion-limit.svg)"},"itemId":"promotion-limits-overview","disableAutoScroll":true,"metadata":{},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"xsolla.redocly.app","port":4000,"ipAddress":"216.73.216.4"},"lang":"es","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/es/api/liveops/promotion-limits-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}