ARI 概览

空房情况、房价和空房库存 (ARI) 是一种价格传送模式，可控制每晚房价、空房情况和空房库存，并提供有关如何组合这些信息的限制。ARI 还可灵活地包含税费和其他费用以及促销优惠。

与基于行程的定价交付模式（即拉取价格和价格更改）不同，系统不会查询 ARI Feed 中的特定价格或行程。相反，当您的定价模式有新的或更改的数据时（例如费率详细信息、限制和房态发生变化），您会推送消息。

优势

ARI 具有以下优势：

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

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

  • 更广泛的价格覆盖面：通过使用组合成各种行程的精细数据，实现更高的价格覆盖面（有价格的行程数量）。

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

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

请求消息类型

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

对于定义供应情况和库存的一些主要消息类型，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 账号中通过“在 Google 上发布”为您的房源启用或停用广告和免费的预订链接。

您可以通过以下两种方式设置酒店的 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 端点中的 liveOnGoogle = TRUE 和 filter 参数，检索 Google 上显示的所有酒店的列表。

  • 使用 hotelViews.summary 获取特定账号的媒体资源摘要，包括 Google 上有效的媒体资源数量。

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