文档中心 > API类目 > 酒店商品API

taobao.xhotel.bnbpromo.update (民宿营销活动更新)

全量更新对应外部活动code相关的营销活动信息

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
update_promo_param UpdatePromoParam 必须 更新营销活动的入参
  • └ outer_activity_code
  • String
  • 可选
  • abc123abc
  • 外部营销活动的code,最长40个字符
  • promo_info
  • PromoInfo
  • 必须
  • 营销活动的具体参数对象,在每次添加更新的时候,long_order_info、early_booking_info、daily_booking_info 只能填1种类型,其他2种类型为空
  • long_order_info
  • LongOrderInfo
  • 可选
  • 连住优惠的入参
  • └ min_continuity_stay
  • Number
  • 可选
  • 3
  • 最小连住天数
  • └ investment_number
  • Number
  • 可选
  • 30
  • 折扣比例,填30就意味着原价的30%,也就是打3折。数字范围限定在10-95之间
  • early_booking_info
  • EarlyBookingInfo
  • 可选
  • 早定优惠的入参
  • └ min_pre_booking_days
  • Number
  • 可选
  • 3
  • 最少提前预定天数,数字范围限定在1-60
  • └ investment_number
  • Number
  • 可选
  • 30
  • 折扣比例,填30就意味着原价的30%,也就是打3折。数字范围限定在10-95之间
  • └ min_continuity_stay
  • Number
  • 可选
  • 2
  • 连住天数,可为空,范围1-60
  • daily_booking_info
  • DailyBookingInfo
  • 可选
  • 天天特惠的入参
  • └ valid_weeks
  • String []
  • 可选
  • [1,6]
  • 一个星期内有效性约束。1-7 对应周一到周日,传入的值比如[1,6],就表示星期一和星期六营销生效
  • └ check_in_from
  • Date
  • 可选
  • 2021-09-11 22:00:00
  • 可入住的起始时间,不填默认一年,一年后自动续期
  • └ check_in_to
  • Date
  • 可选
  • 2021-09-13 22:00:00
  • 可入住的结束时间,不填默认一年,一年后自动续期
  • └ investment_number
  • Number
  • 可选
  • 30
  • 折扣比例,填30就意味着原价的30%,也就是打3折。数字范围限定在10-95之间
  • invalid_dates
  • InvalidDate []
  • 可选
  • 不可用日期,开始日期和结束日期: from--to 只有一天的场景,from和to传同一天; 默认:空,代表无时间限制;
  • └ invalid_from
  • Date
  • 可选
  • 2021-09-11 00:00:00
  • 活动失效开始时间
  • └ invalid_to
  • Date
  • 可选
  • 2021-09-12 00:00:00
  • 活动失效结束时间
  • rate_infos
  • RateInfo []
  • 可选
  • 营销活动关联的价格计划和房型
  • └ rate_plan_code
  • String
  • 可选
  • 1224244
  • 外部价格计划code
  • └ out_rid
  • String
  • 可选
  • 1223445
  • 外部房型id

响应参数

名称 类型 示例值 描述
result ResultSet asdsad 查询结果集
  • └ error_code
  • String
  • 0
  • errorCode
  • └ error_msg
  • String
  • 0
  • errorMsg
  • └ success
  • Boolean
  • true
  • 是否成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
XhotelBnbpromoUpdateRequest req = new XhotelBnbpromoUpdateRequest();
XhotelBnbpromoUpdateRequest.UpdatePromoParam obj1 = new XhotelBnbpromoUpdateRequest.UpdatePromoParam();
obj1.setOuterActivityCode("abc123abc");
XhotelBnbpromoUpdateRequest.PromoInfo obj2 = new XhotelBnbpromoUpdateRequest.PromoInfo();
XhotelBnbpromoUpdateRequest.LongOrderInfo obj3 = new XhotelBnbpromoUpdateRequest.LongOrderInfo();
obj3.setMinContinuityStay(3L);
obj3.setInvestmentNumber(30L);
obj2.setLongOrderInfo(obj3);
XhotelBnbpromoUpdateRequest.EarlyBookingInfo obj4 = new XhotelBnbpromoUpdateRequest.EarlyBookingInfo();
obj4.setMinPreBookingDays(3L);
obj4.setInvestmentNumber(30L);
obj4.setMinContinuityStay(2L);
obj2.setEarlyBookingInfo(obj4);
XhotelBnbpromoUpdateRequest.DailyBookingInfo obj5 = new XhotelBnbpromoUpdateRequest.DailyBookingInfo();
obj5.setValidWeeks("1,6");
obj5.setCheckInFrom(StringUtils.parseDateTime("2021-09-11 22:00:00"));
obj5.setCheckInTo(StringUtils.parseDateTime("2021-09-13 22:00:00"));
obj5.setInvestmentNumber(30L);
List<XhotelBnbpromoUpdateRequest.InvalidDate> list7 = new ArrayList<XhotelBnbpromoUpdateRequest.InvalidDate>();
XhotelBnbpromoUpdateRequest.InvalidDate obj8 = new XhotelBnbpromoUpdateRequest.InvalidDate();
list7.add(obj8);
obj8.setInvalidFrom(StringUtils.parseDateTime("2021-09-11 00:00:00"));
obj8.setInvalidTo(StringUtils.parseDateTime("2021-09-12 00:00:00"));
obj5.setInvalidDates(list7);
obj2.setDailyBookingInfo(obj5);
obj1.setPromoInfo(obj2);
List<XhotelBnbpromoUpdateRequest.RateInfo> list10 = new ArrayList<XhotelBnbpromoUpdateRequest.RateInfo>();
XhotelBnbpromoUpdateRequest.RateInfo obj11 = new XhotelBnbpromoUpdateRequest.RateInfo();
list10.add(obj11);
obj11.setRatePlanCode("1224244");
obj11.setOutRid("1223445");
obj1.setRateInfos(list10);
req.setUpdatePromoParam(obj1);
XhotelBnbpromoUpdateResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<xhotel_bnbpromo_update_response>
    <result>
        <error_code>0</error_code>
        <error_msg>0</error_msg>
        <success>true</success>
    </result>
</xhotel_bnbpromo_update_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部