ARI 概览

空房情况、房价和空房库存 (ARI) 是一种价格传送模式，用于控制每晚房价、空房情况和空房库存，并对这些信息的组合方式施加限制。ARI 还支持灵活添加税费、费用和促销活动。

与基于行程的价格传送模式“拉取”和“价格更改”不同，系统不会针对 ARI Feed 查询特定价格或行程。而是在定价模型中出现新数据或数据发生变化时（例如房价详情、限制和空房情况发生变化）推送消息。

优势

ARI 具有以下优势：

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

  • 价格准确性：通过使用“有变化时推送”事件模型提供实时更新，提高价格准确性。

  • 更广泛的价格覆盖率：通过将精细数据组合到各种行程中，实现更广泛的价格覆盖率（包含价格的行程数量）。

  • 灵活性：可更灵活地提供促销和套餐。

  • 易用：以与系统中存储方式一致的方式传输数据，避免计算或缓存许多行程的价格。

请求消息类型

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

ARI 遵循 OpenTravel Alliance (OTA) 的标准协议，用于定义播出信息和广告资源的一些主要消息类型。

ARI 使用以下请求消息：

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

  • OTA_HotelRateAmountNotifRQ。为特定日期范围内的每种产品（客房类型和房价方案组合）定义按日期或根据入住人数占用率计算的费用金额。

  • 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 参考文档。