一、文檔說明

本文檔說明臺灣淘寶商品管理的第三方開發者或者自研發商家如何透過開放平台進行商品發布管理。

二、背景

ISV可根據此教程使用相關API製作發布商品的工具

三、流程圖

在調用CreateProduct前，需要先調用GetCategoryTree取得所有類目的清單、GetCategoryAttributes取得產品類目的產品内容清單、GetBrands取得產品的品牌名稱、UploadImage從本地上傳圖片至服務器

四、示例說明

詳情請參考接口文檔：https://open.taobao.tw/doc/doc.htm#?nodeId=27984&docId=118967

1、取得所有類目的清單

調用GetCategoryTree接口，得到category_id；
請求參數說明：無
響應參數說明：所有可用的類目
請求參數示例
除公共請求參數外，沒有其他請求參數


溫馨提示：本示例中，“leaf=true”表示類目是一個葉子類目，可用於新建商品，相反的若leaf=false,則表示您的商品不能建立在此類目下。

{
  "result": {
    "data": [
      {
        "children": [
          {
            "children": [
              {
                "var": false,
                "name": "擴大機 (新)",
                "leaf": true,
                "category_id": 40100875
              },
              {
                "var": false,
                "name": "更換用耳塞 (新)",
                "leaf": true,
                "category_id": 40100874
              },
              {
                "var": false,
                "name": "其他耳罩式耳機配件",
                "leaf": true,
                "category_id": 41000190
              }
            ],
            "var": false,
            "name": "耳罩式耳機配件",
            "leaf": false,
            "category_id": 40100388
          },
          {
            "children": [
              {
                "var": false,
                "name": "纜線 (新)",
                "leaf": true,
                "category_id": 40100395
              },
              {
                "var": false,
                "name": "支座 (新)",
                "leaf": true,
                "category_id": 40100396
              }
            ],
            "var": false,
            "name": "專業音訊配件",
            "leaf": false,
            "category_id": 40100394
          },                
        ],
      }, 
      ] ,      
    "success": true,
    "class": "com.alibaba.normandie.gateway.client.domain.lazop.APIResult"
  },
  "code": "0",
  "request_id": "0b1196a615933101217536048"
}

2、取得壹個產品類目的產品屬性列表

調用 GetCategoryAttributes 接口，通過得到的 category_id，得到該類目的產品屬性列表
產品屬性分為共通屬性與類目獨有屬性， 因類目屬性族繁不及備載，請確實查詢該類目下的獨有屬性做為創建商品的傳入參數 。共通屬性的參數說明請查閱本文件的最後一節:共通參數說明
請求參數說明：categoryId
響應參數說明：所有的類目屬性項和屬性值
請求參數示例
“categoryId”:“40100388”
響應參數示例

{
  "data": [
    {
      "is_sale_prop": 0,
      "options": [],
      "name": "name",
      "inputType": "text",
      "is_mandatory": 1,
      "property_id": 100043175
    },
    {
      "is_sale_prop": 0,
      "options": [],
      "name": "package_length",
      "inputType": "numeric",
      "is_mandatory": 1,
      "property_id": 224404846
    },
    {
      "is_sale_prop": 0,
      "options": [],
      "name": "package_width",
      "inputType": "numeric",
      "is_mandatory": 1,
      "property_id": 224404847
    },
    {
      "is_sale_prop": 0,
      "options": [
        {
          "name": "10 年",
          "id": 50070493
        },
        {
          "name": "1 年",
          "id": 54411378
        },
        {
          "name": "8 歲",
          "id": 130075703
        },
        {
          "name": "2 個月",
          "id": 1878244503
        },
        {
          "name": "30 年",
          "id": 1878517492
        },
        {
          "name": "終身保修",
          "id": 4890912112
        }
      ],
      "name": "warranty",
      "inputType": "singleSelect",
      "is_mandatory": 0,
      "property_id": 100008167
    },
    {
      "is_sale_prop": 0,
      "options": [],
      "name": "package_height",
      "inputType": "numeric",
      "is_mandatory": 1,
      "property_id": 224495602
    },
    {
      "is_sale_prop": 0,
      "options": [],
      "name": "brand",
      "inputType": "singleSelect",
      "is_mandatory": 1,
      "property_id": 20000
    },
    {
      "is_sale_prop": 0,
      "options": [],
      "name": "taobao seller name",
      "inputType": "text",
      "is_mandatory": 0,
      "property_id": 226649315
    },
    {
      "is_sale_prop": 0,
      "options": [
        {
          "name": "None",
          "id": 3270618
        },
        {
          "name": "液體",
          "id": 6223181
        },
        {
          "name": "帶電池",
          "id": 9390368
        },
        {
          "name": "易燃",
          "id": 790268265
        }
      ],
      "name": "Hazmat",
      "inputType": "multiSelect",
      "is_mandatory": 0,
      "property_id": 226649313
    },
    {
      "is_sale_prop": 0,
      "options": [],
      "name": "price",
      "inputType": "numeric",
      "is_mandatory": 1,
      "property_id": 100151378
    },
    {
      "is_sale_prop": 0,
      "options": [],
      "name": "package_content",
      "inputType": "text",
      "is_mandatory": 1,
      "property_id": 226649321
    },
    {
      "is_sale_prop": 0,
      "options": [
        {
          "name": "無保修",
          "id": 1879916309
        },
        {
          "name": "國際製造商保修",
          "id": 4890910859
        },
        {
          "name": "當地製造商保修",
          "id": 4890912100
        }
      ],
      "name": "warranty type",
      "inputType": "singleSelect",
      "is_mandatory": 1,
      "property_id": 226643310
    },
    {
      "is_sale_prop": 0,
      "options": [],
      "name": "images",
      "inputType": "img",
      "is_mandatory": 0,
      "property_id": 226643313
    },
    {
      "is_sale_prop": 0,
      "options": [],
      "name": "quantity",
      "inputType": "numeric",
      "is_mandatory": 0,
      "property_id": 101257008
    }
  ],
  "success": true,
  "code": "0",
  "request_id": "0b1196a615933121356098098"
}

3、取得產品的品牌名稱

調用GetBrands接口，得到品牌名稱（name）
請求參數說明：
響應參數說明：所有產品的品牌名稱和屬性
請求參數示例
“offset”:“50”,
“limit”:“3”
響應參數示例

{
  "data": [
    {
      "name": "LG",
      "id": 4890912139,
      "name_en": "LG"
    },
    {
      "name": "M900",
      "id": 4890912140,
      "name_en": "M900"
    },
    {
      "name": "三星",
      "id": 4890912141,
      "name_en": "三星"
    }
  ],
  "success": true,
  "code": "0",
  "request_id": "0b1196a615946209600915100"
}

4、從本地上傳圖片至服務器

調用UploadImage接口，得到已上傳圖片的訪問地址（url）
請求參數說明：圖片名稱和內容
響應參數說明：已上傳圖片的地址和哈希值
請求參數示例
“fileName”:“我的商品圖片.jpg”,
“image”:“[0,1,1]”
響應參數示例

{
  "code": "0",
  "data": {
    "hash_code": "61bdf049525b7d4c2cf79257ec7c2c56",
    "url": "https://img-ovs.alicdn.com/p/myproduct.jpg"
  },
  "request_id": "0ba2887315178178017221014"
}

5、創建商品

調用CreateProduct接口，創建商品。建立商品的時候，傳入的參數會因為第二步的產品類目不同，需要傳入不同的產品屬性欄位，必須注意這些欄位有些可能為必填(is_mandatory=1)，當該屬性欄位為必填時，需要全部填入後才能成功呼叫。


請求參數示例

{   "attributes": 
	{     
		"brand": "順其自然",//通过GetBrands接口得到的name 	  
		"name": "測試產品",     
		"short description": "品牌 : 10COM/十厘米 面料 : 棉 貨號 : 234 成分含量 : 96%及以上",     
		"description": "這是商品詳細描述",  
		"warranty type": 2000004004,
    "warranty": 50070493,
    "product warranty": "這是商品保固政策",
		"Hazmat": "6223181,9390368,790268265",     
		"deliveryPeriod": 2,     
		"pickupPoint": [
			{
				"value": "FAMILY_MART"	},
			{	
				"value": "SEVEN_11"	},
			{	
				"value": "HI_LIFE"	}
						]
	},   
		"catId": 30004375,//通过GetCategoryTree接口得到的category_id
		"skuList": [
			{	"SellerSku": "600024363964776987-123",
				"package_weight": 0.05,       
				"package_length": 10,       
				"package_width": 10,       
				"package_height": 10,       
				"color family": "黑色",       
				"size": "50",       
				"quantity": 100,       
				"package_content": "default",       
					"images": [ //通过UploadImage接口得到的已上传图片的访问地址（url）   
					"https://img-ovs.alicdn.com/other/gsp/e4b96b68d61f18a93aaab544d278b8ef.jpeg",         
					"https://img-ovs.alicdn.com/other/gsp/457b5f1fc50604e317f1e605c5b53aa7.jpeg",         
					"https://img-ovs.alicdn.com/other/gsp/2e28843f17dba8148224650ec212a859.jpeg"       
								],       
				"price": 68,       
				"lossThresholdPrice": 55,       
				"Status": "active"     
			}   
					] 
}

響應參數示例

{
 "code": "0",
 "data": {},
 "request_id": "0ba2887315178178017221014"
}

共通參數說明:

pickupPoint 超商取貨參數說明

sellerSelfDelivery 賣家物流參數說明

localLogisticDelivery 官方宅配參數說明

SKU List 商品詳細變樣參數說明

FAQ