商店中商品的显示时限
运行机制
您可以设置商品在商店中的显示时间，以实现以下目的：
- 保持目录与某段时间的相关性，例如节假日促销期间。
- 提前创建商品但不在目录中显示。
- 通过在商品旁边显示计时器，激励用户购买。使用建站器创建目录界面时，会自动显示计时器。使用自己的界面中创建目录时，需在己侧实现计时器的显示。
- 游戏内物品的销售 — 虚拟物品、虚拟货币套餐和捆绑包
- 通过游戏密钥销售游戏和DLC
注：
对于捆绑包中的商品，其显示时间限制不予考虑。
示例
- 您创建了一个
Booster 虚拟物品并将其显示时间设置为10月29日至11月15日。 - 您创建了一个包含
Booster 的Legendary Start Pack 捆绑包。该捆绑包没有时间限制，因此始终在商店中可见。 - 一个用户在10月20日打开了您的游戏内商店。您使用以下方法：您未在上述方法中传入
show_inactive_time_limited_items参数。 - 您获得商品目录：
配置和更新限制数
在发布商帐户中配置和更新
注：
- 以下配置流程以虚拟物品为例。
- 配置虚拟物品前，建议先创建分组。分组有助于构建多级目录并管理商品在商店中的显示方式。
- 在发布商帐户中打开您的项目，前往商品目录 > 全部商品 > 虚拟物品部分。
- 单击添加并选择虚拟物品。
- 指定以下参数：
- 图片
- SKU
- 物品所属的一个或多个组
- 名称
- 描述
- 价格
注：
不能创建未指定真实货币或虚拟货币价格的物品。不能创建价格为0的物品。如有需要，可配置区域价格。
- 要限制用户可购买物品的次数，将限制单个用户可购买此物品的次数开关设为开并设定限制数。
- 要设置限制刷新频率：
- 从下拉菜单选择周期：
- 每天
- 每周
- 每月
- 自定义间隔。间隔计算从商品在商店的显示期开始日期起算。
- 不刷新
- 从下拉菜单选择周期：
- 设置与周期对应的参数来确定更新刷新安排。
- 要为商品目录中的商品设置显示期限，请选择限时，指定时区、开始日期和结束日期。若要使商品无限期可购，选择无结束日期。
- 单击创建物品。
通过API调用设置和更新
要为商店中的商品设置显示时间限制，请使用以下API调用：
将以下参数传入商品创建或商品更新API调用：periods[0].date_from，包含YYYY-MM-DDThh:mm:ss±TMZ格式的商品显示开始日期和时间，其中TMZ是hh:mmGMT格式的时区。periods[0].date_until，包含YYYY-MM-DDThh:mm:ss±TMZ格式的商品显示结束日期和时间，其中TMZ是hh:mmGMT格式的时区。如不要指定商品显示结束时间，请传入null。
可为商店中的商品设置多个显示时间段。方法是在API调用中传入一个包含所有时间段开始和结束时间的对象数组。
示例：
Copy
- json
1"periods": [
2 {
3 "date_from": "2022-06-10T14:00:00+03:00",
4 "date_until": "2022-06-30T14:00:00+03:00"
5 },
6 {
7 "date_from": "2022-07-10T14:00:00+03:00",
8 "date_until": "2022-07-30T14:00:00+03:00"
9 },
10 {
11 "date_from": "2022-08-10T14:00:00+03:00",
12 "date_until": "2022-08-30T14:00:00+03:00"
13 }
14]
目录检索API调用返回发出请求时在商店中显示的商品。要获取尚未开始或已过显示时间段的商品的信息，请在请求目录时传入值为1的show_inactive_time_limited_items参数。
在商品目录中显示限制数
商品目录中时效性商品的显示取决于实现方式⸺通过建站器通过API。
通过建站器显示
如果使用建站器，时间限制会自动显示。在商品销售时间结束前30天，计时器会自动出现在商品卡片上并显示剩余时间：
- 如果距离销售结束还有一周以上，计时器显示天数和小时数。
- 如果距离销售结束还有一天以上，计时器显示小时数和分钟数。
- 如果距离销售结束不足一天，计时器显示分钟数和秒数。
注：
为更好地吸引用户注意促销商品，推荐使用精选商品卡片样式。
通过API获取数量限制信息
如果目录是通过API实现的，商品销售时间段信息会在以下与目录相关的API调用中的items.periods数组中返回：
本文对您的有帮助吗？
感谢您的反馈！
我们会查看您的留言并运用它改进用户体验。发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。
