添加商品

请求参数

标有*的参数为必填项

名称	类型	描述
account_id*	integer	广告主 id，有操作权限的广告主 id，如果已经升级了工作台，则填写 bm_id
product_catalog_id*	integer	商品库 id
feed_id	integer	商品文件 id
request_source	string	请求源字段长度最小 1 字节，长度最大 256 字节
product_item_spec_list*	struct[]	商品信息列表数组最大长度 50
product_outer_id*	string	广告主商品 id 字段长度最小 1 字节，长度最大 255 字节
product_name*	string	商品名称字段长度最小 1 字节，长度最大 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 字节
hidden_landing_img_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 字节
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，字段长度最小 1 字节，长度最大 2048 字节
second_category_url	string	二级分类 URL，字段长度最小 1 字节，长度最大 2048 字节
third_category_url	string	三级分类 URL，字段长度最小 1 字节，长度最大 2048 字节
fourth_category_url	string	四级分类 URL，字段长度最小 1 字节，长度最大 2048 字节
brand_id	integer	品牌 id
product_brand	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	是否网赚（是或者否），字段长度最小 1 字节，长度最大 100 字节
live_broadcast	string	是否直播，字段长度最小 1 字节，长度最大 100 字节
platform_attribute	string	平台属性，字段长度最小 1 字节，长度最大 100 字节
custom_data	string	商品自定义属性，字段长度最小 1 字节，长度最大 5000 字节
shooting_pic_count	integer	拍摄张数
fineedit_count	integer	精修张数
album_photo_count	integer	入册张数
album_count	integer	相册数量
frame_count	integer	相框数量
country	string	所在国家，字段长度最小 1 字节，长度最大 100 字节
province	string	所在省份/州/直辖市，字段长度最小 1 字节，长度最大 100 字节
city	string	所在城市，字段长度最小 1 字节，长度最大 100 字节
district	string	所在区县，字段长度最小 1 字节，长度最大 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 }
artist	string[]	艺人数组最大长度 100 字段长度最大 100 字节
trends	integer	热度，主要表明书籍在平台的热度，参考值包括在读人数、人气值等
pay_status	enum	书籍的付费状态，[枚举详情] 枚举列表：{ PAY_STATUS_FREE, PAY_STATUS_PAID, PAY_STATUS_MEMBER }
word_count	integer	小说字数
serial_status	enum	书籍的连载状态，[枚举详情] 枚举列表：{ SERIAL_STATUS_FINISH, SERIAL_STATUS_SERIALIZE }
book_json	struct	小说前 4 章内容，字段最大空间 10 万字节
chapters	struct[]	小说章节列表数组最大长度 4
subtitle	string	章节标题
chapterid	integer	章节 id, 最小值 1，最大值 4
text	string[]	章节内容
ratings	float	评分最小值 0，最大值 5，最多保留 2 位小数
reader_count	integer	在读人数
recommended_votes_count	integer	推荐数
reward_count	integer	打赏数
ranking	integer	排名
space	enum	小说篇幅，[枚举详情] 枚举列表：{ BOOK_LENGTH_LONG, BOOK_LENGTH_MIDDLE_LONG, BOOK_LENGTH_SHORT }
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	小说流派，用于描述小说的整体风格/派别 - 示例：甜宠文,女婿文,兵王文,神医文,乡村文,穿越文,修仙文字段长度最小 1 字节，长度最大 30 字节
story_role_identity	string	角色身份，- 小说主要人物身份 - 示例：总裁,兵王,赘婿,少爷,皇帝,王妃,摄政王,嫡女,医妃,公主 - 多个标签可用英文;隔开字段长度最小 1 字节，长度最大 30 字节
story_role_image	string	角色形象，小说主要人物形象 - 示例：花心,专情,萌系,玩世不恭,杀伐果断,腹黑,傲娇,霸道 - 多个标签可用英文;隔开字段长度最小 1 字节，长度最大 30 字节
story_era	string	时代背景，小说故事发生的时代背景 - 示例：现代,古代,穿越 - 多个标签可用英文;隔开字段长度最小 1 字节，长度最大 30 字节
story_scene	string	故事场景，小说故事发生的场景描述 - 示例：豪宅,医院,豪车,婚房,宴会,王府,皇宫,战场,深宫 - 多个标签可用英文;隔开字段长度最小 1 字节，长度最大 30 字节
story_plot	string	小说的故事情节描述 - 示例：豪门恩怨,逃婚,乡村爱情,失忆,一胎多宝,入赘豪门,复仇,车祸,破产 - 多个标签可用英文;隔开字段长度最小 1 字节，长度最大 30 字节
story_style	string	小说的风格描述 - 示例：情色,纯爱,搞笑,悲伤,温馨,爽文,苦恋,恐怖 - 多个标签可用英文;隔开字段长度最小 1 字节，长度最大 30 字节
authorization_status	enum	作品授权状态，[枚举详情] 枚举列表：{ AUTHORIZATION_STATUS_EXCLUSIVE, AUTHORIZATION_STATUS_NON_EXCLUSIVE }
originality	enum	作品原创性，[枚举详情] 枚举列表：{ ORIGINALITY_YES, ORIGINALITY_NO }
update_frequency	enum	更新频率，[枚举详情] 枚举列表：{ UPDATE_DAILY, UPDATE_WEEKLY, UPDATE_MULTI_WEEKLY, UPDATE_ONE_WEEK, UPDATE_MULTI_FORTNIGHT, UPDATE_MONTHLY, UPDATE_MULTI_MONTHLY, UPDATE_RANDOM }
play_form	enum	播讲形式，作品展现形式，主要用于音频类作品，[枚举详情] 枚举列表：{ PLAY_FORM_BY_ONE, PLAY_FORM_BY_TWO, PLAY_FORM_BY_MULTI }
play_author	string	播讲人，作品讲述者，主要用于音频类作品 - 示例：易中天,刘心武 - 多个标签可用英文;隔开字段长度最小 1 字节，长度最大 30 字节
play_voice	enum	作品配音，作品配音来源，主要用于音频类和漫画类作品，[枚举详情] 枚举列表：{ PLAY_VOICE_SYSTEM, PLAY_VOICE_NORMAL, PLAY_VOICE_PROFESSIONAL }
production_source	enum	内容来源，作品内容来源，主要用于音频类和漫画类作品，[枚举详情] 枚举列表：{ PRODUCTION_SOURCE_UGC, PRODUCTION_SOURCE_PGC, PRODUCTION_SOURCE_PUGC }
production_place	enum	内容产地，作品产地，主要用于漫画类作品，[枚举详情] 枚举列表：{ PRODUCTION_PLACE_JP, PRODUCTION_PLACE_RK, PRODUCTION_PLACE_US, PRODUCTION_PLACE_CN, PRODUCTION_PLACE_OTHER }
cartoon_color	enum	漫画色彩，作品产地，主要用于漫画类作品，[枚举详情] 枚举列表：{ CARTOON_COLOR_MULTI, CARTOON_COLOR_BLACK_WHITE }
max_quota_v2	enum	最高额度，[枚举详情] 枚举列表：{ MAX_QUOTA_5_LOW, MAX_QUOTA_10, MAX_QUOTA_15, MAX_QUOTA_20, MAX_QUOTA_30, MAX_QUOTA_50, MAX_QUOTA_100, MAX_QUOTA_300, MAX_QUOTA_300_HIGH }
standard_catalog_product_hash_id	integer	标品库商品 id
custom_url	string	自定义商品链接 1 字段长度最小 1 字节，长度最大 100 字节
additional_custom_url	string	自定义商品链接 2 字段长度最小 1 字节，长度最大 100 字节
product_barcode	string	商品条码字段长度最小 1 字节，长度最大 100 字节
business_price	enum	商务服务价格，[枚举详情] 枚举列表：{ BUSINESS_PRICE_FREE, BUSINESS_PRICE_1_TO_50, BUSINESS_PRICE_51_TO_100, BUSINESS_PRICE_101_TO_200, BUSINESS_PRICE_201_TO_1000, BUSINESS_PRICE_1001_TO_3000, BUSINESS_PRICE_3001_TO_5000, BUSINESS_PRICE_5001_TO_8000, BUSINESS_PRICE_8001_TO_12000, BUSINESS_PRICE_OUT_12000 }
initial_total_investment	enum	首次投资总额，[枚举详情] 枚举列表：{ INITIAL_TOTAL_INVESTMENT_FREE, INITIAL_TOTAL_INVESTMENT_IN_10W, INITIAL_TOTAL_INVESTMENT_10W_TO_30W, INITIAL_TOTAL_INVESTMENT_30W_TO_50W, INITIAL_TOTAL_INVESTMENT_50W_TO_100W, INITIAL_TOTAL_INVESTMENT_OUT_100W }
business_audience	enum	受众，[枚举详情] 枚举列表：{ BUSINESS_AUDIENCE_PERSONAL, BUSINESS_AUDIENCE_ENTERPRISE }

使用说明
1.
为提升数据上报文档阅读体验，相关文档将逐步迁移至 DataNexus。现邀请您抢鲜体验。

请求参数#

请求参数

返回响应

请求参数