您所在位置: 首页 > > 商品API
  • gome.goods.product.add添加产品的基本信息(旧)

  • 简要描述
  • 系统级输入参数
  • 应用级输入参数
  • 请求示例
  • 返回结果参数
  • 返回示例
  • 异常码
  • 系统级异常码
  • API工具
  • 名称 类型 必须 描述
    $app String 应用的app_key
    $method String API接口名称
    $sign String 签名
    $token String 采用OAuth授权方式为必填参数
    $v String API协议版本,可选值:1.0.0
  • 名称 类型 必须 示例值 描述
    goods String 情况一:如果templateId输入的是0,1,2,3,goods还是按照原来的要求来填写如:outId~P901,color~红色,goodsAnxl~1||2||3||4||5,sell_price~99,goods_version~3.5,goods_tax~0.13,stock~100,tmp_bar_code~131313,image~http://www.cdntaobao.com/1.jpg||http://www.cdntaobao.com/2.jpg,pros~cpjtSpec_property_3=大卡||cpjtSpec_property_2=2*2cm;outId~P902,color~蓝色,goodsAnxl~1||2||3||4||5,sell_price~876,goods_version~2.5,stock~200,tmp_bar_code~231511,image~http://www.cdntaobao.com/3.jpg||http://www.cdntaobao.com/4.jpg,pros~T31_58=8-40个||S8_85=30升及以上。 情况二:如果templateId输入的是4,即销售属性,需要按照下面规范来填写:outId~bht220,goodsProp~c80c62c4448d:H||8ac55c9d2cf8:蓝色,goodsAnxl~1||2||3||4||5,sell_price~100,goods_tax~0.13,stock~100,image~http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg; 其中goodsProp为销售属性标识,c80c62c4448d:H分别为销售属性id和值,对于多个id和值的情况,用||分开,goodsAnxl代表安迅代储需要的长(cm)、高(cm)、宽(cm)、毛重(kg)、保质期天数,用||分开。invoiceType支持的发票类型,支持多种组合非必输 1:电子普票 2:纸质普票 3:增值税专用,默认1,2 商品信息(如果tmp_bar_code[条形码]输入项不为空,条形码限制为不超过18位字符,只能为数字)
    catalogId String cat18000340 商城分类ID,商品三级分类ID
    shopCtgyId String 292056;222085;130188 店铺分类ID,多个按分号分隔。
    brandId String 19106 商品品牌ID
    productName String 商品名称
    description String 这是一件商品 商品描述
    unit String 计量单位
    packingList String 包装清单
    saleService String 售后服务
    templateId String 3 模板id(和goods中的颜色尺码相关联,只能输入0或1或2或3或4;templateId为0时代表无颜色无版本,为1时代表有颜色无版本,为2时代表无颜色有版本,为3时代表有颜色有版本,为4时代表销售属性)
    props String S1111_11572=其他_,S1111_10238=其他_,T1092_10495=OL通勤_,T1092_10156=其他_,T1092_10664=其他_,T1092_11077=长裙_,T1092_11137=短袖_,T1092_10238=150_ 数据来自于gome.goods.itemProps.get根据子类目id获得子类目属性信息;属性串(格式为key=value,多个属性用英文逗号隔开,属性值长度不超过150个字符,如果属性值value是复选,多个值之间用“#@#”分隔,例如:fuZhuangSpec_property_5=400ml以下@#50升-80升#@#50升以上
    gift String 降 价 促 销 广告语
    keyWord String 液晶电视,电视,创维液晶电视 搜索关健词,长度限制128个字符,以英文逗号分隔
    propTempletId String fuZhuangSpec 商品模板ID
    freightTempletId String 运费模板ID(非必输,不填默认去店铺的默认运费模板)
    mobileDescription String 手机简介内容
    productAnxl String 安迅代储产品级,非必输
  • Java


    GmosClient client = new DefaultGmosClient(url, appKey, secret, token);
    GomeGoodsProductAddRequest request = new GomeGoodsProductAddRequest();
      //详细参数信息请参考API详情页面。
        request.setGoods("情况一:如果templateId输入的是0,1,2,3,goods还是按照原来的要求来填写如:outId~P901,color~红色,goodsAnxl~1||2||3||4||5,sell_price~99,goods_version~3.5,goods_tax~0.13,stock~100,tmp_bar_code~131313,image~http://www.cdntaobao.com/1.jpg||http://www.cdntaobao.com/2.jpg,pros~cpjtSpec_property_3=大卡||cpjtSpec_property_2=2*2cm;outId~P902,color~蓝色,goodsAnxl~1||2||3||4||5,sell_price~876,goods_version~2.5,stock~200,tmp_bar_code~231511,image~http://www.cdntaobao.com/3.jpg||http://www.cdntaobao.com/4.jpg,pros~T31_58=8-40个||S8_85=30升及以上。 情况二:如果templateId输入的是4,即销售属性,需要按照下面规范来填写:outId~bht220,goodsProp~c80c62c4448d:H||8ac55c9d2cf8:蓝色,goodsAnxl~1||2||3||4||5,sell_price~100,goods_tax~0.13,stock~100,image~http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg; 其中goodsProp为销售属性标识,c80c62c4448d:H分别为销售属性id和值,对于多个id和值的情况,用||分开,goodsAnxl代表安迅代储需要的长(cm)、高(cm)、宽(cm)、毛重(kg)、保质期天数,用||分开。invoiceType支持的发票类型,支持多种组合非必输 1:电子普票 2:纸质普票 3:增值税专用,默认1,2");
        request.setCatalogId("cat18000340");
        request.setShopCtgyId("292056;222085;130188");
        request.setBrandId("19106");
        request.setProductName("");
        request.setDescription("这是一件商品");
        request.setUnit("件");
        request.setPackingList("");
        request.setSaleService("");
        request.setTemplateId("3");
        request.setProps("S1111_11572=其他_,S1111_10238=其他_,T1092_10495=OL通勤_,T1092_10156=其他_,T1092_10664=其他_,T1092_11077=长裙_,T1092_11137=短袖_,T1092_10238=150_");
        request.setGift("降 价 促 销");
        request.setKeyWord("液晶电视,电视,创维液晶电视");
        request.setPropTempletId("fuZhuangSpec");
        request.setFreightTempletId("");
        request.setMobileDescription("");
        request.setProductAnxl("");
    GomeGoodsProductAddResponse response = client.execute(request);
    System.out.println(response.getBody());


    PHP


    require_once('GmosSdk.php');
    
    $client = new GmosClient;
      $client -> appkey = "";
      $client -> secretKey = "";
      $client -> session = "";
      $client -> gatewayUrl = "";
    
      $request = new GomeGoodsProductAddRequest;
      //详细参数信息请参考API详情页面。
        $request -> setGoods("情况一:如果templateId输入的是0,1,2,3,goods还是按照原来的要求来填写如:outId~P901,color~红色,goodsAnxl~1||2||3||4||5,sell_price~99,goods_version~3.5,goods_tax~0.13,stock~100,tmp_bar_code~131313,image~http://www.cdntaobao.com/1.jpg||http://www.cdntaobao.com/2.jpg,pros~cpjtSpec_property_3=大卡||cpjtSpec_property_2=2*2cm;outId~P902,color~蓝色,goodsAnxl~1||2||3||4||5,sell_price~876,goods_version~2.5,stock~200,tmp_bar_code~231511,image~http://www.cdntaobao.com/3.jpg||http://www.cdntaobao.com/4.jpg,pros~T31_58=8-40个||S8_85=30升及以上。 情况二:如果templateId输入的是4,即销售属性,需要按照下面规范来填写:outId~bht220,goodsProp~c80c62c4448d:H||8ac55c9d2cf8:蓝色,goodsAnxl~1||2||3||4||5,sell_price~100,goods_tax~0.13,stock~100,image~http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg; 其中goodsProp为销售属性标识,c80c62c4448d:H分别为销售属性id和值,对于多个id和值的情况,用||分开,goodsAnxl代表安迅代储需要的长(cm)、高(cm)、宽(cm)、毛重(kg)、保质期天数,用||分开。invoiceType支持的发票类型,支持多种组合非必输 1:电子普票 2:纸质普票 3:增值税专用,默认1,2");
        $request -> setCatalogId("cat18000340");
        $request -> setShopCtgyId("292056;222085;130188");
        $request -> setBrandId("19106");
        $request -> setProductName("");
        $request -> setDescription("这是一件商品");
        $request -> setUnit("件");
        $request -> setPackingList("");
        $request -> setSaleService("");
        $request -> setTemplateId("3");
        $request -> setProps("S1111_11572=其他_,S1111_10238=其他_,T1092_10495=OL通勤_,T1092_10156=其他_,T1092_10664=其他_,T1092_11077=长裙_,T1092_11137=短袖_,T1092_10238=150_");
        $request -> setGift("降 价 促 销");
        $request -> setKeyWord("液晶电视,电视,创维液晶电视");
        $request -> setPropTempletId("fuZhuangSpec");
        $request -> setFreightTempletId("");
        $request -> setMobileDescription("");
        $request -> setProductAnxl("");
    $response = $client -> execute($request);


    Net


    IGmosClient client = new DefaultGmosClient(url, appKey, secret, token);
    GomeGoodsProductAddRequest request = new GomeGoodsProductAddRequest();
    
    request.Goods="情况一:如果templateId输入的是0,1,2,3,goods还是按照原来的要求来填写如:outId~P901,color~红色,goodsAnxl~1||2||3||4||5,sell_price~99,goods_version~3.5,goods_tax~0.13,stock~100,tmp_bar_code~131313,image~http://www.cdntaobao.com/1.jpg||http://www.cdntaobao.com/2.jpg,pros~cpjtSpec_property_3=大卡||cpjtSpec_property_2=2*2cm;outId~P902,color~蓝色,goodsAnxl~1||2||3||4||5,sell_price~876,goods_version~2.5,stock~200,tmp_bar_code~231511,image~http://www.cdntaobao.com/3.jpg||http://www.cdntaobao.com/4.jpg,pros~T31_58=8-40个||S8_85=30升及以上。 情况二:如果templateId输入的是4,即销售属性,需要按照下面规范来填写:outId~bht220,goodsProp~c80c62c4448d:H||8ac55c9d2cf8:蓝色,goodsAnxl~1||2||3||4||5,sell_price~100,goods_tax~0.13,stock~100,image~http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg||http://img3.gomeprelive.net.cn/image/bbcimg/production_image/nimg/201604/28/17/18/332369474a5918844b_800.jpg; 其中goodsProp为销售属性标识,c80c62c4448d:H分别为销售属性id和值,对于多个id和值的情况,用||分开,goodsAnxl代表安迅代储需要的长(cm)、高(cm)、宽(cm)、毛重(kg)、保质期天数,用||分开。invoiceType支持的发票类型,支持多种组合非必输 1:电子普票 2:纸质普票 3:增值税专用,默认1,2";
    request.CatalogId="cat18000340";
    request.ShopCtgyId="292056;222085;130188";
    request.BrandId="19106";
    request.ProductName="";
    request.Description="这是一件商品";
    request.Unit="件";
    request.PackingList="";
    request.SaleService="";
    request.TemplateId="3";
    request.Props="S1111_11572=其他_,S1111_10238=其他_,T1092_10495=OL通勤_,T1092_10156=其他_,T1092_10664=其他_,T1092_11077=长裙_,T1092_11137=短袖_,T1092_10238=150_";
    request.Gift="降 价 促 销";
    request.KeyWord="液晶电视,电视,创维液晶电视";
    request.PropTempletId="fuZhuangSpec";
    request.FreightTempletId="";
    request.MobileDescription="";
    request.ProductAnxl="";
    
    GomeGoodsProductAddResponse response = client.Execute(request);
  • 错误码 错误消息
  • 错误码 错误消息
    10001 系统错误
    10002 方法调用次数超限
    10003 当前版本的方法不存在,请检查
    10004 缺少版本参数,请指定服务方法的版本号
    10005 该应用在当前IP下禁止访问
    8224 缺少签名参数,请添加签名请求参数
    8999 存在重复的请求,请在90秒之后再请求第二次
    8225 签名无效,请按正确的算法对请求数据进行签名
    9000 字段%s不能为空
    8249 超过上传限制
    8223 无效的appKey,请使用合法的appKey(由服务提供商授予你)
    8239 需要传递accessToken参数
    8222 缺少appKey,请向服务端获取合法的appKey
    20001 令牌已过期