建立商品

更新时间：2022/01/07 访问次数：455

本文章將會介紹如何在天貓香港建立商品。

獲取商家可經營的品牌

使用 GetSellerBrand 獲取商家可經營的品牌列表。

其中，data中包含商家可用品牌资料

名稱	類型	示例值	描述
name	String	PX	商家可經營的品牌（以中文提供）
value_id	String	6056830	商家可經營的品牌 ID

返回數據範例

{
   "error_msg":"null",
   "code":"0",
   "data":[
      {
         "name":"PX",
         "value_id":"6056830"
      },
      {
         "name":"PX2",
         "value_id":"6056830"
      }
   ],
   "success":"true",
   "error_detail":"null",
   "error_code":"null",
   "request_id":"0ba2887315178178017221014",
   "errors":"null"
}

獲取商家可經營的品類

使用 GetSellerCategory 獲取商家可經營品類。

data中的數據為可經營品類的樹狀結構。

children 代表當前節點下屬的子節點；
leaf=true 代表該類目為「葉子類目」，即末端節點。所有商品的類目需要為該類型節點。

名稱	類型	示例值	描述
category_id	Number		商品分類 ID
leaf	Boolean	true	是否「葉子節點」若為false，則該節點的 children 有內容
name	名稱		商品分類名稱（以中文提供）
sort_order			排序編號
children	Object[]	[…]	下級分類

data返回數據範例

[{
    "category_id": 50001848,
    "children": [
        {
            "category_id": 50004155,
            "leaf": true,
            "name": "護帶",
            "sort_order": 9999
        },
        {
            "category_id": 50004152,
            "leaf": true,
            "name": "其他",
            "sort_order": 9999
        },
        {
            "category_id": 62016408,
            "children": [
                {
                    "category_id": 50001886,
                    "leaf": true,
                    "name": "男帽",
                    "sort_order": 9999
                },
                {
                    "category_id": 50001851,
                    "leaf": true,
                    "name": "女帽",
                    "sort_order": 9999
                }
            ],
            "leaf": false,
            "name": "帽子",
            "sort_order": 9999
        },
        {
            "category_id": 62017403,
            "children": [
                {
                    "category_id": 50001885,
                    "leaf": true,
                    "name": "男士皮帶",
                    "sort_order": 9999
                },
                {
                    "category_id": 50001849,
                    "leaf": true,
                    "name": "女士皮帶",
                    "sort_order": 9999
                }
            ],
            "leaf": false,
            "name": "皮帶",
            "sort_order": 9999
        },
        {
            "category_id": 62017404,
            "children": [
                {
                    "category_id": 50004160,
                    "leaf": true,
                    "name": "女士手套",
                    "sort_order": 9999
                },
                {
                    "category_id": 50004154,
                    "leaf": true,
                    "name": "男士手套",
                    "sort_order": 9999
                }
            ],
            "leaf": false,
            "name": "手套",
            "sort_order": 9999
        },
        {
            "category_id": 62016804,
            "children": [
                {
                    "category_id": 61000030,
                    "leaf": true,
                    "name": "絲巾",
                    "sort_order": 999
                },
                {
                    "category_id": 61000029,
                    "leaf": true,
                    "name": "披肩",
                    "sort_order": 999
                },
                {
                    "category_id": 50001877,
                    "leaf": true,
                    "name": "男士圍巾",
                    "sort_order": 9999
                },
                {
                    "category_id": 50003898,
                    "leaf": true,
                    "name": "女士圍巾",
                    "sort_order": 9999
                }
            ],
            "leaf": false,
            "name": "圍巾&披肩",
            "sort_order": 9999
        },
        {
            "category_id": 50001874,
            "children": [
                {
                    "category_id": 50001875,
                    "leaf": true,
                    "name": "領帶",
                    "sort_order": 9999
                },
                {
                    "category_id": 50001876,
                    "leaf": true,
                    "name": "領結",
                    "sort_order": 9999
                }
            ],
            "leaf": false,
            "name": "領帶和領結",
            "sort_order": 9999
        },
        {
            "category_id": 50001852,
            "leaf": true,
            "name": "髮飾",
            "sort_order": 9999
        }
    ],
    "leaf": false,
    "name": "服飾配件",
    "sort_order": 9999
}]

獲取類目的屬性資料

根據上述獲取的類目列表，使用 GetSellerCategoryAttribute 獲取類目的屬性資料。

唯上述 leaf=true 的類目可獲取屬性資料。

名稱	類型	示例值	描述
property_text	String	SellerSKU	屬性標題（繁體中文）
property_text_eng	String	賣家 SKU	屬性標題（英文）
input_type	Int	1	屬性類型 1：文本 2：富文本 3：單項選擇 4：多項選擇 5：日曆 6：數值 7：單項選擇，可自定義值 8：多項選擇，可自定義值 9：圖片
is_mandatory	Int	1	是否必須 1：必須 0：非必須
is_spu_prop	Int	0	是否為SPU屬性。屬性為 1 即 SPU 級需要的信息（如：服裝款式）；為 0 即 SKU 級需要的信息（如：品牌）
is_sku_prop	Int	1	是否為SKU屬性。值為1即為SKU屬性，與is_spu_prop取值相反。
options	Object[]		可供使用值
- value_id	Int		可供使用值的id
- value_text	String		可供使用的值的含義（以中文提供）

返回數據範例

[{
  "input_type": 3,
  "is_mandatory": 1,
  "is_sku_prop": 0,
  "is_spu_prop": 1,
  "options": [{
    "sort_order": 9999,
    "value_id": 6056830,
    "value_text": "PIX"
  }, {
    "sort_order": 9999,
    "value_id": 52914073,
    "value_text": "Momax"
  }, {
    "sort_order": 9999,
    "value_id": 6737184,
    "value_text": "Manfrotto"
  }, {
    "sort_order": 9999,
    "value_id": 145527588,
    "value_text": "Maono"
  }, {
    "sort_order": 9999,
    "value_id": 608352810,
    "value_text": "THRONMAX"
  }, {
    "sort_order": 9999,
    "value_id": 9277865,
    "value_text": "TP-Link"
  }, {
    "sort_order": 9999,
    "value_id": 919658178,
    "value_text": "Ticwatch"
  }],
  "property_id": 20000,
  "property_text": "品牌",
  "property_text_eng": "Brand",
  "sort_order": 0
}, {
  "input_type": 8,
  "is_mandatory": 0,
  "is_sku_prop": 0,
  "is_spu_prop": 1,
  "property_id": 241657911,
  "property_text": "Shaving method",
  "property_text_eng": "Shaving method",
  "sort_order": 0
}, {
  "input_type": 3,
  "is_mandatory": 1,
  "is_sku_prop": 0,
  "is_spu_prop": 1,
  "options": [{
    "sort_order": 0,
    "value_id": 1753690793,
    "value_text": "否"
  }, {
    "sort_order": 0,
    "value_id": 2000004975,
    "value_text": "是"
  }],
  "property_id": 246520201,
  "property_text": "是否平行進口",
  "property_text_eng": "Parallel_import_or_not",
  "sort_order": 0
}, {
  "input_type": 8,
  "is_mandatory": 0,
  "is_sku_prop": 0,
  "is_spu_prop": 1,
  "options": [{
    "sort_order": 0,
    "value_id": 3246358,
    "value_text": "組合"
  }, {
    "sort_order": 0,
    "value_id": 3330299,
    "value_text": "暗沉"
  }, {
    "sort_order": 0,
    "value_id": 4200893,
    "value_text": "幹性"
  }, {
    "sort_order": 0,
    "value_id": 6972984,
    "value_text": "敏感"
  }, {
    "sort_order": 0,
    "value_id": 8468843,
    "value_text": "混合性"
  }, {
    "sort_order": 0,
    "value_id": 11703863740,
    "value_text": "中性及乾性膚質"
  }, {
    "sort_order": 0,
    "value_id": 11704951712,
    "value_text": "所有膚質敏感肌除外"
  }],
  "property_id": 226650569,
  "property_text": "肌膚類型",
  "property_text_eng": "skin type",
  "sort_order": 0
}, {
  "input_type": 8,
  "is_mandatory": 1,
  "is_sku_prop": 1,
  "is_spu_prop": 0,
  "options": [{
    "sort_order": 999,
    "value_id": 46231,
    "value_text": "25g"
  }, {
    "sort_order": 999,
    "value_id": 7161572,
    "value_text": "30毫升"
  }, {
    "sort_order": 999,
    "value_id": 75366304,
    "value_text": "50ml"
  }, {
    "sort_order": 999,
    "value_id": 75367020,
    "value_text": "30g"
  }],
  "property_id": 1654,
  "property_text": "淨含量",
  "property_text_eng": "Net Weight",
  "sort_order": 999
}, {
  "input_type": 8,
  "is_mandatory": 0,
  "is_sku_prop": 0,
  "is_spu_prop": 1,
  "options": [{
    "sort_order": 9999,
    "value_id": 66914,
    "value_text": "橄欖色"
  }, {
    "sort_order": 9999,
    "value_id": 3302075,
    "value_text": "藍莓"
  }, {
    "sort_order": 9999,
    "value_id": 3327837,
    "value_text": "黑色"
  }, {
    "sort_order": 9999,
    "value_id": 3331185,
    "value_text": "白色"
  }, {
    "sort_order": 9999,
    "value_id": 5511528364,
    "value_text": "深青色"
  }],
  "property_id": 226649326,
  "property_text": "色系",
  "property_text_eng": "Color Family",
  "sort_order": 9999
}]

上載或搬遷所需的圖片

在產品資料中使用圖片，需要將圖片上載到媒體中心。

可以參照 UploadImage 和 MigrateImage 預先處理圖片。處理完畢後，獲得圖片的訪問地址，該地址可以在建立商品時使用。

請在上載之前確保商家擁有對於該圖片的合法权益。

建立商品

開發者可透過 CreateProduct 建立新的商品。

其中body需按照以下範例代碼包含以下的產品資料。

Name	Type	Required	Demo Value	Rule	Description
primary_category	Int	True	50000003		商品品類 ID
spu	Object				SPU 級資料
- market_images	Object[]	False	["https://filebroker-cdn.taobao.global/kf/Hd7899fbb7e294d4d8bb0a37ce8c0c93f7.jpg"]	Max List Size: 1	營銷圖，一般為1:1的白底圖。
- images	Object[]	True	["https://filebroker-cdn.taobao.global/kf/Hd7899fbb7e294d4d8bb0a37ce8c0c93f7.jpg"]	Max List Size: 8	商品圖片，已上載到媒體素材中心的 URL
- name	String	True	單核心中央處理器		商品名稱
- description	String	True	產品介紹		商品詳細描述，支援 HTML
- property	Object[]				SPU 屬性，is_spu_prop 為 1 的屬性在此定義
- - property_id	Int	True	210204035		屬性 ID
- - property_text	String	False	核心數		屬性名稱（僅作參考）
- - values	Object[]
- - - value_id	Int	True	395288377		屬性值 ID
- - - value_text	String	False	單核心		屬性值名稱（僅作參考）
skus					SKU 級資料
- images	Object[]	True	["https://filebroker-cdn.taobao.global/kf/Hd7899fbb7e294d4d8bb0a37ce8c0c93f7.jpg"]	Max List Size: 1	SKU 圖片，已上載到媒體素材中心的 URL 當分類屬性中包含「colour family」時，該圖片生效
- logistics_height	float	False	10.00	float(2)	包装尺寸：長度（所有 SKU 保持一致），單位：cm
- logistics_length	float	False	8.50	float(2)	包装尺寸：長度（所有 SKU 保持一致），單位：cm
- logistics_weight	float	False	3.20	float(2)	包装尺寸：重量（所有 SKU 保持一致），單位：kg
- logistics_width	float	False	10.00	float(2)	包装尺寸：闊度（所有 SKU 保持一致），單位：cm
- price	float	True	880.00	float(2)	SKU 價格
- quantity	Int	True	108		SKU 庫存
- seller_sku	String	False	HK9523846_c		賣家 SKU ID
- property	Object[]				SKU 屬性，is_sku_prop 為 1 的屬性在此定義
- - property_id	Int	True	226649326		屬性 ID
- - property_text	String	False	顏色		屬性名稱（僅作參考）
- - values	Object[]
- - - value_id	Int	True	3851110		屬性值 ID
- - - value_text	String	False	Purple		屬性值名稱（僅作參考）

請注意：當系統未能處理指示，請參照錯誤提示修改後重新請求。

請求數據範例

{
   "primary_category":50000003,
   "product_id":0,
   "skus":[
      {
         "images":[
            "https://filebroker-cdn.taobao.global/kf/Hd7899fbb7e294d4d8bb0a37ce8c0c93f7.jpg"
         ],
         "logistics_height":"4",
         "logistics_length":"5",
         "logistics_weight":"6",
         "logistics_width":"7",
         "property":[
            {
               "property_id":226649528,
               "property_text":"儲存容量",
               "values":[
                  {
                     "value_id":-1,
                     "value_text":"6000GB"
                  }
               ]
            },
            {
               "property_id":226649326,
               "property_text":"顏色",
               "values":[
                  {
                     "value_id":3851110,
                     "value_text":"Purple"
                  }
               ]
            }
         ],
         "quantity":33,
         "price":15.5,
         "seller_sku":"seller_custom_sku_id"
      }
   ],
   "spu":{
      "images":[
         "https://filebroker-cdn.taobao.global/kf/Hd7899fbb7e294d4d8bb0a37ce8c0c93f7.jpg"
      ],
      "market_images":[
         "https://filebroker-cdn.taobao.global/kf/Hd7899fbb7e294d4d8bb0a37ce8c0c93f7.jpg"
      ],
      "name":"香港api测试商品",
      "property":[
         {
            "property_id":20000,
            "property_text":"品牌",
            "values":[
               {
                  "value_id":3457127,
                  "value_text":"KOL"
               }
            ]
         },
         {
            "property_id":210204035,
            "property_text":"核心數",
            "values":[
               {
                  "value_id":350226,
                  "value_text":"單核心"
               },
               {
                  "value_id":395288377,
                  "value_text":"多核心"
               },
               {
                  "value_id":-1, //商品屬性值為-1時為商家自定義屬性值
                  "value_text":"8核心"
               }
            ]
         },
         {
            "property_id":246520201,
            "property_text":"是否平行進口",
            "values":[
               {
                  "value_id":1753690793,
                  "value_text":"否"
               }
            ]
         }
      ],
      "description":"<b>商品詳情</b>"
   }
}

FAQ

关于此文档暂时还没有FAQ

有用(0) 我要提问

淘宝开放平台

Taobao Global Open Platform

建立商品

獲取商家可經營的品牌

獲取商家可經營的品類

獲取類目的屬性資料

上載或搬遷所需的圖片

建立商品

FAQ