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)

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

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

您可以通过以下两种方式设置酒店的 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 端点查看房源的状态。

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

  • 使用 hotelViews.summary 可获取特定账号的房源摘要，包括在 Google 上发布的房源数量。

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