通过筛选条件创建商品系列
您可以使用本接口在商务中心下的商品库通过筛选条件创建一个商品系列。
v1.2与v1.3版本对比
以下表格概括了 v1.2与v1.3接口的变化。
``xtable
|变化内容{30%}|v1.2{35%}|v1.3{35%}|
|---|---|---|
|接口路径| /v1.2/catalog/set/create/| /v1.3/catalog/set/create/|
|请求参数名称 |name|product_set_name|
|请求参数类型|bc_id: number<br>catalog_id: number|bc_id: string<br>catalog_id: string|
|返回参数名称|name<br>count|product_set_name<br>product_count|
|返回参数名称和类型|id: number|product_set_id`: string|
## 请求
**地址** https://business-api.tiktok.com/open_api/v1.3/catalog/set/create/
**方法** POST
**Header**
```xtable
|字段|类型|描述|
|--- |--- |--- |
|Access-Token {必填}|string|授权访问令牌。可以通过[获取访问令牌](https://ads.tiktok.com/marketing_api/docs?id=1738373164380162)接口获取。|
|Content-Type {必填}|string|请求信息类型。<br>允许格式：`application/json`。|
参数
|字段{30%}|类型{15%}|描述{55%}|
|--- |--- |--- |
|bc_id {必填}|string|商务中心ID。|
|catalog_id {必填}|string|商品库ID。|
|product_set_name {必填}|string|商品系列名称。<br><br>长度限制：128 个字符。|
|conditions {必填}|object|筛选条件。<br><br><p><span style="color:darkred"><b>注意</b></span>：若您通过本对象传入多个筛选条件，建议您在所有筛选条件中传入的预期值总数不超过1024个。否则，很可能出现请求超时。|
#|and/or {必填}|object[]|筛选条件的交并情况，and:交集 or:并集。<br>只能选择其中一个。|
##|field {必填}|string|筛选字段。枚举值请参考[商品系列运算符和筛选字段 - 筛选字段](https://ads.tiktok.com/marketing_api/docs?id=1740673108747265)。|
##|operation {必填}|string|筛选运算符。枚举值请参考[商品系列运算符和筛选字段 - 运算符](https://ads.tiktok.com/marketing_api/docs?id=1740673108747265)。|
##|value {必填}|string/string[]|预期值。<br><br>根据您通过`operation`字段指定的运算符，本字段可能是一个单独值或一个列表中的多个值。请查看[商品系列运算符和筛选字段 - 运算符](https://ads.tiktok.com/marketing_api/docs?id=1740673108747265)了解您需要指定的值。<br><br><p><span style="color:darkred"><b>注意</b></span>：若您通过本字段传入的值为多个，则最多传入1,024个值。|
示例：筛选规则
(code curl http)
curl -X POST -H "Access-Token:YOUR_ACCESS_TOKEN" \
-H "Content-Type:application/json" \
-d '{\"bc_id\": BC_ID,\"catalog_id\": CATALOG_ID,\"name\": NAME},\"conditions\": [CONDITIONS]}' \
https://business-api.tiktok.com/open_api/v1.3/catalog/set/create/
(/code)
返回
|字段|类型|描述|
|--- |--- |--- |
|code |number|返回码，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|message |string|返回信息，详见[附录-返回码](https://ads.tiktok.com/marketing_api/docs?id=1737172488964097)。|
|request_id|string|请求日志ID。|
|data|object|返回数据。|
#|product_set_id|string|商品系列ID。|
#|product_set_name|string|商品系列名称。|
#|product_count|number|该商品系列下的商品数量。|
示例
(code Success-Response http)
HTTPS/1.1 200 OK
{
"message": "OK",
"code": 0,
"data": {
"count": 20,
"product_set_id": "1566",
"name": "test_create"
},
"request_id": "20210228131918010231010121650793"
}
(/code);