# 概述

促销活动使用限制用于限制特定用户可使用某个促销活动的次数。您还可以配置定时重置限制。

限制数信息存储在艾克索拉侧，可在[发布商帐户](https://publisher.xsolla.com/0/projects/0/storefront/promotions)的促销活动设置中配置，也可以在以下API调用中通过`limits`对象配置：
* [为商品创建折扣促销活动](/zh/api/liveops/promotions-discounts/create-item-promotion/)或[更新折扣促销活动](/zh/api/liveops/promotions-discounts/update-item-promotion)
* [创建买赠促销活动](/zh/api/liveops/promotions-bonuses/create-bonus-promotion/)或[更新买赠促销活动](/zh/api/liveops/promotions-bonuses/update-bonus-promotion)

在以下用于获取商品目录的API调用中，限制信息会在`items.promotions.limits`对象中返回：
* [获取虚拟物品列表](/zh/api/catalog/virtual-items-currency-catalog/get-virtual-items/)
* [获取虚拟货币列表](/zh/api/catalog/virtual-items-currency-catalog/get-virtual-currency/)
* [获取虚拟货币套餐列表](/zh/api/catalog/virtual-items-currency-catalog/get-virtual-currency-package/)
* [获取捆绑包列表](/zh/api/catalog/bundles-catalog/get-bundle-list/)
* [获取游戏列表](/zh/api/catalog/game-keys-catalog/get-games-list/)

**限制**组的**管理**部分中的API调用可用于获取限制的当前状态，并针对特定用户更新限制，例如在任务完成后重置计数器，或手动调整剩余数量。

<div class="note">
  <b>注：</b><br><br>
  有关在商品目录中配置限制数的详细信息，请参阅<a href="/zh/liveops/promotion-tools/liveops-number-limits/">促销活动使用限制</a>部分。
</div>

您可以配置[limits.per_user](/zh/api/liveops/promotions-discounts/create-item-promotion#promotions-discounts/create-item-promotion/t=request&path=limits)，即单个用户可使用某个促销活动的次数限制。

未认证用户始终会看到促销活动的最大可使用次数。

如需显示用户在当前有效限制下剩余的促销活动可使用次数，请在请求商品目录时传入用户授权数据。

如需配置定时重置周期（日、周或月），请在[创建](/zh/api/liveops/promotions-discounts/create-item-promotion#promotions-discounts/create-item-promotion/t=request&path=limits/recurrent_schedule)或[更新](/zh/api/liveops/promotions-discounts/update-item-promotion#promotions-discounts/update-item-promotion/t=request&path=limits/recurrent_schedule)促销活动时传入`limits.recurrent_schedule`对象。

**限制配置和执行场景**

1. 使用[为商品创建折扣促销](/zh/api/liveops/promotions-discounts/create-item-promotion/)或[创建买赠促销活动](/zh/api/liveops/promotions-bonuses/create-bonus-promotion/) API调用创建促销活动，并传入`limits`对象。
2. 为未认证用户请求商品目录⸺响应会在`items.promotions.limits`对象中返回促销活动的最大可使用次数。
3. 用户登录。
4. 使用用户的授权令牌请求商品目录⸺响应会返回当前有效限制下的剩余可使用次数。
5. 用户选择促销商品并进行购买。
6. 支付成功后，艾克索拉会更新`items.promotions.limits.per_user`值。当该值达到`0`时，后续商品目录API调用会返回该商品，但不再包含折扣或赠品。
7. 您可以使用**管理**子部分中的API调用更新限制数：
   * [刷新指定用户的所有促销活动限制](/zh/api/liveops/user-limits-admin/reset-all-user-promotions-limit/)或[刷新特定促销活动的限制](/zh/api/liveops/user-limits-admin/reset-user-promotion-limit/)
   * [设置特定限制值](/zh/api/liveops/user-limits-admin/set-user-promotion-limit/)
   * [增加](/zh/api/liveops/user-limits-admin/add-user-promotion-limit/)或[减少可用次数](/zh/api/liveops/user-limits-admin/remove-user-promotion-limit/)
8. 在下一次使用用户授权令牌发起的商品目录请求中，您可以从`items.promotions.limits`获取更新后的限制值，并将其显示给用户。

![促销活动限制](https://cdn.xsolla.net/developers/current/images/api_docs/promotion-limit.svg)