商品购买数量限制
工作原理
您可以为每位用户设置购买数量限制，并配置这些限制的定期重置。
以下场景可配置购买数量限制：
- 销售游戏内商品——虚拟物品、虚拟货币套餐和捆绑包
- 通过游戏Key销售游戏和DLC
启用周期性数量限制重置可以：
- 允许重复购买
- 当商品在多个发布平台销售时与您的系统同步数据
要正确显示用户可购买的数量，必须配置身份认证。
未认证用户只能看到可购买商品的最大数量。若要显示应用限制后用户的剩余可购商品数量，请在以下请求中包含用户授权数据：
- 使用Virtual Items & Currency组Catalog子部分的调用获取商品目录
- 使用Game Keys组Catalog子部分的调用获取游戏目录
艾克索拉会执行限制，防止用户购买超过设定数量的商品：
- 当支付UI打开且商品已付款后，所有包含该商品的未支付订单将自动失效。
- 示例：用户可能在完成购买前，通过多个浏览器标签页或不同浏览器打开了限量商品的支付表单，这会为同一商品创建多个订单。一旦在某个标签页完成购买，艾克索拉会自动取消该商品的所有未支付订单。
- 发生退款或取消订单时，限制不会重置。您可以使用以下API调用进行重置：刷新指定用户的所有购买限制和刷新指定用户的所有促销活动限制。
- 示例：用户可以购买带有购买数量限制的商品，在游戏中使用后再申请退款。若限制会自动重置，用户就能再次购买并使用该商品，如此循环，等于绕过了预期的限制。为防止这种情况，发生退款或取消订单时不会自动重置限制。
如需配置促销活动使用限制，请参阅说明。
配置和更新限制
在发布商帐户中配置和更新
要创建购买次数有限的商品：
- 在发布商帐户中打开项目，前往Items catalog > All items > Virtual items部分。
- 在帐户中打开项目，前往Items catalog > All items > Virtual items部分。
- 在帐户中打开项目，前往Items catalog > All items > Virtual items部分。
- 在帐户中打开项目，前往Items catalog > All items > Virtual items部分。
- 在移动端游戏专用帐户中打开项目，并前往Catalog部分。
- 点击Create manually，并在下拉列表中选择Virtual item。
- 在 General settings 部分，填写：
- SKU
- 商品所属的一个或多个组（可选）
- 名称
- 简短描述
- 扩展描述—要添加，请打开相应的开关（可选）
- 在 Media 部分，上传一张或多张图片或视频（可选）——可从设备上传或通过链接添加。使用艾克索拉建站器创建的网站中，所有商品卡片都会显示被标记为 Main 的文件，其余文件仅在带有媒体图库的商品卡片中可见。被标记为 Main 的文件也会在目录检索API调用的响应中返回。
- 在Price settings部分，设置价格或创建免费商品：
- 如需设置价格，选择Paid item，打开Real currency prices和/或Virtual currency prices开关，并指定价格。如有需要，配置区域价格。
- 如需创建免费商品，选择Free item。
一个商品可以设置多种真实货币和虚拟货币的价格。在这种情况下，必须为每种类型指定默认货币：一种用于真实货币，一种用于虚拟货币。
只有当项目中已创建对应的虚拟货币时，才能以虚拟货币指定价格。
- 若需限制可领取的商品数量：
- 在 Limits 部分打开开关并指定数量。
- 配置重置频率。从下拉列表中选择一个周期：
- Daily。
- Weekly。
- Monthly。
- Custom interval。区间从商品在商店开始显示之日开始计算。
- No regular refresh。
- 根据所选周期设置重置计划，填写相应参数。
配置商品的显示时间限制（可选）：
- 在 Add specific display period 部分打开开关。
- 指定时区以及该时间段的开始和结束时间。
如需不指定显示结束时间，请打开 No end date 开关。
- 按以下任一方式配置属性（可选）：
- 若该付费商品将用于任何随机奖励机制（如战利品箱或扭蛋），请启用Mark as paid randomized reward开关。
点击Create。
在打开的窗口中，选择商品状态，然后点击Continue。
创建的商品会显示在 All items 部分。
要配置或更新现有商品的数量限制：
- 在发布商帐户中打开项目，前往Items catalog > All items > Virtual items部分。
在您的帐户中配置和更新
要创建购买次数有限的商品：
- 在发布商帐户中打开项目，前往Items catalog > All items > Virtual items部分。
- 在帐户中打开项目，前往Items catalog > All items > Virtual items部分。
- 在帐户中打开项目，前往Items catalog > All items > Virtual items部分。
- 在帐户中打开项目，前往Items catalog > All items > Virtual items部分。
- 在移动端游戏专用帐户中打开项目，并前往Catalog部分。
- 点击Create manually，并在下拉列表中选择Virtual item。
- 在 General settings 部分，填写：
- SKU
- 商品所属的一个或多个组（可选）
- 名称
- 简短描述
- 扩展描述—要添加，请打开相应的开关（可选）
- 在 Media 部分，上传一张或多张图片或视频（可选）——可从设备上传或通过链接添加。使用艾克索拉建站器创建的网站中，所有商品卡片都会显示被标记为 Main 的文件，其余文件仅在带有媒体图库的商品卡片中可见。被标记为 Main 的文件也会在目录检索API调用的响应中返回。
- 在Price settings部分，设置价格或创建免费商品：
- 如需设置价格，选择Paid item，打开Real currency prices和/或Virtual currency prices开关，并指定价格。如有需要，配置区域价格。
- 如需创建免费商品，选择Free item。
一个商品可以设置多种真实货币和虚拟货币的价格。在这种情况下，必须为每种类型指定默认货币：一种用于真实货币，一种用于虚拟货币。
只有当项目中已创建对应的虚拟货币时，才能以虚拟货币指定价格。
- 若需限制可领取的商品数量：
- 在 Limits 部分打开开关并指定数量。
- 配置重置频率。从下拉列表中选择一个周期：
- Daily。
- Weekly。
- Monthly。
- Custom interval。区间从商品在商店开始显示之日开始计算。
- No regular refresh。
- 根据所选周期设置重置计划，填写相应参数。
配置商品的显示时间限制（可选）：
- 在 Add specific display period 部分打开开关。
- 指定时区以及该时间段的开始和结束时间。
如需不指定显示结束时间，请打开 No end date 开关。
- 按以下任一方式配置属性（可选）：
- 若该付费商品将用于任何随机奖励机制（如战利品箱或扭蛋），请启用Mark as paid randomized reward开关。
点击Create。
在打开的窗口中，选择商品状态，然后点击Continue。
创建的商品会显示在 All items 部分。
要配置或更新现有商品的限制：
- 在您的帐户中打开项目，前往Items catalog > All items > Virtual items部分。
- 在您的帐户中打开项目，前往Items catalog > All items > Virtual items部分。
- 在您的帐户中打开项目，前往Items catalog > All items > Virtual items部分。
在您的帐户中配置和更新
要创建购买次数有限的商品：
- 在发布商帐户中打开项目，前往Items catalog > All items > Virtual items部分。
- 在帐户中打开项目，前往Items catalog > All items > Virtual items部分。
- 在帐户中打开项目，前往Items catalog > All items > Virtual items部分。
- 在帐户中打开项目，前往Items catalog > All items > Virtual items部分。
- 在移动端游戏专用帐户中打开项目，并前往Catalog部分。
- 点击Create manually，并在下拉列表中选择Virtual item。
- 在 General settings 部分，填写：
- SKU
- 商品所属的一个或多个组（可选）
- 名称
- 简短描述
- 扩展描述—要添加，请打开相应的开关（可选）
- 在 Media 部分，上传一张或多张图片或视频（可选）——可从设备上传或通过链接添加。使用艾克索拉建站器创建的网站中，所有商品卡片都会显示被标记为 Main 的文件，其余文件仅在带有媒体图库的商品卡片中可见。被标记为 Main 的文件也会在目录检索API调用的响应中返回。
- 在Price settings部分，设置价格或创建免费商品：
- 如需设置价格，选择Paid item，打开Real currency prices和/或Virtual currency prices开关，并指定价格。如有需要，配置区域价格。
- 如需创建免费商品，选择Free item。
一个商品可以设置多种真实货币和虚拟货币的价格。在这种情况下，必须为每种类型指定默认货币：一种用于真实货币，一种用于虚拟货币。
只有当项目中已创建对应的虚拟货币时，才能以虚拟货币指定价格。
- 若需限制可领取的商品数量：
- 在 Limits 部分打开开关并指定数量。
- 配置重置频率。从下拉列表中选择一个周期：
- Daily。
- Weekly。
- Monthly。
- Custom interval。区间从商品在商店开始显示之日开始计算。
- No regular refresh。
- 根据所选周期设置重置计划，填写相应参数。
配置商品的显示时间限制（可选）：
- 在 Add specific display period 部分打开开关。
- 指定时区以及该时间段的开始和结束时间。
如需不指定显示结束时间，请打开 No end date 开关。
- 按以下任一方式配置属性（可选）：
- 若该付费商品将用于任何随机奖励机制（如战利品箱或扭蛋），请启用Mark as paid randomized reward开关。
点击Create。
在打开的窗口中，选择商品状态，然后点击Continue。
创建的商品会显示在 All items 部分。
要配置或更新现有商品的数量限制：
- 在移动端游戏专用帐户中打开项目，并前往Catalog > Virtual items部分。
打开包含该商品的组。
在该商品所在行，点击•••，并在下拉列表中选择Edit。
在Limits for single user部分，设置限制和/或选择限制重置频率，然后指定时间和时区。
- 点击Save changes。
通过API调用进行设置和更新
要通过API配置商品购买数量限制，请在以下方法中使用limits对象：
要设置每日、每周或每月的限制刷新，请传入limits.recurrent_schedule对象。
若已配置限制刷新周期，您还可以控制商品在达到购买数量限制后是否继续在目录中显示。为此，请传入“limits.per_user.limit_exceeded_visibility”: “show”参数。
若未配置循环刷新，则无论参数值如何，商品在达到限制后都会从目录中隐藏。
要通过API更新和管理数量限制，请使用限制方法组管理子部分中的方法。
| 功能 | API调用 |
|---|---|
| 为所有用户或指定用户刷新某个商品的限制。 | 刷新购买限制。 |
| 清除指定用户的所有商品限制。 | 刷新指定用户的所有购买限制。 |
| 修改指定用户对指定商品的购买限制。 | 设置指定用户可购买的数量。 |
| 获取指定用户对指定商品的限制配置信息。 | 获取指定用户可购买的数量。 |
| 增加指定用户可购买的数量。 | 增加指定用户可购买的数量。 |
| 减少指定用户可购买的数量。 | 减少指定用户可购买的数量。 |
在商品目录中显示限制
商品销售限制在目录中的显示方式取决于实现方式——通过建站器或通过API。
通过建站器显示
使用建站器时，限制会自动显示 — 商品卡片上会显示用户可购的商品数量计数。
通过API获取限制信息
如果目录是通过API实现的，数量限制信息会在以下与目录相关的API调用中的items.limits数组中返回：
用户已达购买数量限制的商品会返回can_be_bought = false。
您可以随时根据需要调整这些数量限制。
这些数据可用于在目录中展示限制数，例如，显示用户可购买的最大商品数。
发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。
