广告资源消息

概览

房源消息 (OTA_HotelInvCountNotifRQ) 定义可供特定客房类型预订的空房数量（实体房间数量）。在发送 Inventory 消息时，需指明在给定日期内该类型的客房数量。如果没有该类型的客房，则不会显示涉及该房间类型和日期的产品。

以下各部分介绍了一般准则、基本示例和方法场景，帮助您开始添加和更新商品目录以及发送 Inventory 消息。

如需查看与目录相关的各种场景的示例，请参阅方法指南。

必需元素和可选元素

XML 参考文档提供了必需元素和可选元素的说明。如需详细了解属性和子元素，请参阅 Inventory 元素和属性。

语法和架构

创建 Inventory 消息时，可参考 Inventory 语法示例作为参考，以确保采用正确的格式。

在将 Feed 提交给 Google 之前，您可以使用第三方 XML 工具（如 xmllint）使用已发布的架构来验证这些 Feed。如需了解商品目录消息架构，请参阅酒店广告架构。

指南

对于商品目录消息，请遵循以下准则：

• 空房数量取决于酒店、日期和客房类型。

• 入住所有住宿晚数的空房数量必须大于 0，才能显示相关费率方案和入住人数的价格。

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

• CountType 必须始终具有 2 值才有效，因为它表示“确定可用性”计数。

• 每当系统中出现会议室预订或取消预订时，发送更新后的房源。

注意 ：请使用 OTA_HotelInvCountNotifRQ（推荐方法）或备用方法（使用 OTA_HotelAvailNotifRQ 消息的 <BookingLimit> 属性）发送客房空房数量。

商品目录与库存状况

空房数量是指基于实际数量的可预订房间数量，可用性指示是否允许预订客房类型和费率方案的组合。对于 ARI，空房情况和空房情况可能因一组日期或住宿类型而异，并且两者都有相应的消息类型。空房情况和空房情况取决于酒店、日期和客房类型，同时还添加了针对空房情况的费率方案。

即使有商品目录，也可能出现“无可用情况”，因为商品目录和库存状况彼此独立。

可用性有两个概念。首先，产品在给定入住期间的整体库存状况受以下因素影响：每晚是否都有定义的费率、相关客房类型的空房数量，以及可用性限制是否开启等因素。其次，商品在给定日期具有特定限制，在 OTA_HotelAvailNotifRQ 中用 <RestrictionStatus Restriction="Master" Status="Open"/> 表示，关闭此库存称为“停售”。

客房的空房数量必须是大于 0 的整数，并且空房情况限制必须处于开放状态，才能显示商品价格。

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

示例

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

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

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

要点 ：每当商品目录发生变化时（例如发生预订和取消），向 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>