淘宝开放平台开发文档 / 类目属性度量衡

类目属性度量衡

 为了规范标准单位参数,如重量、容积、长度等属性,淘宝启动了度量衡项目。

后续taobao.itemcats.get 和 taobao.itemprops.get  会增加字段,来获取度量衡信息。

1、 类目接口:taobao.itemcats.get,增加一个字段:

1.1  taosir_cat:是否度量衡类目, true:是;false:否。

案例:

{
    "itemcats_get_response": {
        "item_cats": {
            "item_cat": [
                {
                    "cid": 134852557,
                    "is_parent": false,
                    "name": "度量衡测试类目1",
                    "parent_cid": 134846593,
                    "taosir_cat": false
                },
                {
                    "cid": 134846594,
                    "is_parent": false,
                    "name": "度量衡测试子类目2",
                    "parent_cid": 134846593,
                    "taosir_cat": true
                }
            ]
        }
    }
}


 

2、 类目属性接口:taobao.itemprops.get,增加两个字段。

2.1  is_taosir是否度量衡属性,true 是;false 否。

2.2  taosir_do:度量衡信息;

2.2.1      precision:数值小数点精度。

2.2.2      type:时间类型:0表示非时间,1表示时间点,2表示时间范围。

2.2.3      std_unit_list:单位列表,attr_key为单位ID,attr_value为单位名称。

2.2.4      expr_el_list:表达式元素列表,若不是表达式度量衡,则没有该字段;

2.2.4.1   type:元素类型

2.2.4.2   text:显示文本

2.2.4.3   isShowLabel:是否只用于显示的label元素

2.2.4.4   isLabel:即用于显示又用于组装value_data的label元素

2.2.4.5   isInput:是否普通输入框

2.2.4.6   案例说明:表达式为,卖家分别输入4、5、6之后,需组装成 4X5X6,再加上卖家选择的单位(比如:cm),组装成4X5X6cm进行商品发布。那么“长”这个元素的类型就是isShowLabel;输入框的类型就是isInput;“X”的类型就是isLabel。

案例:

{
    "itemprops_get_response": {
        "item_props": {
            "item_prop": [
                {
                    "is_taosir": true,
                    "is_enum_prop": false,
                    "must": false,
                    "name": "净含量",
                    "pid": 145998403,
                    "taosir_do": {
                        "precision": 2,
                        "std_unit_list": {
                            "std_unit": [
                                {
                                    "attr_key": "34",
                                    "attr_value": "g"
                                },
                                {
                                    "attr_key": "35",
                                    "attr_value": "mg"
                                }
                            ]
                        },
                        "type": 0
                    }
                },
                {
                    "is_taosir": true,
                    "is_enum_prop": false,
                    "must": false,
                    "name": "尺寸",
                    "pid": 145994486,
                    "taosir_do": {
                        "expr_el_list": {
                           "expr_el": [
                                {
                                    "is_input": false,
                                    "is_label": false,
                                    "is_show_label": true,
                                    "text": "长",
                                    "type": 0
                                },
                                {
                                    "is_input": true,
                                    "is_label": false,
                                    "is_show_label": false,
                                    "type": 2
                                },
                                {
                                    "is_input": false,
                                    "is_label": true,
                                    "is_show_label": false,
                                    "text": "X",
                                    "type": 1
                                },
                                {
                                    "is_input": false,
                                    "is_label": false,
                                    "is_show_label": true,
                                    "text": "高",
                                    "type": 0
                                },
                                {
                                    "is_input": true,
                                    "is_label": false,
                                    "is_show_label": false,
                                    "type": 2
                                },
                                {
                                    "is_input": false,
                                    "is_label": true,
                                    "is_show_label": false,
                                    "text": "X",
                                    "type": 1
                                },
                                {
                                    "is_input": false,
                                    "is_label": false,
                                    "is_show_label": true,
                                    "text": "宽",
                                    "type": 0
                                },
                                {
                                    "is_input": true,
                                    "is_label": false,
                                    "is_show_label": false,
                                    "type": 2
                                }
                            ]
                        },
                        "precision": 2,
                        "std_unit_list": {
                            "std_unit": [
                                {
                                    "attr_key": "1",
                                    "attr_value": "m"
                                }
                            ]
                        },
                        "type": 0
                    }
                },
                {
                    "is_taosir": true,
                    "is_enum_prop": false,
                    "must": false,
                    "name": "有效期",
                    "pid": 146000464,
                    "taosir_do": {
                        "expr_el_list": {
                            "expr_el": [
                                {
                                    "is_input": true,
                                    "is_label": false,
                                    "is_show_label": false,
                                    "type": 2
                                },
                                {
                                    "is_input": false,
                                    "is_label": true,
                                    "is_show_label": false,
                                    "text": "至",
                                    "type": 1
                                },
                                {
                                    "is_input": true,
                                    "is_label": false,
                                    "is_show_label": false,
                                    "type": 2
                                }
                            ]
                        },
                        "precision": 0,
                        "std_unit_list": {
                            "std_unit": [
                                {
                                    "attr_key": "10001",
                                    "attr_value": "年"
                                }
                            ]
                        },
                        "type": 2
                    }
                },
                {
                    "is_taosir": true,
                    "is_enum_prop": true,
                    "must": false,
                    "name": "规格",
                    "pid": 145998404,
                    "prop_values": {
                        "prop_value": [
                            {
                                "name": "2X500克",
                                "vid": 144646466
                            },
                            {
                                "name": "3X1.5千克",
                                "vid": 144648454
                            }
                        ]
                    },
                    "taosir_do": {
                        "expr_el_list": {
                            "expr_el": [
                                {
                                    "is_input": false,
                                    "is_label": false,
                                    "is_show_label": true,
                                    "text": "盒",
                                    "type": 0
                                },
                                {
                                    "is_input": true,
                                    "is_label": false,
                                    "is_show_label": false,
                                    "type": 2
                                },
                                {
                                    "is_input": false,
                                    "is_label": true,
                                    "is_show_label": false,
                                    "text": "X",
                                    "type": 1
                                },
                                {
                                    "is_input": false,
                                    "is_label": false,
                                    "is_show_label": true,
                                    "text": "克",
                                    "type": 0
                                }
                            ]
                        },
                        "precision": 2,
                        "std_unit_list": {
                            "std_unit": [
                                {
                                    "attr_key": "35",
                                    "attr_value": "毫克"
                                }
                            ]
                        },
                        "type": 0
                    }
                },
                {
                    "is_taosir": false,
                    "is_enum_prop": true,
                    "must": false,
                    "name": "品牌",
                    "pid": 22370001,
                    "prop_values": {
                        "prop_value": [
                            {
                                "name": "安耐晒",
                                "vid": 3327418
                            },
                            {
                                "name": "欧碧泉",
                                "vid": 142280368
                            },
                            {
                                "name": "美宝莲",
                                "vid": 3316230
                            }
                        ]
                    },
                    "taosir_do": {}
                }
            ]
        }
    }
}


3、 案例说明,枚举类型的度量衡属性项与普通属性项一样,没有任何特殊逻辑。主要针对非枚举类型的属性项(is_enum_prop==false或is_input_prop==true),卖家输入的文本做格式校验。

3.1 普通度量衡属性项,即一个输入框,一个单位选择下拉框

        3.1.1 taobao.itemcats.get接口返回结果中taosir_cat字段值为true;

        3.1.2 taobao.itemprops.get接口返回结果如下:

        TB11w_9GFXXXXciaXXXwu0bFXXX.png

        3.1.3 页面交互效果如图:TB1.gxCHXXXXXXxXFXXwu0bFXXX.png,卖家输入数值200,选择单位g后,则组装成200g作为卖家输入的文本传给商品发布接口,即入参。

3.2 表达式度量衡,即多个输入框,一个单位选择下拉框

3.2.1 taobao.itemcats.get接口返回结果中taosir_cat字段值为true;

         3.2.2 taobao.itemprops.get接口返回结果如下:

TB171NGHXXXXXcNXXXXwu0bFXXX.png

3.2.3 页面交互效果如图:TB1Y24uHXXXXXb2aXXXwu0bFXXX.png,卖家分别输入数值3、4、5,选择单位m,则组装成3X4X5m作为卖家输入的文本传给商品发布接口,即入参。

  3.3 时间点度量衡,分为6种,分别为:年、年月、年月日、年月日时、年月日时分、年月日时分秒。

      3.3.1 taobao.itemcats.get接口返回结果中taosir_cat字段值为true;

      3.3.2 taobao.itemprops.get接口返回结果如下:

TB1t7dFHXXXXXXVXpXXwu0bFXXX.png

      3.3.3 页面交互效果如图:,卖家分别输入数值20141219300,则组装成2014-12-01 9:30:00作为卖家输入的文本传给商品发布接口,即入参。

 3.4 时间区间度量衡,分为6种,分别为:年、年月、年月日、年月日时、年月日时分、年月日时分秒。

     3.4.1 taobao.itemcats.get接口返回结果中taosir_cat字段值为true;

     3.4.2 taobao.itemprops.get接口返回结果如下:

TB1cNFHHXXXXXa7XXXXwu0bFXXX.png

     3.4.3页面交互效果如图:,卖家分别输入数值2014、12、2015、2,则组装成2014-12至2015-02作为卖家输入的文本传给商品发布接口,即入参。

 

FAQ

  • 关于此文档暂时还没有FAQ