通过上传文件创建商品系列

您可以使用本接口通过上传包含 SKU ID 的 CSV 文件，在您的商务中心下为电商商品库创建商品系列。

请求

地址 https://business-api.tiktok.com/open_api/v1.3/catalog/set/upload/

方法 POST

Header

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|Access-Token {必填}|string|授权访问令牌。详情请参见[认证](1738373164380162.html)。|
|Content-Type {必填}|string|请求信息类型<br>允许格式：`multipart/form-data`。|

参数

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|bc_id {必填}|string|商务中心 ID。<br><br>如需获取您有权限访问的商务中心列表，可使用 [/bc/get/](1737115687501826.html)。|
|catalog_id {必填}|string|商品库 ID。<br><br>如需获取商务中心内的电商商品库列表，可使用 [/catalog/get/](1740315452868610.html)。对于电商商品库，`catalog_type` 将为 `ECOM`。|
|product_set_name {必填}|string|商品系列名称。<br><br>长度限制：28 个字符。<br><br><p><span style="color:darkred"><b>注意</b></span>：不支持重复的商品系列名称。如需获取商品库中已创建的现有商品系列的名称，可使用 [/catalog/set/get/](1740570556295169.html) 并检查返回的 `product_set_name`。|
|file {必填}|file|包含商品 SKU ID 列表的文件。<br><br>如需获取电商商品库中商品的 SKU ID 列表，可使用 [/catalog/product/get/](1740564136678402.html) 并检查返回的 `sku_id`。 <br><br>建议设置：<ul><li>最大行数：5,000。</li><li>格式：仅支持 .csv。</li></ul>可使用 [CSV 模板文件](https://bytedance.sg.larkoffice.com/sheets/GlkOsKz7RhRhfLtN0gblmYcjgjd)进行上传。|
|file_signature {必填}|string|文件的 MD5 哈希值，用于服务器验证以确认文件完整性。|

示例

(code curl http)
curl --location --request POST 'https://business-api.tiktok.com/open_api/v1.3/catalog/set/upload/' \
--header 'Access-Token: {{Access-Token}}' \
--header 'Content-Type: multipart/form-data' \
--form 'bc_id="{{bc_id}}"' \
--form 'catalog_id="{{catalog_id}}"' \
--form 'product_set_name="{{product_set_name}}"' \
--form 'file=@"/{{file_path}}"' \
--form 'file_signature="{{file_signature}}"'
(/code)

返回

|字段{30%}|类型{15%}|描述{55%}|
|---|---|---|
|code |number|返回码。完整返回码列表及描述参见[附录 - 返回码](1737172488964097.html)。|
|message|string|返回信息。更多信息参见[附录 - 返回码](1737172488964097.html)。|
|request_id |string|请求的日志 ID，唯一标识一个请求。|
|data |object|返回数据。|
#|product_set_id |string|商品系列 ID。|
#|product_set_name |string|商品系列名称。|

示例

(code Success-Response http)
HTTPS/1.1 200 OK
{
    "code": 0,
    "message": "OK",
    "request_id": "{{request_id}}",
    "data": {
        "product_set_id": "{{product_set_id}}",
        "product_set_name": "{{product_set_name}}"
    }
}
(/code)