商品属性
属性是可提供商品额外信息的商品特征。
属性可以是商品的颜色和尺寸、商品适用的用户等级或游戏中的事件。
主要功能：
- 筛选商店中的商品
- 定义商品变体（如红色头盔、蓝色头盔）及在商品卡片上显示
- 为商品附加额外特征
商品属性及其值的示例：
| 商品类型 | 商品属性名称 | 商品属性值 |
|---|---|---|
| 游戏密钥 | 游戏类型 | 新上架、抢先版、即将推出、特别版 |
| 游戏密钥 | 类型 | 动作、冒险、休闲、模拟、战略、RPG |
| 虚拟物品 | 质量 | 诗史、传奇、普通 |
| 虚拟物品 | 类 | 武士、游侠、猎人、巫师、祭司 |
| 虚拟货币 | 事件 | 新年 |
| 虚拟货币 | 查询 | 完成查询1、完成查询2 |
运行机制
- 创建商品属性及其值，然后将它们与商品关联：
- 在属性数组中（如通过指定商品属性的
External ID 和属性值的External ID 在发布商帐户中或使用API方法创建属性）。 - 在custom_attributes数组中（如通过JSON添加属性及其值）。此方法需在目录检索请求中包含additional_fields参数和值
custom_attributes。
- 用户进行购买。如属性和值是通过JSON添加的，则商品属性数据在订单支付成功和订单取消Webhook的custom_attributes数组中传递。
集成过程
您可以在己侧创建商品属性及其值，并在发布商帐户中用JSON格式将它们添加到商品。
您也可以在艾克索拉侧创建属性及其值，然后将它们添加到商品。具体方法是：
注：
创建并设置商品属性及其值
每个商品属性包含以下参数：
External ID — 在请求正文的external_id参数中传递的唯一属性ID。请提供您系统上的属性ID或新建一个。- 名称（为项目中配置的每个语言都指定一个）。
值列表。
- 父商品属性的
External ID 。 - 值的
External ID — 在路径参数的external_id参数中传递的值的唯一ID。请指定您系统中的值ID或新建一个。 名称（为项目中配置的每个语言都指定一个）。
在发布商帐户中创建属性及其值
- 在发布商帐户中打开您项目。
- 前往商店 > 目录管理。
- 在商品属性部分单击配置。
- 单击创建商品属性。
- 指定
External ID 和商品属性名称。 - 单击保存并继续。
- 为创建的商品属性指定所有必需值。对于每个值，指定其
External ID 。如要添加更多值，请单击+。 - 单击保存并继续。
注：
项目中包含的商品属性数量无限制。
但是，每个属性有20个值的限制。
通过API方法创建属性及其值
要创建和管理商品属性及其值，请使用商品属性方法组管理子部分中的方法。
创建及管理属性的方法：
创建及管理属性值的方法：注意
如删除商品属性，其值及与商品的关联也将一并丢失。
如果删除值，则它与商品的关联也将丢失。
删除的商品属性、值或关联的数据无法恢复。
向商品添加属性
向商品添加创建的属性和值：
通过发布商帐户添加现有属性
要向商品添加属性：- 在发布商帐户中打开您的项目。
- 在侧边栏中单击商店。
- 打开所需商品类型所在的版块：
- 虚拟物品
- 虚拟货币
- 游戏密钥
- 捆绑包
- 创建新商品或编辑现有商品。
- 在商品属性部分，将选择现有属性或新建属性开关切换为开。
- 在显示的商品属性字段中，选择所需商品属性对应的ID。
- 在值字段中，选择商品属性值对应的ID。
注：
为一个商品设置的属性不能超过20个。
一个商品同一个属性的值不能超过6个。
通过API方法添加现有属性
在创建虚拟物品或更新虚拟物品方法中，传入一个对象数组，包含商品属性的
包含属性及其值的数组示例：
Copy
- http
"attributes": [
{
"external_id": "craft-materials",
"name": {
"en": "Craft materials"
},
"values": [
{
"external_id": "steel",
"value": {
"en-US": "5"
}
},
{
"external_id": "leather",
"value": {
"en-US": "1"
}
}
]
}
],
注：
为一个商品设置的属性不能超过20个。
一个商品同一个属性的值不能超过6个。
通过发布商帐户从JSON添加属性
可通过JSON格式在创建或编辑任何类型的商品时添加属性及其值，例如：
具体方法：
- 在发布商帐户中打开您的项目。
- 在侧边栏中单击商店。
- 打开所需商品类型所在的版块：
- 虚拟物品
- 虚拟货币
- 游戏密钥
- 捆绑包
- 创建新商品或编辑现有商品。
- 在商品属性部分，将使用JSON添加属性开关切换为开。
- 在显示的文本区域中用JSON格式添加属性及其值的列表。
注：
用JSON格式添加属性时，属性及其值的数量没有限制。
JSON的最大长度有限制，为500个字符。
本文对您的有帮助吗？
感谢您的反馈！
我们会查看您的留言并运用它改进用户体验。为此页面评分
为此页面评分
不想回答
感谢您的反馈！
发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。
