ARI 總覽

供應情形、費率和房源 (ARI) 是一種價格放送模式，可控制每晚的費率、空房資訊和空房，並提供合併方式的限制。ARI 也能彈性納入稅金、費用和促銷活動。

有別於行程式定價放送模式，使用提取和變更價格模式時，ARI 動態饋給不會查詢特定價格或行程，相反地，請在定價模式有全新或變更的資料 (例如費率詳細資料、限制和供應情形的變更) 時推送訊息。

優點

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「動態饋給狀態」頁面，查看特定訊息發生問題。

在 Google 上顯示 (LoG)

透過「在 Google 上顯示」功能，你可以在 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 參考資料。