广告投放商品系列添加
前置条件
创建商品。
请求地址
https://api.e.qq.com/v1.3/product_series/add
所属权限
广告管理（Ads Management）
请求方法
POST
请求参数
| 参数名 | 描述 |
|---|---|
| access_token | 授权令牌，完成 OAuth 2.0 授权后获得，参考开发者环境 |
| timestamp | 当前的时间戳，单位为秒，允许客户端请求最大时间误差为 300 秒。MarketingAPI 所使用的时间戳，若无特殊说明，均为秒级时间戳签名算法。MarketingAPI 所使用的时区为 GMT+8，例如当时间戳为 1494840119 时，表示 2017-05-15 17:21:59 |
| nonce | 随机字串标识，不超过 32 个字符，由调用方自行生成，需保证全局唯一性 |
请求体类型
application/json
请求体参数
阅读说明：Y - 必填；C - 条件选填（conditional），请关注“描述”信息；空 - 非必填
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| account_id | integer | Y | 推广帐号 id或 DataNexus 账号 id |
| catalog_id | integer | Y | 商品库 id，通过 <a href='https://datanexus.qq.com/doc/develop/guider/interface/commodity/product_catalogs_add'>product_catalogs/add 接口</a> 创建商品库时分配的唯一 id |
| series_name | string | Y | 商品系列名称，字段长度最小 1 字节，长度最大 1024 字节 |
| definition | object | Y | 商品系列详情 |
| logic_operator | enum | Y | 商品系列逻辑操作符，枚举列表：{ LOGIC_OPERATOR_OR, LOGIC_OPERATOR_AND } |
| filters | array | Y | 商品系列条件 |
| field | string | Y | 过滤字段，字段长度最小 1 字节，长度最大 32 字节 |
| operator | enum | Y | 操作符，字段长度最小 1 字节，长度最大 100 字节 |
| values | array | 字段取值，values 数组的个数限制与 operator 的取值相关 | |
| field_value | string | 字段取值 | |
| currency_type | enum | 字段取值货币类型，枚举列表：{ CURRENCY_TYPE_UNKNOWN, CURRENCY_TYPE_CNY } |
请求示例
curl 'https://api.e.qq.com/v1.3/product_series/add?access_token=<ACCESS_TOKEN>×tamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=<ACCOUNT_ID>' \
-d 'catalog_id=<CATALOG_ID>' \
-d 'series_name=美妆系列' \
-d 'definition={"logic_operator":"LOGIC_OPERATOR_OR","filters":[{"field":"first_category_name","operator":"EQUALS","values":[{"field_value":"美容护肤"}]}]}'
应答体结构
| 名称 | 类型 | 描述 |
|---|---|---|
| list | array | 返回行业信息列表 数组最大长度 50 |
| product_outer_id | string | 广告主商品 id |
| product_name | string | 商品名称 |
| product_image_url | string | 商品预览图 |
| product_short_name | string[] | 商品简称 |
| price | float | 商品日常售价，大于等于 0，至多 2 位小数 |
| first_category_id | integer | 一级分类 id |
| first_category_name | string | 一级分类名称 |
| second_category_id | integer | 二级分类 id |
| second_category_name | string | 二级分类名称 |
| third_category_id | integer | 三级分类 id |
| third_category_name | string | 二级分类名称 |
| fourth_category_id | integer | 四级分类 id |
| fourth_category_name | string | 四级分类名称 |
| brand_name | string | 品牌名称 |
| brand_id | integer | 品牌 id |
| description | string | 商品描述 |
| custom_data | string | 商品自定义属性 |
| is_video | boolean | 是否视频商品（true|false） |
| data_source | string | 搜索结果来源名称 |
| product_select_score | float | 爆量分 |
应答示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"product_series_id": 11050,
"product_series_name": "不限"
}
}
该内容是否有帮助？