商品属性

属性是可提供商品额外信息的商品特征。

属性可以是商品的颜色和尺寸、商品适用的用户等级或游戏中的事件。

主要功能：

• 筛选商店中的商品
• 定义商品变体（如红色头盔、蓝色头盔）及在商品卡片上显示
• 为商品附加额外特征

商品属性及其值的示例：

运行机制

1. 创建商品属性及其值，然后将它们与商品关联：

• 通过发布商帐户或API（指定商品属性的External ID和属性值的External ID）。
• 通过发布商帐户（以JSON格式指定属性及其值）。

2. 使用虚拟物品和货币或游戏密钥方法组目录子部分的方法来请求商品目录。属性数据通过以下方式返回：

• 在属性数组中（如通过指定商品属性的External ID和属性值的External ID在发布商帐户中或使用API方法创建属性）。
• 在custom_attributes数组中（如通过JSON添加属性及其值）。此方法需在目录检索请求中包含additional_fields参数和值custom_attributes。

3. 用户进行购买。如属性和值是通过JSON添加的，则商品属性数据在订单支付成功和订单取消Webhook的custom_attributes数组中传递。

集成过程

您可以在己侧创建商品属性及其值，并在发布商帐户中用JSON格式将它们添加到商品。

您也可以在艾克索拉侧创建属性及其值，然后将它们添加到商品。具体方法是：

1. 创建属性及其值。
2. 设置属性和商品之间的关联。

创建并设置商品属性及其值

每个商品属性包含以下参数：

• External ID — 在请求正文的external_id参数中传递的唯一属性ID。请提供您系统上的属性ID或新建一个。
• 名称（为项目中配置的每个语言都指定一个）。

• 值列表。

• 父商品属性的External ID。
• 值的External ID — 在路径参数的external_id参数中传递的值的唯一ID。请指定您系统中的值ID或新建一个。

• 名称（为项目中配置的每个语言都指定一个）。

• 在发布商帐户中
• 通过API方法

在发布商帐户中创建属性及其值

1. 在发布商帐户中打开您项目。
2. 前往商店 > 目录管理。

3. 在商品属性部分单击配置。
4. 单击创建商品属性。
5. 指定External ID和商品属性名称。
6. 单击保存并继续。
7. 为创建的商品属性指定所有必需值。对于每个值，指定其External ID。如要添加更多值，请单击+。
8. 单击保存并继续。

通过API方法创建属性及其值

要创建和管理商品属性及其值，请使用商品属性方法组管理子部分中的方法。

创建及管理属性的方法：

• 创建属性
• 更新属性
• 获取指定属性
• 删除属性

• 获取属性列表以用于管理

• 创建属性值
• 删除属性的所有值
• 更新属性值
• 删除属性值

向商品添加属性

向商品添加创建的属性和值：

• 通过发布商帐户
• API方法

通过发布商帐户添加现有属性

1. 在发布商帐户中打开您的项目。
2. 在侧边栏中单击商店。
3. 打开所需商品类型所在的版块：
   • 虚拟物品
   • 虚拟货币
   • 游戏密钥
   • 捆绑包
4. 创建新商品或编辑现有商品。
5. 在商品属性部分，将选择现有属性或新建属性开关切换为开。
6. 在显示的商品属性字段中，选择所需商品属性对应的ID。
7. 在值字段中，选择商品属性值对应的ID。

通过API方法添加现有属性

在创建虚拟物品或更新虚拟物品方法中，传入一个对象数组，包含商品属性的External ID和需关联的值的External ID。

包含属性及其值的数组示例：

  "attributes": [
    {
      "external_id": "craft-materials",
      "name": {
        "en": "Craft materials"
      },
      "values": [
        {
          "external_id": "steel",
          "value": {
            "en-US": "5"
          }
        },
        {
          "external_id": "leather",
          "value": {
            "en-US": "1"
          }
        }
      ]
    }
  ],

通过发布商帐户从JSON添加属性

可通过JSON格式在创建或编辑任何类型的商品时添加属性及其值，例如：

• 虚拟货币套餐
• 虚拟物品，例如时效性商品
• 游戏密钥
• 捆绑包

具体方法：

1. 在发布商帐户中打开您的项目。
2. 在侧边栏中单击商店。
3. 打开所需商品类型所在的版块：
   • 虚拟物品
   • 虚拟货币
   • 游戏密钥
   • 捆绑包
4. 创建新商品或编辑现有商品。
5. 在商品属性部分，将使用JSON添加属性开关切换为开。

6. 在显示的文本区域中用JSON格式添加属性及其值的列表。