類目屬性度量衡
為了規(guī)范標(biāo)準(zhǔn)單位參數(shù)，如重量、容積、長(zhǎng)度等屬性，淘寶啟動(dòng)了度量衡項(xiàng)目。
后續(xù)taobao.itemcats.get 和 taobao.itemprops.get 會(huì)增加字段，來獲取度量衡信息。
1、 類目接口：taobao.itemcats.get，增加一個(gè)字段：
1.1 taosir_cat：是否度量衡類目， true：是；false：否。
案例：
{
"itemcats_get_response": {
"item_cats": {
"item_cat": [
{
"cid": 134852557,
"is_parent": false,
"name": "度量衡測(cè)試類目1",
"parent_cid": 134846593,
"taosir_cat": false
},
{
"cid": 134846594,
"is_parent": false,
"name": "度量衡測(cè)試子類目2",
"parent_cid": 134846593,
"taosir_cat": true
}
]
}
}
}
2、 類目屬性接口：taobao.itemprops.get，增加兩個(gè)字段。
2.1 is_taosir：是否度量衡屬性，true 是；false 否。
2.2 taosir_do：度量衡信息；
2.2.1 precision：數(shù)值小數(shù)點(diǎn)精度。
2.2.2 type：時(shí)間類型：0表示非時(shí)間，1表示時(shí)間點(diǎn)，2表示時(shí)間范圍。
2.2.3 std_unit_list：?jiǎn)挝涣斜恚琣ttr_key為單位ID，attr_value為單位名稱。
2.2.4 expr_el_list：表達(dá)式元素列表，若不是表達(dá)式度量衡，則沒有該字段；
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 案例說明：表達(dá)式為
，賣家分別輸入4、5、6之后，需組裝成 4X5X6，再加上賣家選擇的單位（比如：cm），組裝成4X5X6cm進(jìn)行商品發(fā)布。那么“長(zhǎng)”這個(gè)元素的類型就是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": "長(zhǎng)",
"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": "規(guī)格",
"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、 案例說明，枚舉類型的度量衡屬性項(xiàng)與普通屬性項(xiàng)一樣，沒有任何特殊邏輯。主要針對(duì)非枚舉類型的屬性項(xiàng)（is_enum_prop==false或is_input_prop==true），賣家輸入的文本做格式校驗(yàn)。
3.1 普通度量衡屬性項(xiàng)，即一個(gè)輸入框，一個(gè)單位選擇下拉框
3.1.1 taobao.itemcats.get接口返回結(jié)果中taosir_cat字段值為true；
3.1.2 taobao.itemprops.get接口返回結(jié)果如下：
3.1.3 頁面交互效果如圖：
，賣家輸入數(shù)值200，選擇單位g后，則組裝成200g作為賣家輸入的文本傳給商品發(fā)布接口，即入?yún)ⅰ?/span>
3.2 表達(dá)式度量衡，即多個(gè)輸入框，一個(gè)單位選擇下拉框
3.2.1 taobao.itemcats.get接口返回結(jié)果中taosir_cat字段值為true；
3.2.2 taobao.itemprops.get接口返回結(jié)果如下：
3.2.3 頁面交互效果如圖：
，賣家分別輸入數(shù)值3、4、5，選擇單位m，則組裝成3X4X5m作為賣家輸入的文本傳給商品發(fā)布接口，即入?yún)ⅰ?/span>
3.3 時(shí)間點(diǎn)度量衡，分為6種，分別為：年、年月、年月日、年月日時(shí)、年月日時(shí)分、年月日時(shí)分秒。
3.3.1 taobao.itemcats.get接口返回結(jié)果中taosir_cat字段值為true；
3.3.2 taobao.itemprops.get接口返回結(jié)果如下：
3.3.3 頁面交互效果如圖：
，賣家分別輸入數(shù)值2014、12、1、9、30、0，則組裝成2014-12-01 9:30:00作為賣家輸入的文本傳給商品發(fā)布接口，即入?yún)ⅰ?/span>
3.4 時(shí)間區(qū)間度量衡，分為6種，分別為：年、年月、年月日、年月日時(shí)、年月日時(shí)分、年月日時(shí)分秒。
3.4.1 taobao.itemcats.get接口返回結(jié)果中taosir_cat字段值為true；
3.4.2 taobao.itemprops.get接口返回結(jié)果如下：
3.4.3頁面交互效果如圖：
，賣家分別輸入數(shù)值2014、12、2015、2，則組裝成2014-12至2015-02作為賣家輸入的文本傳給商品發(fā)布接口，即入?yún)ⅰ?/span>
FAQ
- 關(guān)于此文檔暫時(shí)還沒有FAQ