ARI 概览

“库存状况、费率和空房库存 (ARI)”是一种价格传送模式，用于控制每晚费率、空房情况和空房数量，并对这些内容的组合方式施加了限制。ARI 还可让您灵活地包含税费、费用和促销活动。

与基于行程的价格交付模式（拉取和价格更改）不同，系统不会针对具体价格或行程查询 ARI Feed。相反，您可以在价格模式出现新数据或更改数据（例如费率详情、限制和可用性更改）时推送消息。

优势

ARI 具有以下优势：

  • 带宽效率：减少需要传输的数据量，从而提高带宽效率。通过发送每晚 ARI 数据和仅增量更改，Google 可以计算各种提前预订和住宿晚数值的价格和更新。

  • 价格准确性：使用变化后推送事件模型提供实时更新，从而提高价格准确性。

  • 价格覆盖率更高：通过使用已合并到各种行程的精细数据来实现更高的价格覆盖率（包含价格的行程数量）。

  • 灵活性：在提供促销活动和套餐方面实现更大的灵活性。

  • 易于使用：以适合数据在系统中的存储方式传输数据，避免计算或缓存许多行程的价格。

请求消息类型

发送给 Google 的 ARI 消息称为 ARI“请求”消息。随后，Google 会返回指示成功或失败的“响应”消息。

对于一些主要消息类型，ARI 遵循 OpenTravel Alliance (OTA) 的标准协议来定义可用性和目录。

ARI 使用以下请求消息：

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

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

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

  • OTA_HotelInvCountNotifRQ：定义实体房间库存或可供出售的客房数量。

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

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

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

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

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

如需详细了解 ARI，请参阅 XML 参考文档。

推送消息

如需更新 ARI 和属性信息，请在系统中的数据发生变化时发送关联的消息。

在发送邮件时，请遵循以下准则：

  • 使用 Hotel Center 价格设置页面中的自助工具，在我们的系统中添加或更新 IP 地址。

  • 对端点使用以下基本路径：

    • https://www.google.com 或 Host: www.google.com Port: 443

  • 使用 HTTP POST 方法发送消息。

  • 将 Content-Type 标头设置为 application/xml。

  • 帐号级更新速率上限为每秒 400 条消息。 如果超出此限制，系统会返回错误代码 6032。

  • 根据要更新的数据，使用以下路径：

    • Transaction（媒体资源数据）：/travel/hotels/uploads/property_data
    • OTA_HotelRateAmountNotifRQ：/travel/hotels/uploads/ota/hotel_rate_amount_notif
    • OTA_HotelAvailNotifRQ：/travel/hotels/uploads/ota/hotel_avail_notif
    • OTA_HotelInvCountNotifRQ：/travel/hotels/uploads/ota/hotel_inv_count_notif
    • TaxFeeInfo：/travel/hotels/uploads/taxes
    • Promotions：/travel/hotels/uploads/promotions
    • RateModifications：/travel/hotels/uploads/rate_modifications
    • ExtraGuestCharges:/travel/hotels/uploads/extra_guest_charges

对于收到的每条请求消息，如果成功连接到服务器，Google 会使用 HTTP 200 OK 进行响应，并在正文中包含一条响应消息，表明更新是已成功应用还是遇到了警告或错误。如果 Google 返回 HTTP 错误代码，请重新发送该消息。如果 HTTP 响应正文包含警告或错误，应在重新发送消息之前予以修复。您还可以在 Hotel Center 的“Feed 状态”页面上查看特定消息遇到的问题。

在 Google 上发布 (LoG)

借助在 Google 上发布 (LoG)，您可以在 Google 网站上展示您的酒店。 由于酒店的默认 LoG 值为 true，因此所有新酒店都会自动显示在 Google 上。

无论 Google Ads 的状态如何，也无论房源在 Google 上是否有房价，您都可以在 Hotel Center 帐号中使用 LoG 为您的房源启用或停用广告和免费的预订链接。这仅适用于酒店，而不适用于民宿。

您可以通过以下两种方式设置酒店的 LoG 值：Travel Partner API or the Hotel Center properties page. You can change the status of your existing properties in the Live on Google column on the Hotel Center properties page, or if you want to change the status of a large number of properties at the same time, you can use the Travel Partner API.

如需详细了解 LoG，请参阅 Hotel Center 帮助。

使用 Travel Partner API, you can do the following:

  • 通过 Hotel Center 或使用 hotelViews.list 端点查看房源的状态。

  • 在 hotelViews.list 端点中将 filter 参数与 liveOnGoogle = TRUE 搭配使用，检索 Google 上显示的所有酒店的列表。

  • 使用 hotelViews.summary 获取特定帐号的房源摘要，包括在 Google 上展示的房源数量。

如需详细了解如何使用 API 设置 LoG，请参阅 hotelViews.list 文章和 API 参考文档。