空闲状态消息

概览

空房情况消息 (OTA_HotelAvailNotifRQ) 定义指定行程的商品（客房类型和费率方案）是否可以在适用日期内销售。发送库存状况消息时，您需要指明商品的库存状况或限制是否发生了变化。

要点 ：您也可以使用“库存状况”消息类型来更新商品目录，但首选方法是使用商品目录消息类型 (OTA_HotelInvCountNotifRQ)。

以下部分介绍了一般准则、基本示例和方法场景，帮助您开始使用可用性消息添加和更新可用性。

每晚可用性限制

借助可用性消息，您可以定义用于控制预订总体可用性的限制。一种值得注意的限制类型是“每晚库存状况”，即商品是否可以在特定日期销售。为了让某次住宿（从入住到退房）成为可预订状态，所有日期都必须提供每晚的空房信息，并且必须满足所有其他预订和住宿限制。

注意 ：如需详细了解“可用性”的概念以及“广告资源”与“可用性”之间的差异，请参阅广告资源与可用性。

限制设置

默认情况下，Restriction="Master" 的 RestrictionStatus 处于关闭状态。换句话说，默认情况下，每晚都有“停止出售”事件。

商品的所有住宿晚数组合都必须包含 <RestrictionStatus Restriction="Master" Status="Open">，才能销售。您必须为每个产品向 Google 发送明确的 Open，或者在 Hotel Center 中更改默认设置。为此，您可以前往 Hotel Center 中的定价 > 设置页面，然后修改“默认库存状况”字段。

其他限制

到达/出发

阻止销售在指定日期抵达或出发的行程。 默认为 Open。

预订偏移下限和上限

要求至少在到达目的地之前或最多提前特定天数购买行程。

最短和最长住宿晚数

限制具有此到达日期的行程的住宿晚数。

最短和最长入住天数（或“住宿晚数”）

限制包含此住宿日期的行程的住宿晚数。

住宿晚数模式

用于精确控制此入住日期允许的入住晚数。

通用指南

• 空房情况限制取决于酒店、日期、客房类型和费率方案。

• 仅当住宿（从入住到退房）没有施加任何限制或用户可以预订住宿时，商品才可供预订。

• 每当商品在特定日期的库存状况限制发生变化时，系统都会向 Google 发送库存状况消息更新。

示例

本部分提供了一个使用必需元素和可选元素的可用性消息的基本示例。准备好文件后，您需要通过向以下端点发送 POST 消息将其发送给 Google：

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

如需详细了解如何推送/POST 消息，请参阅推送消息。

要点 ：每当可用性发生变化时，请向 Google 发送更新的消息。

对于 HotelCode，请使用您在系统中使用的唯一酒店 ID 来识别房源。此值必须与酒店列表 Feed 的 <listing> 元素中使用 <id> 指定的酒店 ID 一致。与系统的一致性对于确保 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：如何在特定日期销售商品

说明

您希望在特定日期提供客房类型和费率方案组合（产品）。

注意 ：默认情况下，Google 将商品视为已启用“停止销售”（夜间库存状况已关闭），但您可以配置夜间可用性限制默认是开启还是关闭。您必须为每个产品向 Google 发送明确的 Open，或者在 Hotel Center 中更改默认设置。

解决方案

将 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>

注意： 每晚空房情况限制必须为 Open（且客房的空房数量必须是大于 0 的整数）才能显示商品的价格。

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

情形 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>