{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-@l10n/fr/api/liveops/index.yaml","sidebar":"sidebar-@l10n/fr/liveops-en.sidebars.yaml"},"props":{"definitionId":"@l10n/fr/api/liveops/index.yaml","dynamicMarkdocComponents":[],"baseSlug":"/fr/api/liveops","seo":{"title":"Aperçu","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"Les limites d'utilisation des promotions permettent de restreindre le nombre de fois qu'un utilisateur peut utiliser une promotion. Vous pouvez également configurer des réinitialisations de limites planifiées.\n\nLes limites sont stockées côté de Xsolla et configurées dans les paramètres de promotion dans le [Compte éditeur](https://publisher.xsolla.com/0/projects/0/storefront/promotions) ou via l'objet `limits` dans les appels API suivants :\n* [Créer une promotion par réduction pour un objet](/fr/api/liveops/promotions-discounts/create-item-promotion/) ou [Mettre à jour une promotion par réduction](/fr/api/liveops/promotions-discounts/update-item-promotion)\n* [Créer une promotion par bonus](/fr/api/liveops/promotions-bonuses/create-bonus-promotion/) ou [Mettre à jour une promotion par bonus](/fr/api/liveops/promotions-bonuses/update-bonus-promotion)\n\nLes informations sur les limites sont renvoyées dans l'objet `items.promotions.limits` dans les appels API suivants de récupération du catalogue des objets :\n* [Lire la liste des objets virtuels](/fr/api/catalog/virtual-items-currency-catalog/get-virtual-items)\n* [Lire la liste des monnaies virtuelles](/fr/api/catalog/virtual-items-currency-catalog/get-virtual-currency)\n* [Lire la liste des packages de monnaie virtuelle](/fr/api/catalog/virtual-items-currency-catalog/get-virtual-currency-packages)\n* [Lire la liste des lots](/fr/api/catalog/bundles-catalog/get-bundle-list)\n* [Lire la liste des jeux](/fr/api/catalog/game-keys-catalog/get-games-list)\n\nLes appels API de la sous-section **Gestion** du groupe **Limites** vous permettent de récupérer l'état actuel des limites et de les mettre à jour pour un utilisateur spécifique, par exemple, réinitialiser le compteur après la fin d'une quête ou ajuster manuellement la quantité restante.\n\n
\n Note

\n Pour des informations détaillées sur la configuration des limites dans le catalogue, consultez la section Promotion usage limits.\n
\n\nVous pouvez configurer [limits.per_user](/fr/api/liveops/promotions-discounts/create-item-promotion#promotions-discounts/create-item-promotion/t=request&path=limits) — une limite du nombre d'utilisations d'une promotion par utilisateur unique.\n\nLes utilisateurs non authentifiés voient toujours le nombre maximal d'utilisations de la promotion.\n\nPour afficher le nombre d'utilisations restantes d'une promotion pour un utilisateur, avec la limite active appliquée, passez les données d'autorisation de l'utilisateur lors de la requête du catalogue des objets.\n\nPour configurer une période de réinitialisation planifiée, quotidienne, hebdomadaire ou mensuelle — passez l'objet `limits.recurrent_schedule` lors de la [création](/fr/api/liveops/promotions-discounts/create-item-promotion#promotions-discounts/create-item-promotion/t=request&path=limits/recurrent_schedule) ou de la [mise à jour](/fr/api/liveops/promotions-discounts/update-item-promotion#promotions-discounts/update-item-promotion/t=request&path=limits/recurrent_schedule) d'une promotion.\n\n**Scénario de configuration et d'application des limites**\n\n1. Vous créez une promotion en utilisant l'appel API [Créer une promotion par réduction pour un objet](/fr/api/liveops/promotions-discounts/create-item-promotion/) ou l'appel API [Créer une promotion par bonus](/fr/api/liveops/promotions-bonuses/create-bonus-promotion/) et vous passez l'objet `limits`.\n2. Vous interrogez le catalogue pour un utilisateur non authentifié, la réponse renvoie le nombre maximum d'utilisations de la promotion dans l'objet `items.promotions.limits`.\n3. L'utilisateur se connecte.\n4. Vous demandez le catalogue avec le jeton d'autorisation de l'utilisateur, la réponse renvoie le nombre d'utilisations restantes avec la limite active appliquée.\n5. L'utilisateur sélectionne un objet promotionnel et effectue un achat.\n6. Après un paiement réussi, Xsolla met à jour la valeur `items.promotions.limits.per_user`. Lorsqu'elle atteint `0`, l'objet est retourné dans les appels API du catalogue sans remise ni bonus.\n7. Vous pouvez mettre à jour la limite en utilisant les appels API de la sous-section **Management** :\n * [Actualiser toutes les limites de promotion pour un utilisateur spécifique](/fr/api/liveops/user-limits-admin/reset-all-user-promotions-limit/) ou [réinitialiser les limites pour une promotion spécifique](/fr/api/liveops/user-limits-admin/reset-user-promotion-limit/)\n * [Définir une valeur de limite spécifique](/fr/api/liveops/user-limits-admin/set-user-promotion-limit/)\n * [augmenter](/fr/api/liveops/user-limits-admin/add-user-promotion-limit/) ou [diminuer le nombre d'utilisations disponibles](/fr/api/liveops/user-limits-admin/remove-user-promotion-limit/)\n8. Vous récupérez la valeur de limite mise à jour dans `items.promotions.limits` lors de la prochaine requête du catalogue effectuée avec le jeton d'autorisation de l'utilisateur, puis vous l'affichez à l'utilisateur.\n\n![Limites de promotion](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.177"},"lang":"fr","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/fr/api/liveops/promotion-limits-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}