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)

你可以透過 Live on 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 參考資料。