# Aperçu

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.

Les 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 :
* [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)
* [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)

Les 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 :
* [Lire la liste des objets virtuels](/fr/api/catalog/virtual-items-currency-catalog/get-virtual-items)
* [Lire la liste des monnaies virtuelles](/fr/api/catalog/virtual-items-currency-catalog/get-virtual-currency)
* [Lire la liste des packages de monnaie virtuelle](/fr/api/catalog/virtual-items-currency-catalog/get-virtual-currency-packages)
* [Lire la liste des lots](/fr/api/catalog/bundles-catalog/get-bundle-list)
* [Lire la liste des jeux](/fr/api/catalog/game-keys-catalog/get-games-list)

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

<div class="note">
  <b>Note</b><br><br>
  Pour des informations détaillées sur la configuration des limites dans le catalogue, consultez la section <a href="/fr/liveops/promotion-tools/liveops-number-limits/">Promotion usage limits</a>.
</div>

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

Les utilisateurs non authentifiés voient toujours le nombre maximal d'utilisations de la promotion.

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

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

**Scénario de configuration et d'application des limites**

1. 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`.
2. 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`.
3. L'utilisateur se connecte.
4. 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.
5. L'utilisateur sélectionne un objet promotionnel et effectue un achat.
6. 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.
7. Vous pouvez mettre à jour la limite en utilisant les appels API de la sous-section **Management** :
   * [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/)
   * [Définir une valeur de limite spécifique](/fr/api/liveops/user-limits-admin/set-user-promotion-limit/)
   * [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/)
8. 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.

![Limites de promotion](https://cdn.xsolla.net/developers/current/images/api_docs/promotion-limit.svg)