此页面由 Cloud Translation API 翻译。

空闲状态消息

概览

库存状况消息 (OTA_HotelAvailNotifRQ) 定义了商品（客房类型加价格方案）可按日期。发送“空闲情况”消息时，你需要指明商品的库存状况或限制发生了变化。

以下各部分涵盖一般指南、一个基本示例和具体方法帮助您开始使用空闲情况消息。

每晚可用性限制

借助“空房情况”消息，您可以定义用于控制预订整体空房情况的限制。一种值得注意的限制类型是 “夜间库存状况”：产品是否可以在特定日期销售。对于可供预订的住宿（从入住到退房），必须有每晚所有日期的空房情况，并且所有其他预订和住宿限制必须为符合。

限制设置

默认情况下，Restriction="Master" 的 RestrictionStatus 处于关闭状态。在其他系统就会默认使用“停止销售”选项。

一件商品必须在所有住宿晚数的所有商品组合中具有 <RestrictionStatus Restriction="Master" Status="Open"> 属性，商品才可供销售。您必须针对每个产品向 Google 发送明确的 Open，或更改默认设置为在 Hotel Center 中使用。为此，请转到 定价 >设置页面，然后修改“default” 库存状况”字段。

其他限制

到达/出发航班: 防止销售指定日期到达或出发的行程。默认值为 Open。
最短和最长预订抵消量: 要求行程必须在抵达前至少或最多购买特定天数。
最短和最长住宿晚数: 针对包含此到达日期的行程限制住宿晚数。
最短和最长向前入住天数（或“过夜入住”）: 限制包含此住宿日期的行程的住宿晚数。
住宿晚数模式: 精确控制此到达日期允许的住宿晚数。

常规指南

空房情况限制取决于酒店、日期、客房类型和价格方案。
仅当商品没有适用的限制条件时，才可以预订入住日期（从入住到退房）或用户可以预订住宿的时间。
当可用性有变化时，向 Google 发送可用性消息更新商品在特定日期的库存状况限制。

示例

本部分提供了一个使用必需和可选元素的基本播出信息消息示例。准备好文件后，需要将其发送至 Google 通过 POST 消息发送到此端点：

https://www.google.com/travel/hotels/uploads/ota/hotel_avail_notif

要详细了解如何推送/发布消息，请参阅推送消息。

对于 HotelCode，请使用您在系统中用于来标识该媒体资源此值必须与使用 <listing> 元素中的 <id>，酒店列表 Feed。与系统的一致性对于确保 Google 能够正确显示您的数据。

以下示例展示了如何设置可用性限制：

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <AvailStatusMessages HotelCode="HOTELID">
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="202X-03-20"
                                End="202X-03-25"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay MinMaxMessageType="SetMinLOS" Time="2" TimeUnit="Day" />
      </LengthsOfStay>
      <RestrictionStatus Restriction="Master" Status="Open" />
    </AvailStatusMessage>
</OTA_HotelAvailNotifRQ>

如需查看更多示例，请参阅可用性示例。

方法指南

本部分针对您在发送信息时可能遇到的情景提供了解决方案。空闲情况消息，特别是有关每晚空闲情况的详细信息（也称为“停止销售”）。

场景 1：如何在特定日期销售商品

说明

您想在以下位置启用客房类型和价格方案组合（产品）特定日期。

解决方案

将 Master 限制设置为 Open 并指定日期。

示例

此示例展示了如何在 3 月的几周内为商品开启每晚空房情况。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-03-20"
                                End="2022-03-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

如需详细了解如何设置价格，请参阅排查缺失或价格不完整。

场景 2：如何在特定日期停止销售商品

说明

您明确希望在特定日期停止销售某件商品（而非商品缺货）。

解决方案

将 Master 限制设置为 Close 并指定日期。

示例

此示例展示了如何“停止销售” 商品。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-04-20"
                                End="2022-04-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>