广告投放商品添加

前置条件

获得商品库。

请求地址

https://api.e.qq.com/v3.0/product_items/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
product_catalog_id	integer	Y	商品库 id
feed_id	integer		商品文件 id
request_source	string		请求源，长度最大 256 字节
product_item_spec_list	array	Y	商品信息列表 数组最大长度 50
product_outer_id	string	Y	广告主商品 id，长度最大 255 字节
product_name	string	Y	商品名称，长度最大 256 字节
description	string		商品描述，长度最大 5000 字节
created_time	string		商品创建时间，字段长度最小 19 字节，长度最大 20 字节
last_modified_time	string		商品更新时间，字段长度最小 19 字节，长度最大 20 字节
expiration_time	string	Y	商品下架时间，字段长度最小 19 字节，长度最大 20 字节
image_url	string		商品图片 URL，长度最大 2048 字节
additional_image_url	string[]		额外的商品图片 URL，数组最大长度 50，长度最大 2048 字节
hidden_landing_img_url	string[]		蹊径动态落地页图片 url，数组最大长度 50，长度最大 2048 字节
video_duration	string		商品视频长度，长度最大 2048 字节
video_url	string		商品视频链接，长度最大 2048 字节
play_count	integer		数字类型
publish_time	string		视频发布时间，字段长度最小 19 字节，长度最大 20 字节
additional_video_url	string[]		备用商品视频链接，数组最大长度 50，长度最大 2048 字节
pc_page_url	string		PC 端落地页，长度最大 2048 字节
mobile_h5_page_url	string		移动 H5 落地页 1，长度最大 2048 字节
android_page_url	string		Android 应用直达落地页 1，长度最大 2048 字节
ios_page_url	string		iOS 应用直达落地页 1，长度最大 2048 字节
wechat_page_url	string		微信落地页 1，长度最大 2048 字节
additional_mobile_h5_page_url	string		移动 H5 落地页 2，长度最大 2048 字节
additional_android_page_url	string		Android 应用直达落地页 2，长度最大 2048 字节
additional_ios_page_url	string		iOS 应用直达落地页 2，长度最大 2048 字节
additional_wechat_page_url	string		微信落地页 2，长度最大 2048 字节
mini_program_id	string		微信小程序 id1，长度最大 50 字节
mini_program_path	string		微信小程序路径 1，长度最大 2048 字节
additional_mini_program_id	string		微信小程序 id2，长度最大 50 字节
additional_mini_program_path	string		微信小程序路径 2，长度最大 2048 字节
universal_link	string		IOS 通用落地页，长度最大 2048 字节
additional_universal_link	string		备用 IOS 通用落地页，长度最大 2048 字节
product_short_name	string		商品简称，长度最大 100 字节
price	float		商品日常售价，大于等于 0，至多 2 位小数，最小值 0，最大值 9999999999，最多保留 2 位小数
original_price	float		商品原售价，大于等于 0，至多 2 位小数，最小值 0，最大值 9999999999，最多保留 2 位小数
discount	float		商品折扣，最大值 9999999999，最多保留 2 位小数
sale_price	float		商品促销价格，大于等于 0，至多 2 位小数，最小值 0，最大值 9999999999，最多保留 2 位小数
start_time	string		促销价开始时间，字段长度最大 20 字节
end_time	string		促销价结束时间，字段长度最大 20 字节
sales_volume	integer		已售卖数
stock_volume	integer		库存数
slogan	string		广告语，字段长度最大 100 字节
custom_label	string[]		自定义标签，数组最大长度 50，长度最大 100 字节
first_category_id	integer		一级分类 id
second_category_id	integer		二级分类 id
third_category_id	integer		三级分类 id
fourth_category_id	integer		四级分类 id
first_category_name	string		一级分类名称，长度最大 100 字节
second_category_name	string		二级分类名称，长度最大 100 字节
third_category_name	string		三级分类名称，长度最大 100 字节
fourth_category_name	string		四级分类名称，长度最大 100 字节
first_category_url	string		一级分类 URL，长度最大 2048 字节
second_category_url	string		二级分类 URL，长度最大 2048 字节
third_category_url	string		三级分类 URL，长度最大 2048 字节
fourth_category_url	string		四级分类 URL，长度最大 2048 字节
brand_id	integer		品牌 id
product_brand	string		品牌名称，长度最大 100 字节
brand_url	string		品牌页 url，长度最大 2048 字节
promotion_id	integer		活动档期 id
promotion_name	string		活动档期名称，长度最大 100 字节
promotion_url	string		活动档期 URL 地址，长度最大 2048 字节
shop_id	integer		店铺 id
shop_name	string		店铺名称，长度最大 100 字节
shop_url	string		店铺 URL 地址，长度最大 2048 字节
shop_custom_info	string		店铺自定义信息，长度最大 5000 字节
shop_id_list	string[]		门店 id 列表，数组最大长度 50，长度最大 2048 字节
product_view_count	integer		商品详情页打开次数
favorite_count	integer		收藏用户数
rating	float		评分,小数点 2 位，取值 0~5，最多保留 2 位小数
favourable_comment_rate	float		好评率，小数点 2 位，取值 0~1，最多保留 2 位小数
product_owner_type	enum		商品所有者类型，见 枚举值
author	string		作者，长度最大 100 字节
full_text	string		全文内容，长度最大 2000 字节
like_count	integer		点赞数
forward_count	integer		转发数
comment_count	integer		评论数
author_fans_count	integer		作者粉丝数
semantic_labels	string[]		语义标签，数组最大长度 50，长度最大 2048 字节
detail_img	string[]		图文详情描述，数组最大长度 50，长度最大 2048 字节
show_count	integer		视频曝光次数
play_rate	float		视频播放率，小数点 2 位，，取值 0~1，最多保留 2 位小数
make_money_online	string		是否网赚（是或者否），长度最大 100 字节
live_broadcast	string		是否直播（是或者否），长度最大 100 字节
platform_attribute	string		平台属性，长度最大 100 字节
custom_data	string		商品自定义属性，长度最大 5000 字节
shooting_pic_count	integer		拍摄张数
fineedit_count	integer		精修张数
album_photo_count	integer		入册张数
album_count	integer		相册数量
frame_count	integer		相框数量
country	string		所在国家，长度最大 100 字节
province	string		所在省份/州/直辖市，长度最大 100 字节
city	string		所在城市，长度最大 100 字节
district	string		所在区县，长度最大 100 字节
address	string[]		所在详细地址，数组最大长度 50，长度最大 200 字节
shooting_scene_in_count	enum		内景数量，见 枚举值
shooting_scene_out_count	enum		外景数量，见 枚举值
bride_clothing	enum		新娘服装，见 枚举值
groom_clothing	enum		新郎服装，见 枚举值
cloth_count	enum		服装套数，见 枚举值
shooting_scene	enum		拍摄场景类型，见 枚举值
set_special	string[]		套餐亮点，见 枚举值
shooting_style_com	string[]		拍摄风格，见 枚举值
shooting_scene_detail	string[]		拍摄场景，见 枚举值
tour_place_domestic	enum		国内拍摄地，见 枚举值
tour_place_foreign	enum		国外拍摄地，见 枚举值
max_insurance_quota	float		最高保额，大于等于 0，至多 2 位小数，最小值 0，最大值 9999999999，最多保留 2 位小数
first_month_insurance_fee	float		首月保费，大于等于 0，至多 2 位小数，最小值 0，最大值 9999999999，最多保留 2 位小数
max_quota	float		最高额度，大于等于 0，最小值 0，最大值 9999999999，最多保留 2 位小数
annualized_rate_of_return	float		年化收益率，大于等于 0，至多 4 位小数，最小值 0，最大值 9999999999，最多保留 4 位小数
risk_type	enum		风险等级类型，见 枚举值
artist	string[]		艺人，数组最大长度 100，字段长度最大 100 字节
trends	integer		热度，主要表明书籍在平台的热度，参考值包括在读人数、人气值等
pay_status	enum		书籍的付费状态，见 枚举值
word_count	integer		小说字数
serial_status	enum		书籍的连载状态，见 枚举值
book_json	object		小说前 4 章内容，字段最大空间 10 万字节
chapters	array		小说章节列表，数组最大长度 4
subtitle	string		章节标题
chapterid	integer		章节id，最大值 4
text	string[]		章节内容
ratings	float		评分，大于等于 0，最大值 5，最多保留 2 位小数
reader_count	integer		在读人数
recommended_votes_count	integer		推荐数
reward_count	integer		打赏数
ranking	integer		排名
space	enum		书籍的篇幅，见 枚举值
if_new_book	string		是否为新书，填 是 或者 否
chapter_count	integer		章节数
started_pay_chapter	integer		起始付费章节
pay_count	integer		累计付费次数
pay_amount	float		累计付费金额，单位元，最小值 0，最大值 9999999999，最多保留 2 位小数
first_pay_amount	float		首次付费金额，单位元，最小值 0，最大值 9999999999，最多保留 2 位小数
least_pay_amount	float		最低付费金额，单位元，最小值 0，最大值 9999999999，最多保留 2 位小数
onetime_pay_amount	float		一次性付费金额，单位元，最小值 0，最大值 9999999999，最多保留 2 位小数
latest_renew_time	string		书籍最新更新时间，字段长度最小 19 字节，长度最大 20 字节
latest_renew_chapter	integer		最后一次更新章节
share_count	integer		分享数
download_count	integer		下载数
paying_reader_count	integer		分享数
story_school	string		小说流派，用于描述小说的整体风格/派别 - 示例：甜宠文,女婿文,兵王文,神医文,乡村文,穿越文,修仙文，长度最大 30 字节
story_role_identity	string		角色身份，- 小说主要人物身份 - 示例：总裁,兵王,赘婿,少爷,皇帝,王妃,摄政王,嫡女,医妃,公主 - 多个标签可用英文;隔开，长度最大 30 字节
story_role_image	string		角色形象，小说主要人物形象 - 示例：花心,专情,萌系,玩世不恭,杀伐果断,腹黑,傲娇,霸道 - 多个标签可用英文;隔开，长度最大 30 字节
story_era	string		时代背景，小说故事发生的时代背景 - 示例：现代,古代,穿越 - 多个标签可用英文;隔开，长度最大 30 字节
story_scene	string		故事场景，小说故事发生的场景描述 - 示例：豪宅,医院,豪车,婚房,宴会,王府,皇宫,战场,深宫 - 多个标签可用英文;隔开，长度最大 30 字节
story_plot	string		小说的故事情节描述 - 示例：豪门恩怨,逃婚,乡村爱情,失忆,一胎多宝,入赘豪门,复仇,车祸,破产 - 多个标签可用英文;隔开 ，长度最大 30 字节
story_style	string		小说的风格描述 - 示例：情色,纯爱,搞笑,悲伤,温馨,爽文,苦恋,恐怖 - 多个标签可用英文;隔开，长度最大 30 字节
authorization_status	enum		作品授权状态，见 枚举值
originality	enum		作品原创性，见 枚举值
update_frequency	enum		作品更新频率，见 枚举值
play_form	enum		播讲形式，作品展现形式，主要用于音频类作品，见 枚举值
play_author	string		播讲人，作品讲述者，主要用于音频类作品 - 示例：易中天,刘心武 - 多个标签可用英文;隔开，长度最大 30 字节
play_voice	enum		作品配音，作品配音来源，主要用于音频类和漫画类作品，见 枚举值
production_source	enum		内容来源，作品内容来源，主要用于音频类和漫画类作品，见 枚举值
production_place	enum		内容产地，作品产地，主要用于漫画类作品，见 枚举值
cartoon_color	enum		漫画色彩，作品产地，主要用于漫画类作品，见 枚举值
max_quota_v2	enum		最高额度，见 枚举值
standard_catalog_product_hash_id	integer		标品库商品 id
custom_url	string		自定义商品链接 1，长度最大 100 字节
additional_custom_url	string		自定义商品链接 2，长度最大 100 字节
product_barcode	string		商品条码，长度最大 100 字节
business_price	enum		商务服务价格，见 枚举值
initial_total_investment	enum		首次投资总额，见 枚举值
business_audience	enum		受众，见 枚举值

请求示例

curl 'https://api.e.qq.com/v1.1/product_items/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-d 'account_id=111111111' \
-d 'product_catalog_id=<CATALOG_ID>' \
-d 'feed_id=980' \
-d 'product_item_spec_list=[{"product_name":"aaa","product_outer_id":"39526","description":"测试商品描述 1","created_time":"2019-01-01 02:01:00","last_modified_time":"2019-01-03 01:01:00","expiration_time":"2019-01-01 01:01:00","image_url":"http://xxx11","additional_image_url":["http://img12.360buyimg.com/n1/jfs/t1/28929/10/8906/159902/5c7a994eEbd478ee9/83eaee0f152efea8.jpg","http://img12.360buyimg.com/n1/jfs/t1/21918/1/9053/132283/5c7a993fE01f4f607/5c0a3661650bf986.jpg","http://img12.360buyimg.com/n1/jfs/t1/23586/23/8911/151874/5c7a993fE10c58c15/f220fa3583c3458b.jpg"],"hidden_landing_img_url":["http://img12.360buyimg.com/n1/jfs/t1/28929/10/8906/159902/5c7a994eEbd478ee9/83eaee0f152efea8.jpg","http://img12.360buyimg.com/n1/jfs/t1/21918/1/9053/132283/5c7a993fE01f4f607/5c0a3661650bf986.jpg","http://img12.360buyimg.com/n1/jfs/t1/23586/23/8911/151874/5c7a993fE10c58c15/f220fa3583c3458b.jpg"],"standard_catalog_product_hash_id":0,"video_url":"http://vidoe","additional_video_url":["http://addioional video 1","http://addioional video 2","http://addioional video 3"],"pc_page_url":"https://addata.jd.com/fcgi-bin/jdjump?turl=http%3A%2F%2Fre.jd.com%2Flist%2Fitem%2F1349-42532700531.html%3Fre_dcp%3D2xc%26gaid%3D5000000000_1000001%26gsid%3D1","mobile_page_url":"http://mobile","android_page_url":"http://android","ios_page_url":"http://ios","wechat_page_url":"http://wechat","additional_mobile_page_url":"http://mobile additional","additional_android_page_url":"http://android additional","additional_ios_page_url":"http://ios additional","additional_wechat_page_url":"http://wechat additional","mini_program_id":"mini id1","mini_program_path":"mini1 path","additional_mini_program_id":"mini id2","additional_mini_program_path":"mini2 path","universal_link":"universal","additional_universal_link":"additional universal","product_short_name":"shortName","price":123.0100000000000051159076974727213382720947265625,"original_price":1234.01999999999998181010596454143524169921875,"discount":12345.0400000000008731149137020111083984375,"sale_price":123456.02999999999883584678173065185546875,"start_time":"2019-01-01 01:02:00","end_time":"2019-01-01 01:03:00","sales_volume":456,"stock_volume":4567,"slogan":"广告语","custom_label":["http://label 1","http://label 2","http://label 3"],"first_category_id":1,"first_category_name":"catalogName 1","second_category_id":2,"second_category_name":"catalogName 2","third_category_id":3,"third_category_name":"catalogName 3","fourth_category_id":4,"fourth_category_name":"catalogName 4","brand_id":789,"brand_name":"品牌名称","brand_url":"http://brandUrl","promotion_id":7890,"promotion_name":"促销名称","promotion_url":"http://protmotionUrl","shop_id":78901,"shop_name":"店铺名称","shop_url":"http://shopUrl","shop_custom_info":"门店自定义","shop_id_list":["id list 11","id list 2","id list 3"],"product_view_count":18402,"favorite_count":18403,"rating":147,"favourable_comment_rate":258,"product_owner_type":"PRODUCT_OWNER_TYPE_SOP","author":"author1","full_text":"This is full text","semantic_labels":["novel","exciting","fantastic"],"like_count":123,"forward_count":234,"comment_count":12,"author_fans_count":10000,"artist":["aaa","bbb"],"chapter_count":10,"serial_status":"SERIAL_STATUS_FINISH","if_new_book":"是","trends":10,"pay_status":"PAY_STATUS_FREE","word_count":100,"ratings":4.519999999999999573674358543939888477325439453125,"reader_count":444,"recommended_votes_count":555,"reward_count":333,"space":"BOOK_LENGTH_SHORT","started_pay_chapter":1,"pay_count":11,"pay_amount":5.44000000000000039079850466805510222911834716796875,"first_pay_amount":3.29999999999999982236431605997495353221893310546875,"least_pay_amount":0.01000000000000000020816681711721685132943093776702880859375,"onetime_pay_amount":6.660000000000000142108547152020037174224853515625,"latest_renew_time":"2021-12-12 00:00:01","latest_renew_chapter":4,"share_count":100,"download_count":10,"paying_reader_count":100,"story_school":"甜宠文甜宠文甜宠文甜","story_role_identity":"甜宠文甜宠文甜宠文甜","story_role_image":"甜宠文甜宠文甜宠文甜 a","story_era":"甜宠文甜宠文甜宠文甜","story_scene":"甜宠文甜宠文甜宠文甜","story_plot":"甜宠文甜宠文甜宠文甜","story_style":"甜宠文甜宠文甜宠文甜","authorization_status":"AUTHORIZATION_STATUS_EXCLUSIVE","originality":"ORIGINALITY_YES","update_frequency":"UPDATE_DAILY","play_form":"PLAY_FORM_BY_ONE","play_author":"sb","play_voice":"PLAY_VOICE_SYSTEM","production_source":"PRODUCTION_SOURCE_UGC","production_place":"PRODUCTION_PLACE_CN","cartoon_color":"CARTOON_COLOR_BLACK_WHITE","ranking":1,"book_json":{"chapters":[{"subtitle":"第 1 章","chapterid":1,"text":["你好","这是","小说","章节","第一章"]},{"subtitle":"第 2 章","chapterid":2,"text":["你好","这是","小说","章节","第二章"]},{"subtitle":"第 3 章","chapterid":3,"text":["你好","这是","小说","章节","第三章"]},{"subtitle":"第 4 章","chapterid":4,"text":["你好","这是","小说","章节","第四章"]}]},"custom_url":"http://custom_url","additional_custom_url":"http://additional_custom_url","product_barcode":"1234567890"}]' 

应答体结构

名称	类型	描述
list	array	返回信息列表
product_id	string	商品 id
product_outer_id	string	广告主商品 id

应答示例

{
  "code": 0,
  "message": "",
  "message_cn": "",
  "data": {
    "list": [
      {
        "product_id": 39526,
        "product_outer_id": "xly_123"
      }
    ]
  }
}

该内容是否有帮助？