空房情况、费率和库存 (ARI) XML 参考

本 XML 参考指南为“空房情况”、“费率”和“空房库存”(ARI) Feed 中的不同消息、元素和属性提供了详细的参考内容和代码示例。

ARI 是一种价格传送模式，可控制每晚费率、空房情况和空房数量，并就如何组合使用施加了限制。ARI 还可让您灵活地包含税费、费用和促销活动。

对于用于定义可用性和空房情况的某些主要消息类型，ARI 遵循 OpenTravel Alliance (OTA) 的标准协议。

基于 LOS 的价格

借助 LOS-based 定价，您可以按入住日期和住宿晚数（而不是按入住日期）指定费率。当您为基于 LOS 的价格指定 <StatusApplicationControl> 元素时，@Start 和 @End 属性表示适用 LOS 费率的入住日期范围。

虽然使用基于 LOS 的定价时，系统不再采用每晚费率，但所有其他 ARI 功能（空房情况、规则、促销等）仍可应用于这些费率，并且是在每晚级别指定。这意味着，如果您的系统更贴近基于 LOS 的定价系统，那么除了利用每晚可用性和限制更新提供的带宽效率外，您仍然可以利用丰富的 ARI 功能集。

要点 ：您帐号中的每项房源都应使用基于 LOS 的费率或按日期计费的费率。

如需为您的帐号启用基于 LOS 的价格，请与您的 TAM 或与我们联系。

要点 ：您必须先发送四种消息类型（交易、费率、广告资源和库存状况），然后才能提供价格。建议您将 ARI 消息的大小专门 <OTA_HotelRateAmountNotifRQ> 设置为 5MB，并将上传速率限制为每秒 400 个文件。

ARI 使用以下请求消息：

• Transaction（媒体资源数据）。定义类型和套餐（费率方案）信息。

• OTA_HotelRateAmountNotifRQ：定义特定日期范围内每种产品（客房类型和费率方案组合）按日期或基于 LOS 的入住率金额。

• OTA_HotelAvailNotifRQ：根据客房类型和费率方案定义空房情况和限制。您也可以使用此消息更新空房情况，但首选 OTA_HotelInvCountNotifRQ。

• OTA_HotelInvCountNotifRQ：定义实际房间库存或可供销售的房间数量。

• TaxFeeInfo。（可选）定义每个媒体资源的税费及其他费用。如果 OTA_HotelRateAmountNotifRQ 消息中指定了 AmountAfterTax，则此消息不需要。

• Promotions。（可选）定义特定预订、住宿和用户的促销费率。

• RateModifications。（可选）定义特定预订、住宿和用户的费率修改规则。

• ExtraGuestCharges：（可选）定义如何为儿童和其他成人配置费率。

每条消息都包含一部分信息，Google 会使用这些信息来计算用户搜索您的房源有特定入住/退房日期及入住人数的价格和空房情况时向其显示的价格和空房情况。

要点 ：ARI 功能仅限于此商品目录和定价 (ARI) XML 参考文档以及 ARI 指南中所述的消息和元素。我们的 ARI 实现不支持此处未明确记录的 OTA 消息、元素或属性。

此外，使用 ARI Feed 类型时，此商品目录和定价 (ARI) XML 参考文档中未涵盖的其他交易消息元素不受支持。

Google 会持续更新和改进该 API。如果您在系统中使用了其他定价功能，请通知您的 Technology Account Manager(TAM)，以便优先使用这些功能，或者告知他们是否已计划发布这些功能。

ARI XML 参考修订历史记录

下表列出了仅功能变更的文档更新。

日期	变更
2020 年 8 月 14 日	初始版本。
2020 年 10 月 21 日	添加了促销消息类型。
2020 年 11 月 17 日	对于交易（房源数据）消息，更新了端点并向 PropertyDataSet 元素添加了 action 属性。
2020 年 11 月 24 日	对于交易（房源数据）消息，添加了 <AllowablePackageIDs> 和 <AllowableRoomIDs> 元素。
2021 年 2 月 4 日	添加了响应消息。
2021 年 2 月 25 日	添加了 OTA_HotelInvCountNotifRQ。
2020 年 10 月 21 日	添加了“费率修改”消息类型。