广告资源消息

概览

商品目录消息 (OTA_HotelInvCountNotifRQ) 指定了商品目录数量 可供特定会议室预订的（物理会议室数量） 。在发送房源/票源信息时 类型。如果没有该类型的会议室， 系统不会显示涉及该房间类型和日期的产品。

以下各部分涵盖一般指南、一个基本示例和具体方法 帮助您开始添加和更新广告资源并发送 商品目录消息。

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

必需元素和可选元素

XML 参考文档提供了必需元素和可选元素的说明。了解详情 请参见广告资源元素和 属性。

语法和架构

使用广告资源 语法示例 创建广告资源消息时参考，以确保您遵循 格式正确。

您可以使用第三方 XML 工具（如 xmllint）来验证 Feed， 将已发布的架构提交给 Google。对于广告资源 消息架构，请参阅酒店广告架构。

指南

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

• 房源/票源按酒店、日期和客房类型键控。

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

• 如果空房数量等于 0，则以下酒店将无法使用会议室 预订。

• CountType 的值必须始终为 2 才有效，因为它指示 统计“确切库存状况”

• 每当会议室被预订或取消时，都会发送更新后的产品目录 您体内的各种状况

。

注意 ：您可以使用 OTA_HotelInvCountNotifRQ （推荐方法）或使用 OTA_HotelAvailNotifRQ 消息的 <BookingLimit> 属性。

广告资源与可用性

“广告资源”是指根据实际客户数量和 “库存状况”表示客房类型和价格方案的组合 允许预订对于 ARI，可用性和广告资源可能也会因 特定日期或类型的住宿，并且两者都有对应的 消息类型。房源和空房情况按酒店、日期和客房类型设置键值，并在空房情况中添加了费率方案。

比如“没有空房”即使有广告资源也是如此 和可用性彼此独立

可用性有两个概念。第一种是整体可用性 某件商品在某次入住中获得的曝光率，受如下因素影响： 是否每晚都有指定的房价、相关客房类型的空房数量、 并且可用性限制处于开放状态其次 指定日期的商品限制，以 OTA_HotelAvailNotifRQ 中的 <RestrictionStatus Restriction="Master" Status="Open"/> 表示，结束 这种可用性称为“停止销售”

对于会议室和空房情况，房源/票源信息必须是大于 0 的整数 必须开放限制才能显示商品的价格。

注意 ：如果房间已售罄，则与该房间关联的任何价格方案都可以 无法再销售。

示例

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

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

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

要点 ：在您的商品目录中，每当有商品目录时，都向 Google 发送更新后的商品目录消息 更改，例如预订和取消的时间。

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

注意 ：<CountType=2> 是唯一有效的选项，因为它表示 “确切库存状况”

此示例展示了如何为 12 月：

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

如需更多示例，请参见广告资源 示例。

方法指南

本部分介绍了您在发送 商品目录消息。

场景：如何禁止他人预订会议室

说明

您需要指明特定日期没有可供预订的此类客房，最常见的原因是客房已售罄。

解决方案

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

示例

此示例展示了如何使用 InvCount 将广告资源设置为 0 （如 1 月的前几周）。

注意 ：如果入住一晚的客房库存数量为 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>