添加商品
全部接口
V1.1
loading
V1.1
loading
所属权限 | Ads Management |
请求地址 | product_items/add |
请求方法 | post |
全局参数
全局参数是指每一个接口都需要使用到的参数。详情参考,代码案例参考。
参数名称 | 参数类型 |
---|---|
access_token | 授权令牌,完成 OAuth 2.0 授权后获得,参考授权认证章节 |
timestamp |
当前的时间戳,单位为秒,允许客户端请求最大时间误差为 300 秒。 MarketingAPI 所使用的时间戳,若无特殊说明,均为秒级时间戳 MarketingAPI 所使用的时区为 GMT+8,例如当时间戳为 1494840119 时,表示 2017-05-15 17:21:59 |
nonce | 随机字串标识,不超过 32 个字符,由调用方自行生成,需保证全局唯一性 |
fields | get 接口增加 fields 字段,用于指定返回参数的字段列表,为选填字段。fields 取值范围为 get 接口返回的 list 中的字段。如不填写,则根据默认值进行返回 |
请求参数
参数仅适用于腾讯广告平台,暂不支持微信公众平台。
标有*的参数为必填项
名称 | 类型 | 描述 |
---|---|---|
account_id*
|
integer | 广告主 id,有操作权限的广告主 id |
product_catalog_id*
|
integer | 商品库 id |
feed_id
|
integer | 商品文件 id |
product_item_spec_list*
|
struct[] | 商品信息列表 数组最大长度 50 |
product_outer_id*
|
string | 广告主商品 id 字段长度最小 1 字节,长度最大 255 字节 |
product_name*
|
string | 商品名称 字段长度最小 0 字节,长度最大 256 字节 |
description
|
string | 商品描述 字段长度最小 1 字节,长度最大 5000 字节 |
created_time
|
string | 商品创建时间 字段长度最小 19 字节,长度最大 20 字节 |
last_modified_time
|
string | 商品更新时间 字段长度最小 19 字节,长度最大 20 字节 |
expiration_time*
|
string | 商品下架时间 字段长度最小 19 字节,长度最大 20 字节 |
image_url
|
string | 商品图片 URL 字段长度最小 1 字节,长度最大 2048 字节 |
additional_image_url
|
string[] | 额外的商品图片 URL 数组最大长度 50 字段长度最小 1 字节,长度最大 2048 字节 |
video_duration
|
string | 商品视频长度 字段长度最小 1 字节,长度最大 2048 字节 |
video_url
|
string | 商品视频链接 字段长度最小 1 字节,长度最大 2048 字节 |
play_count
|
integer | 数字类型 |
publish_time
|
string | 视频发布时间 字段长度最小 19 字节,长度最大 20 字节 |
additional_video_url
|
string[] | 备用商品视频链接 数组最大长度 50 字段长度最小 1 字节,长度最大 2048 字节 |
pc_page_url
|
string | PC 端落地页 字段长度最小 1 字节,长度最大 2048 字节 |
mobile_h5_page_url
|
string | 移动 H5 落地页 1 字段长度最小 1 字节,长度最大 2048 字节 |
android_page_url
|
string | Android 应用直达落地页 1 字段长度最小 1 字节,长度最大 2048 字节 |
ios_page_url
|
string | iOS 应用直达落地页 1 字段长度最小 1 字节,长度最大 2048 字节 |
wechat_page_url
|
string | 微信落地页 1 字段长度最小 1 字节,长度最大 2048 字节 |
additional_mobile_h5_page_url
|
string | 移动 H5 落地页 2 字段长度最小 1 字节,长度最大 2048 字节 |
additional_android_page_url
|
string | Android 应用直达落地页 2 字段长度最小 1 字节,长度最大 2048 字节 |
additional_ios_page_url
|
string | iOS 应用直达落地页 2 字段长度最小 1 字节,长度最大 2048 字节 |
additional_wechat_page_url
|
string | 微信落地页 2 字段长度最小 1 字节,长度最大 2048 字节 |
mini_program_id
|
string | 微信小程序 id1 字段长度最小 1 字节,长度最大 50 字节 |
mini_program_path
|
string | 微信小程序路径 1 字段长度最小 1 字节,长度最大 2048 字节 |
additional_mini_program_id
|
string | 微信小程序 id2 字段长度最小 1 字节,长度最大 50 字节 |
additional_mini_program_path
|
string | 微信小程序路径 2 字段长度最小 1 字节,长度最大 2048 字节 |
universal_link
|
string | IOS 通用落地页 字段长度最小 1 字节,长度最大 2048 字节 |
additional_universal_link
|
string | 备用 IOS 通用落地页 字段长度最小 1 字节,长度最大 2048 字节 |
product_short_name
|
string | 商品简称 字段长度最小 1 字节,长度最大 100 字节 |
product_sale_status
|
enum | 商品在线状态,[枚举详情] 枚举列表:{ PRODUCT_SALE_STATUS_UNKNOWN, PRODUCT_SALE_STATUS_ONLINE, PRODUCT_SALE_STATUS_OFFLINE } |
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 | 广告语 字段长度最小 1 字节,长度最大 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 | 一级分类名称 字段长度最小 1 字节,长度最大 100 字节 |
second_category_name
|
string | 二级分类名称 字段长度最小 1 字节,长度最大 100 字节 |
third_category_name
|
string | 三级分类名称 字段长度最小 1 字节,长度最大 100 字节 |
fourth_category_name
|
string | 四级分类名称 字段长度最小 1 字节,长度最大 100 字节 |
first_category_url
|
string | 一级分类 URL 字段长度最小 0 字节,长度最大 2048 字节 |
second_category_url
|
string | 二级分类 URL 字段长度最小 0 字节,长度最大 2048 字节 |
third_category_url
|
string | 三级分类 URL 字段长度最小 0 字节,长度最大 2048 字节 |
fourth_category_url
|
string | 四级分类 URL 字段长度最小 0 字节,长度最大 2048 字节 |
brand_id
|
integer | 品牌 id |
brand_name
|
string | 品牌名称 字段长度最小 1 字节,长度最大 100 字节 |
brand_url
|
string | 品牌页 URL 字段长度最小 1 字节,长度最大 2048 字节 |
promotion_id
|
integer | 活动档期 id |
promotion_name
|
string | 活动档期名称 字段长度最小 1 字节,长度最大 100 字节 |
promotion_url
|
string | 活动档期 URL 地址 字段长度最小 1 字节,长度最大 2048 字节 |
shop_id
|
integer | 店铺 id |
shop_name
|
string | 店铺名称 字段长度最小 1 字节,长度最大 100 字节 |
shop_url
|
string | 店铺 URL 字段长度最小 1 字节,长度最大 2048 字节 |
shop_custom_info
|
string | 店铺自定义信息 字段长度最小 1 字节,长度最大 5000 字节 |
shop_id_list
|
string[] | 门店 id 列表 数组最大长度 50 字段长度最大 2048 字节 |
product_view_count
|
integer | 商品详情页打开次数 |
favorite_count
|
integer | 收藏用户数 |
rating
|
float | 评分,小数点 2 位,取值 0~5 最小值 0,最大值 5,最多保留 2 位小数 |
favourable_comment_rate
|
float | 好评率,小数点 2 位,取值 0~1 最小值 0,最大值 1,最多保留 2 位小数 |
product_owner_type
|
enum | 商品所有者类型,”自营“,”商家“,[枚举详情] 枚举列表:{ PRODUCT_OWNER_TYPE_SOP, PRODUCT_OWNER_TYPE_POP } |
author
|
string | 作者 字段长度最小 1 字节,长度最大 100 字节 |
full_text
|
string | 全文内容 字段长度最小 1 字节,长度最大 2000 字节 |
like_count
|
integer | 点赞数 |
forward_count
|
integer | 转发数 |
comment_count
|
integer | 评论数 |
author_fans_count
|
integer | 作者粉丝数 |
semantic_labels
|
string[] | 语义标签 数组最大长度 50 字段长度最小 1 字节,长度最大 2048 字节 |
detail_img
|
string[] | 图文详情描述 数组最大长度 50 字段长度最大 2048 字节 |
show_count
|
integer | 视频曝光次数 |
play_rate
|
float | 视频播放率,小数点 2 位,取值 0~1 最小值 0,最大值 1,最多保留 2 位小数 |
make_money_online
|
string | 是否网赚(是或者否) 字段长度最小 0 字节,长度最大 100 字节 |
live_broadcast
|
string | 是否直播 字段长度最小 0 字节,长度最大 100 字节 |
platform_attribute
|
string | 平台属性 字段长度最小 0 字节,长度最大 100 字节 |
custom_data
|
string | 商品自定义信息 字段长度最小 0 字节,长度最大 5000 字节 |
shooting_pic_count
|
integer | 拍摄张数 |
fineedit_count
|
integer | 精修张数 |
album_photo_count
|
integer | 入册张数 |
album_count
|
integer | 相册数量 |
frame_count
|
integer | 相框数量 |
country
|
string | 所在国家 字段长度最小 0 字节,长度最大 100 字节 |
province
|
string | 所在省份/州/直辖市 字段长度最小 0 字节,长度最大 100 字节 |
city
|
string | 所在城市 字段长度最小 0 字节,长度最大 100 字节 |
district
|
string | 所在区县 字段长度最小 0 字节,长度最大 100 字节 |
address
|
string[] | 所在详细地址 数组最大长度 50 字段长度最大 200 字节 |
shooting_scene_in_count
|
enum | 内景数量,[枚举详情] 枚举列表:{ SHOOTING_SCENE_IN_COUNT_1, SHOOTING_SCENE_IN_COUNT_2, SHOOTING_SCENE_IN_COUNT_3, SHOOTING_SCENE_IN_COUNT_4, SHOOTING_SCENE_IN_COUNT_5, SHOOTING_SCENE_IN_COUNT_6, SHOOTING_SCENE_IN_COUNT_7, SHOOTING_SCENE_IN_COUNT_N } |
shooting_scene_out_count
|
enum | 外景数量,[枚举详情] 枚举列表:{ SHOOTING_SCENE_OUT_COUNT_1, SHOOTING_SCENE_OUT_COUNT_2, SHOOTING_SCENE_OUT_COUNT_3, SHOOTING_SCENE_OUT_COUNT_4, SHOOTING_SCENE_OUT_COUNT_5, SHOOTING_SCENE_OUT_COUNT_6, SHOOTING_SCENE_OUT_COUNT_7, SHOOTING_SCENE_OUT_COUNT_N } |
bride_clothing
|
enum | 新娘服装,[枚举详情] 枚举列表:{ BRIDE_CLOTHING_1, BRIDE_CLOTHING_2, BRIDE_CLOTHING_3, BRIDE_CLOTHING_4, BRIDE_CLOTHING_5, BRIDE_CLOTHING_6, BRIDE_CLOTHING_7, BRIDE_CLOTHING_N } |
groom_clothing
|
enum | 新郎服装,[枚举详情] 枚举列表:{ GROOM_CLOTHING_1, GROOM_CLOTHING_2, GROOM_CLOTHING_3, GROOM_CLOTHING_4, GROOM_CLOTHING_5, GROOM_CLOTHING_6, GROOM_CLOTHING_7, GROOM_CLOTHING_N } |
cloth_count
|
enum | 服装套数,[枚举详情] 枚举列表:{ CLOTH_COUNT_1, CLOTH_COUNT_2, CLOTH_COUNT_3, CLOTH_COUNT_4, CLOTH_COUNT_5, CLOTH_COUNT_6, CLOTH_COUNT_7, CLOTH_COUNT_N } |
shooting_scene
|
enum | 拍摄场景,[枚举详情] 枚举列表:{ SHOOTING_SCENE_IN, SHOOTING_SCENE_OUT, SHOOTING_SCENE_BOTH } |
set_special
|
string[] | 套餐亮点,[枚举详情] 数组最大长度 255 字段长度最大 200 字节 |
shooting_style_com
|
string[] | 拍摄风格,[枚举详情] 数组最大长度 255 字段长度最大 200 字节 |
shooting_scene_detail
|
string[] | 拍摄场景,[枚举详情] 数组最大长度 255 字段长度最大 200 字节 |
tour_place_domestic
|
enum | 国内拍摄地,[枚举详情] 枚举列表:{ TOUR_PLACE_DOMESTIC_SANYA, TOUR_PLACE_DOMESTIC_CHANGSHA, TOUR_PLACE_DOMESTIC_XIAMEN, TOUR_PLACE_DOMESTIC_QINGDAO, TOUR_PLACE_DOMESTIC_LIJIANG, TOUR_PLACE_DOMESTIC_DALI, TOUR_PLACE_DOMESTIC_DALIAN, TOUR_PLACE_DOMESTIC_HK, TOUR_PLACE_DOMESTIC_TAIWAN, TOUR_PLACE_DOMESTIC_AOMEN, TOUR_PLACE_DOMESTIC_XIANGGELILA, TOUR_PLACE_DOMESTIC_QINGHAI, TOUR_PLACE_DOMESTIC_XIZANG, TOUR_PLACE_DOMESTIC_DAOCHENG, TOUR_PLACE_DOMESTIC_CHONGQING, TOUR_PLACE_DOMESTIC_SUZHOU, TOUR_PLACE_DOMESTIC_SHANGHAI, TOUR_PLACE_DOMESTIC_HANGZHOU, TOUR_PLACE_DOMESTIC_SHENZHEN, TOUR_PLACE_DOMESTIC_GUANGZHOU, TOUR_PLACE_DOMESTIC_BEIJING, TOUR_PLACE_DOMESTIC_XIAN, TOUR_PLACE_DOMESTIC_CHENGDU, TOUR_PLACE_DOMESTIC_BEIHAI, TOUR_PLACE_DOMESTIC_GUILIN, TOUR_PLACE_DOMESTIC_WUHAN, TOUR_PLACE_DOMESTIC_NANJING, TOUR_PLACE_DOMESTIC_HAIKOU } |
tour_place_foreign
|
enum | 国外拍摄地,[枚举详情] 枚举列表:{ TOUR_PLACE_FOREIGN_VN, TOUR_PLACE_FOREIGN_AU, TOUR_PLACE_FOREIGN_PALAO, TOUR_PLACE_FOREIGN_BALI, TOUR_PLACE_FOREIGN_FJ, TOUR_PLACE_FOREIGN_PUJI, TOUR_PLACE_FOREIGN_MV, TOUR_PLACE_FOREIGN_JP, TOUR_PLACE_FOREIGN_TR, TOUR_PLACE_FOREIGN_GR, TOUR_PLACE_FOREIGN_FR, TOUR_PLACE_FOREIGN_IT, TOUR_PLACE_FOREIGN_BULAGE, TOUR_PLACE_FOREIGN_XIANBENNA, TOUR_PLACE_FOREIGN_MU, TOUR_PLACE_FOREIGN_GE, TOUR_PLACE_FOREIGN_SUMEI, TOUR_PLACE_FOREIGN_SAIBAN, TOUR_PLACE_FOREIGN_JIZHOU, TOUR_PLACE_FOREIGN_SHABA, TOUR_PLACE_FOREIGN_DE, TOUR_PLACE_FOREIGN_LONDON, TOUR_PLACE_FOREIGN_SYDNEY, TOUR_PLACE_FOREIGN_NZ, TOUR_PLACE_FOREIGN_JILONGPO } |
max_insurance_quota
|
float | 最高保额,大于等于 0,至多 2 位小数 最小值 0,最大值 9999999999,最多保留 2 位小数 |
first_month_insurance_fee
|
float | 首月保费,大于等于 0,至多 2 位小数 最小值 0,最大值 9999999999,最多保留 2 位小数 |
max_quota
|
float | 最高额度,大于等于 0,至多 2 位小数 最小值 0,最大值 9999999999,最多保留 2 位小数 |
annualized_rate_of_return
|
float | 年化收益率,大于等于 0,至多 4 位小数 最小值 0,最大值 9999999999,最多保留 4 位小数 |
risk_type
|
enum | 风险等级类型,[枚举详情] 枚举列表:{ RISK_CONSERVATIVE, RISK_STEADY, RISK_BALANCE, RISK_RADICAL, RISK_OTHER } |
请求示例
curl 'https://api.e.qq.com/v1.1/product_items/add?access_token=<ACCESS_TOKEN>×tamp=<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"],"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","product_sale_status":"PRODUCT_SALE_STATUS_ONLINE","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}]'
应答字段
名称 | 类型 | 描述 |
---|---|---|
list
|
struct[] | 返回信息列表 |
product_id
|
string | 商品 id |
product_outer_id
|
string | 广告主商品 id |
应答示例
{
"code": 0,
"message": "",
"message_cn": "",
"data": {
"list": [
{
"product_id": 39526,
"product_outer_id": "xly_123"
}
]
}
}
可视化调试工具
问题仍未解决?
请前往腾讯广告反馈中心在线提交问题,我们的人工客服将为你服务