拼多多Python版API

""" @author:menglei @desc:商品新增接口 """ from pdd.api.base import RestApi class PddGoodsAddRequest(RestApi): """ @:param: bad_fruit_claim:INTEGER:坏果包赔 @:param: buy_limit:LONG:限购次数 @:param: carousel_gallery:STRING[]:商品轮播图，按次序上传，图片格式支持JPEG/JPG/PNG， 图片尺寸长宽比1：1且尺寸不低于480px，图片大小最高1MB @:param: carousel_video:OBJECT[]:商品视频 @:param: file_id:LONG:商品视频id @:param: video_url:STRING:商品视频url @:param: carousel_video_url:STRING:轮播视频 @:param: cat_id:LONG:叶子类目ID @:param: cost_template_id:LONG:物流运费模板ID，可使用pdd.logistics.template.get获取 @:param: country_id:INTEGER:国家ID，country_id可以通过pdd.goods.country.get获取，仅在goods_type为2、3时（海淘商品）入参生效，其余goods_type传0 @:param: customer_num:LONG:团购人数 @:param: customs:STRING:海关名称，只在goods_type=3（直供商品）时入参且is_customs=true，入参枚举值为：广州、杭州、宁波、郑州、郑州(保税物流中心)、重庆、西安、上海、郑州(综保区)、深圳、福建、天津 @:param: delivery_one_day:INTEGER:是否当日发货,0 否，1 是 @:param: detail_gallery:STRING[]:商品详情图： a. 尺寸要求宽度处于480~1200px之间，高度0-1500px之间 b. 大小1M以内 c. 数量限制在20张之间 d. 图片格式仅支持JPG,PNG格式 e. 点击上传时，支持批量上传详情图 @:param: elec_goods_attributes:OBJECT:卡券类商品属性 @:param: begin_time:LONG:开始时间（timeType=1时必填表示核销的开始时间）（精确到毫秒） @:param: days_time:INTEGER:天数内有效（timeType=3必填，表示发货后几天内核销） @:param: end_time:LONG:截止时间（timeType=1,2时必填，表示发货后核销的截止时间）（精确到毫秒） @:param: time_type:INTEGER:卡券核销类型（1：起始时间内有效，2：发货后后至截止时间内有效，3：发货后多少天内有效） @:param: goods_desc:STRING:商品描述， 字数限制：20-500，例如，新包装，保证产品的口感和新鲜度。单颗独立小包装，双重营养，1斤家庭分享装，更实惠新疆一级骏枣夹核桃仁。 @:param: goods_name:STRING:商品标题，例如，新疆特产 红满疆枣夹核桃500g @:param: goods_properties:OBJECT[]:商品属性列表 @:param: group_id:INTEGER:组id，非销售属性不用传 @:param: img_url:STRING:图片url，非销售属性不用传 @:param: note:STRING:备注，非销售属性不用传 @:param: parent_spec_id:LONG:父属性id，非销售属性不用传 @:param: spec_id:LONG:属性id，非销售属性不用传 @:param: template_pid:LONG:模板属性id @:param: value:STRING:属性值 @:param: value_unit:STRING:属性单位 @:param: vid:LONG:属性值id @:param: ref_pid:LONG:引用属性ID @:param: goods_type:INTEGER:1-国内普通商品，2-进口，3-直供（保税），4-直邮 ,5-流量 ,6-话费 ,7-优惠券 ,8-QQ充值 ,9-加油卡，15-商家卡券，19-平台卡券 @:param: image_url:STRING:商品主图，请参考拼多多首页大图，如果商品参加部分活动则必填，否则无法参加活动 a. 尺寸750 x 352px b. 大小100k以内 c. 图片格式仅支持JPG,PNG格式 d. 图片背景应以纯白为主, 商品图案居中显示 e. 图片不可以添加任何品牌相关文字或logo @:param: invoice_status:BOOLEAN:是否支持开票（测试中） @:param: is_customs:BOOLEAN:是否需要上报海关，false-无需上报海关，true-需上报海关 @:param: is_folt:BOOLEAN:是否支持假一赔十，false-不支持，true-支持 @:param: is_pre_sale:BOOLEAN:是否预售,true-预售商品，false-非预售商品 @:param: is_refundable:BOOLEAN:是否7天无理由退换货，true-支持，false-不支持 @:param: lack_of_weight_claim:INTEGER:缺重包退 @:param: mai_jia_zi_ti:STRING:买家自提模版id @:param: market_price:LONG:市场价格，单位为分 @:param: order_limit:INTEGER:单次限量 @:param: origin_country_id:INTEGER:原产地id，是指海淘商品的生产地址，仅在goods type=3/4的时候必填，可以通过pdd.goods.country.get获取 @:param: out_goods_id:STRING:商品goods外部编码，同其他接口中的outer_goods_id 、out_goods_id、out_goods_sn、outer_goods_sn 都为商家编码（goods维度）。 @:param: oversea_goods:OBJECT:{ "consumption_tax_rate": 1, "value_added_tax_rate": 9, "hs_code": "2200", "customs_broker": "sss", "bonded_warehouse_key": "pp" } @:param: bonded_warehouse_key:STRING:保税仓唯一标识 @:param: consumption_tax_rate:INTEGER:消费税率 @:param: customs_broker:STRING:清关服务商 @:param: hs_code:STRING:海关编号 @:param: value_added_tax_rate:INTEGER:增值税率 @:param: oversea_type:INTEGER:oversea_type @:param: pre_sale_time:LONG:预售时间，is_pre_sale为true时必传，UNIX时间戳，只能为某一天的23:59:59 @:param: quan_guo_lian_bao:INTEGER:0：不支持全国联保；1：支持全国联保 @:param: second_hand:BOOLEAN:是否二手商品，true -二手商品 ，false-全新商品 @:param: shang_men_an_zhuang:STRING:上门安装模版id @:param: shipment_limit_second:LONG:承诺发货时间（ 秒），普通、进口商品可选48小时或24小时；直邮、直供商品只能入参120小时；is_pre_sale为true时不必传 @:param: sku_list:OBJECT[]:sku对象列表,实例：[{ "is_onsale": 1, "limit_quantity": 999, "price": "2200", "weight": 1000, "multi_price": "1900", "thumb_url": "http://t06img.yangkeduo.com/images/2018-04-15/ced035033b5d40b589140af882621c03.jpg", "out_sku_sn": "L", "quantity": 100, "spec_id_list": "[25]", "oversea_sku": { "measurement_code": "计量单位编码", "taxation": "税费", "specifications": "规格" } }] @:param: is_onsale:INTEGER:sku上架状态，0-已下架，1-上架中 @:param: length:LONG:sku送装参数：长度 @:param: limit_quantity:LONG:sku购买限制，只入参999 @:param: multi_price:LONG:商品团购价格 @:param: out_sku_sn:STRING:商品sku外部编码，同其他接口中的outer_id 、out_id、out_sku_sn、outer_sku_sn、out_sku_id、outer_sku_id 都为商家编码（sku维度）。 @:param: oversea_sku:OBJECT:oversea_sku @:param: measurement_code:STRING:计量单位编码，从接口pdd.gooods.sku.measurement.list获取code @:param: specifications:STRING:规格 @:param: taxation:INTEGER:税费 @:param: price:LONG:商品单买价格 @:param: quantity:LONG:商品sku库存初始数量，后续库存update只使用stocks.update接口进行调用 @:param: spec_id_list:STRING:商品规格列表，根据pdd.goods.spec.id.get生成的规格属性id，例如：颜色规格下商家新增白色和黑色，大小规格下商家新增L和XL，则由4种spec组合，入参一种组合即可，在skulist中需要有4个spec组合的sku，示例：[20,5] @:param: thumb_url:STRING:sku 缩略图 @:param: weight:LONG:重量，单位为g @:param: song_huo_an_zhuang:STRING:送货入户并安装模版id @:param: song_huo_ru_hu:STRING:送货入户模版id @:param: tiny_name:STRING:短标题，示例：新包装，保证产品的口感和新鲜度。单颗独立小包装，双重营养，1斤家庭分享装，更实惠新疆一级骏枣夹核桃仁。 @:param: warehouse:STRING:保税仓，只在goods_type=3（直供商品）时入参，入参枚举值为：宁波保税仓、杭州保税仓、广州保税仓、深圳保税仓、重庆保税仓、郑州�