API接口目录

广告业务

商品推广API
广告API
效果报表API
线下广告API
账号API
站外广告API
人群包API
异常码自查工具
suning.advertise.promotionunit.modify 商品推广单元修改
¥免费

通过此接口修改生意通商品推广单元 1、判断推广单元ID和商家编码是否存在,如果不存在则异常返回,如果存在则更新推广单元数据 2、根据推广单元状态以及推广单元所属计划状态判断是否要将推广单元数据发送到投放引擎 4、返回处理结果

公共参数
请求参数
名称 类型 是否必须 示例值 描述
promotionUnitIdStringY20160621011推广单元ID
goodsCodeStringY000000000102276549苏宁商品编码(长度:18位)
goodsUrlStringYhttp://uimgpre.cnsuning.com/uimg/b2c/newcatentries/0000000000-000000000102276549_1_200x200.jpg商品图片链接
unitDetailStringN
keyWordCataLogStringY全棉夏凉被添加关键词(最多添加50个)或添加类目(最多添加10个)
priceStringY10关键词\类目对应的出价(单位:分)
typeStringY0添加类型:0:关键词 1:类目
响应参数
名称 类型 示例值 描述
resultStringY是否成功: Y成功 N失败
请求示例
  • XML示例
  • JSON示例
复制全部代码
                                <sn_request>
  <sn_body>
    <modifyPromotionUnit>
      <goodsUrl>http://uimgpre.cnsuning.com/uimg/b2c/newcatentries/0000000000-000000000102276549_1_200x200.jpg</goodsUrl>
      <promotionUnitId>20160621011</promotionUnitId>
      <goodsCode>000000000102276549</goodsCode>
      <unitDetail>
        <keyWordCataLog>全棉夏凉被</keyWordCataLog>
        <price>10</price>
        <type>0</type>
      </unitDetail>
    </modifyPromotionUnit>
  </sn_body>
</sn_request>

                                
                                {
  "sn_request": {
    "sn_body": {
      "modifyPromotionUnit": {
        "goodsUrl": "http://uimgpre.cnsuning.com/uimg/b2c/newcatentries/0000000000-000000000102276549_1_200x200.jpg",
        "promotionUnitId": "20160621011",
        "goodsCode": "000000000102276549",
        "unitDetail": {
          "keyWordCataLog": "全棉夏凉被",
          "price": "10",
          "type": "0"
        }
      }
    }
  }
}
                                
响应示例
  • XML示例
  • JSON示例
复制全部代码
                              <sn_responseContent>
  <sn_body>
    <modifyPromotionUnit>
      <result>Y</result>
    </modifyPromotionUnit>
  </sn_body>
</sn_responseContent>

                              
                              {
  "sn_responseContent": {
    "sn_body": {
      "modifyPromotionUnit": {
        "result": "Y"
      }
    }
  }
}
                              
异常示例
  • XML示例
  • JSON示例
复制全部代码

  
  	API异常码
  	异常码中文描述
  

                           	  
{
  "sn_responseContent": {
    "sn_error": {
      "error_code": "API异常码",
      "error_msg": "异常码中文描述"
    }
  }
}
                           		
业务异常码
异常码 错误描述 解决方案
biz.advertise.modifypromotionunit.missing-parameter:* 缺少必填参数,*表示字段名 请输入正确参数。
isp.sys.service.unavailable.apsop 服务不可用(系统异常) 请联系苏宁技术人员。
biz.advertise.modifypromotionunit.invalid-biz:100 输入参数格式不正确 请输入正确参数。
biz.advertise.modifypromotionunit.invalid-biz:101 推广单元所属的推广计划不存在 请重新选择其他推广计划下的推广单元
biz.advertise.modifypromotionunit.invalid-biz:102 推广单元不存在 请传入正确的推广单元ID
biz.advertise.modifypromotionunit.invalid-biz:103 商家编码不存在 请联系苏宁技术人员。
biz.advertise.modifypromotionunit.invalid-biz:104 推广单元所属推广计划已完成推广,不可修改 请重新选择其他推广计划下的推广单元
biz.advertise.modifypromotionunit.invalid-biz:105 商品图片和关键词类目详情为空 请输入商品图片地址和关键词类目详情
biz.advertise.modifypromotionunit.invalid-biz:106 关键词类目详情个数超过50个 关键词类目详情个数不得超过50个
biz.advertise.modifypromotionunit.invalid-biz:107 商品图片有误 请重新输入商品图片
biz.advertise.modifypromotionunit.invalid-biz:108 类目格式错误 请重新添加关键词类目
biz.advertise.modifypromotionunit.invalid-biz:109 关键词类目出价大于推广计划日预算 请重新添加关键词类目出价
公共异常码
API工具
FAQ