修改 Booking.com 优惠活动

修改某个 Booking.com 优惠活动的部分字段:折扣、名称、客群、最少入住、不可退款、入住日期与生效星期、附加日期、可预订日期与时段、最后一分钟或提前预订窗口、房型与价格计划。只改动你传入的字段,其余字段在 Booking.com 上保持不变,包括排除日期(用 POST /channel_accounts/booking/promotions/excluded_dates 修改)。rooms、parent_rates、additional_dates 与 stay_date.active_weekdays 是整列表替换。book_date: null 与 book_time: null 表示去掉对应限制;这需要使用 JSON 请求体,表单请求体分不清空值和 null(返回 400)。优惠类型不能修改。

  • Booking.com 每次更新成功都会把优惠设为启用,所以已停用的优惠会返回 409,除非你传 activate: true。
  • 部分优惠(如 new_property_deal)不能修改(409)。geo_rate 优惠只能改 discount,mobile_rate 优惠只能改 discount、target_channel 与 parent_rates,因为 Booking.com 不返回它们的其他字段;改其他字段返回 409。
  • 重发同样的请求是安全的。
  • 你的账号未开放新建与编辑优惠时返回 501(与 POST /channel_accounts/booking/promotions/excluded_dates 分开开放)。
  • 每个 Booking.com 住宿每分钟最多 10 次优惠写入,与 POST /channel_accounts/booking/promotions/excluded_dates 共用,此外仍受账号级限流约束;429 响应带有 Retry-After。
  • Booking.com 拒绝的取值返回 400,error_msg 中带有 Booking.com 错误码(如 DISCOUNT_NOT_IN_RANGE、ROOMS_INVALID、TARGET_CHANNEL_NO_ACCESS)。
  • 502 表示 Booking.com 暂时不可用或结果无法确认,改动仍可能在之后几分钟内生效。

需要可写的访问令牌。

Path Params
string
required

Booking.com 优惠活动 id,即 GET /channel_accounts/booking/promotions 返回的 promotions[].id。

Body Params
integer
required

Booking.com 渠道账号的 id,来自 GET /channel_accounts。一个 Booking.com 渠道账号对应一个 Booking.com 住宿;优惠活动属于住宿,而不是某个房型。

boolean
Defaults to false

Booking.com 每次更新成功都会把优惠设为启用。因此修改一条已停用的优惠会让它重新上线,除非你传 activate: true,否则会以 409 拒绝。对已启用的优惠没有影响。默认值:false。

string
length ≤ 255

优惠名称,最多 255 个字符。只在你的 Booking.com Extranet 中可见,客人看不到。

integer
1 to 99

新的折扣百分比,整数。取值范围取决于优惠类型,见 POST /channel_accounts/booking/promotions;超出范围时 Booking.com 返回 400。

string

优惠面向的客群。basic、last_minute、early_booker:public(默认)或 subscribers(Genius / 订阅会员)。mobile_rate:app(默认)或 all。geo_rate:Booking.com 的国家/地区渠道,必填;可从已有的 georate 优惠(GET /channel_accounts/booking/promotions)或 Booking.com Extranet 中照抄,并非每个住宿都能用所有国家/地区。`campaign*` 不使用。

integer
0 to 30

最少入住晚数。basic、last_minute、early_booker:0-30,0 表示沿用价格计划的最少入住,1 表示不限。geo_rate、mobile_rate:1-30。campaign_* 不使用。

boolean

为 true 时优惠只按不可退款条件提供。⚠️ 如果住宿还没有不可退款政策,Booking.com 会自动新建一个 3 天不可退款政策并套用。campaign_* 不使用。

stay_date
object

修改入住日期。start 与 end 要一起传,也可以只传 active_weekdays,或都传;没传的字段保持不变。排除日期不能在这里修改:请用 POST /channel_accounts/booking/promotions/excluded_dates。

additional_dates
array of dates

整列表替换附加入住日期。必须与 stay_date.start、stay_date.end 一起传,且每个日期都须在该区间之外。

additional_dates
book_date
object | null

新的可预订日期范围,传 null 表示去掉该限制。

book_time
object | null

新的可预订时段,传 null 表示去掉该限制。

last_minute
object

距入住多近时优惠开始可订。last_minute 必填(unit 为 hour 或 day,value 1-1000)。geo_rate 与 mobile_rate 在 last_minute(unit 必须为 day,value 1-365)和 early_booker 中最多传一个。

integer
1 to 500

客人需要提前多少天预订(early_booker:1-500;geo_rate / mobile_rate:1-365)。

rooms
array of strings

整列表替换优惠适用的 Booking.com 房型 id。请传完整列表;空列表会被拒绝。

rooms
parent_rates
array of strings

整列表替换优惠适用的 Booking.com 价格计划 id。请传完整列表;空列表会被拒绝。

parent_rates
Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json