创建商品系列

开发环境

POST

/v1.3/product_series/add

请求参数

标有*的参数为必填项

名称	类型	描述
account_id*	integer	广告主 id，有操作权限的广告主 id，如果已经升级了工作台，则填写 bm_id
catalog_id*	integer	商品库 id
series_name*	string	商品系列名称字段长度最小 1 字节，长度最大 1024 字节
definition*	struct	商品系列详情
logic_operator*	enum	商品系列逻辑操作符,详见枚举值，[枚举详情] 枚举列表：{ LOGIC_OPERATOR_OR, LOGIC_OPERATOR_AND }
filters*	struct[]	商品系列条件
field*	string	过滤字段字段长度最小 1 字节，长度最大 32 字节
operator*	enum	操作符，操作符和过滤字段有关字段长度最小 1 字节，长度最大 100 字节
values*	string[]	字段取值，values 数组的个数限制与 operator 的取值相关
field_value*	string	字段取值
currency_type	enum	字段取值货币类型，[枚举详情] 枚举列表：{ CURRENCY_TYPE_UNKNOWN, CURRENCY_TYPE_CNY }

请求示例

Shell

JavaScript

Java

Swift

curl --location --request POST '/v1.3/product_series/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
--header 'access_token;' \
--header 'timestamp;' \
--header 'nonce;' \
--header 'fields;' \
--data-urlencode 'account_id=<ACCOUNT_ID>' \
--data-urlencode 'catalog_id=<CATALOG_ID>' \
--data-urlencode 'series_name=美妆系列' \
--data-urlencode 'definition={"logic_operator":"LOGIC_OPERATOR_OR","filters":[{"field":"first_category_name","operator":"EQUALS","values":[{"field_value":"美容护肤"}]}]}'

响应示例

{
    "code": 0,
    "message": "",
    "message_cn": "",
    "data": {
        "product_series_id": 11050,
        "product_series_name": "不限"
    }
}

请求参数

Query 参数

Header 参数

Body 参数application/x-www-form-urlencoded

返回响应

🟢200成功

application/json

Body

修改于 2023-11-02 06:51:55

获取商品类目

获取商品系列

创建商品系列

请求参数#

请求参数

返回响应

请求参数