商品目录消息

概览

“房源”消息 (OTA_HotelInvCountNotifRQ) 用于定义可预订的特定房型的房源数量（实体客房数量）。发送“房源”消息时，您需要指明指定日期有多少相应类型的客房可供预订。如果没有相应类型的客房，则涉及该客房类型和日期的商品将不会显示。

以下部分介绍了常规指南、基本示例以及操作场景，可帮助您开始添加和更新商品目录并发送商品目录消息。

如需查看与各种广告资源相关的场景示例，请参阅操作指南。

必需元素和可选元素

XML 参考提供了必需元素和可选元素的说明。如需详细了解特性和子元素，请参阅目录元素和特性。

语法和架构

创建 Inventory 消息时，请参考库存语法示例，确保您遵循正确的格式。

您可以使用 xmllint 等第三方 XML 工具，在将 Feed 提交给 Google 之前，先使用已发布的架构验证 Feed。如需了解“库存”消息架构，请参阅酒店广告架构。

指南

对于 Inventory 消息，请遵循以下准则：

• 库存按酒店、日期和房型进行键控。

• 住宿期间所有晚上的房源数量都必须大于 0，才能显示相关房价方案和入住人数的价格。

• 如果房源数量等于 0，则无法预订指定客房 ID 和日期范围内的客房。

• CountType 必须始终具有 2 的值才能有效，因为它表示“确定有货”的数量。

• 每当您的系统中发生客房预订或取消时，都发送更新后的房源。

注意： 使用 OTA_HotelInvCountNotifRQ（推荐方法）或使用 OTA_HotelAvailNotifRQ 消息的 <BookingLimit> 属性的替代方法发送房间库存数量。

库存与供应情况

房源是指可预订的客房数量（基于实际数量），而供应情况则表示是否允许预订客房类型和价格方案的组合。对于 ARI，房源供应情况和房源都可以根据一组日期或住宿类型而有所不同，并且两者都有相应的消息类型。库存和空房情况按酒店、日期和房型进行键控，空房情况还按价格方案进行键控。

即使有广告资源，也可能出现“无库存状况”的情况，因为广告资源和库存状况是相互独立的。

可用性有两个概念。首先，是特定住宿时段内商品的总体供应情况，这会受到多种因素的影响，例如每晚是否都有明确的房价、相关房型的库存以及是否有开放的供应情况限制。其次，还有针对特定日期商品的具体限制，以 OTA_HotelAvailNotifRQ 中的 <RestrictionStatus Restriction="Master" Status="Open"/> 表示，关闭此可用性称为“停止销售”。

库存必须是大于 0 的整数，并且客房的预订限制必须处于开放状态，才能显示商品的价格。

注意： 如果客房已售罄，则与该客房关联的所有费率方案都将无法再销售。

示例

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

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

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

要点： 每当您的商品目录发生变化（例如出现预订和取消情况）时，请向 Google 发送更新后的商品目录消息。

对于 HotelCode，请使用您在系统中用于标识房源的唯一酒店 ID。此值必须与酒店列表 Feed 中使用 <listing> 元素内的 <id> 指定的酒店 ID 一致。对于 <RoomID>，请使用您在系统中用于房型的相同 ID。与您系统的一致性对于确保 Google 正确显示您的数据至关重要。

注意： <CountType=2> 是唯一有效的选项，因为它表示“确定有空房”的房源数量。

此示例展示了如何为 12 月的 13 间可预订客房设置广告资源：

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="13" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

如需查看更多示例，请参阅广告资源示例。

方法指南

本部分提供了一个您在发送 Inventory 消息时可能会遇到的场景。

场景：如何阻止预订会议室

说明

您需要指明，在特定日期范围内，此房型已无剩余客房可供预订，最常见的原因是客房已售罄。

解决方案

您将 <InvCount Count> 设置为 0 值，并添加所需的日期范围。

示例

此示例展示了如何使用 InvCount 将指定客房和日期（例如 1 月份的前几周）的房源设置为 0。

注意： 如果住宿期间的任何一晚，某个客房的房源数量为 0，则无法预订与该客房关联的任何产品。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-01-15"
                                InvTypeCode="ROOMID"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>