ARI 總覽

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

與行程價格傳送模式不同，系統不會查詢 ARI 動態饋給的特定價格或行程。當定價模式有新資料或資料變更時，例如費率詳細資料、限制和供應情形有異動，您會推送訊息。

優點

ARI 具有下列優點：

  • 頻寬效率：減少需要傳輸的資料量，藉此提高頻寬效率。只要每晚傳送 ARI 資料，並只傳送增量變更，Google 就能計算各種預先購買和住宿天數值的價格和更新。

  • 價格準確度：使用「變更時推送」事件模型提供即時更新，提高價格準確度。

  • 涵蓋更多價格：使用細部資料組合出各種行程，涵蓋更多價格 (有價格的行程數量)。

  • 彈性：提供促銷活動和套裝組合，讓您享有更大的彈性。

  • 易於使用：傳輸資料的方式與系統儲存資料的方式一致，因此不必計算或快取許多行程的價格。

要求訊息類型

傳送至 Google 的 ARI 訊息稱為 ARI「要求」訊息。Google 隨後會傳回「回應」訊息，指出作業成功或失敗。

ARI 遵循 OpenTravel Alliance (OTA) 的標準通訊協定，定義供應情況和房源的主要訊息類型。

<OTA_HotelRateAmountNotifRQ>

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

在 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 參考資料。