供應情形、費率和空房 (ARI) XML 參考資料

這份 XML 參考指南針對供應情形、費率和商品目錄 (ARI) 動態饋給可用的各種訊息、元素和屬性，提供了詳細的參考資料和程式碼範例。

ARI 是價格放送模式，可控制每晚的房價、空房資訊和空房數量，並提供方式限制。ARI 也能彈性納入稅金、費用和促銷活動。

ARI 遵循 OpenTravel Alliance (OTA) 的標準通訊協定，以便用於定義可用性和廣告空間的主要訊息類型。

以 LOS 為基礎的定價

LOS-based 定價可讓您指定每個入住日期和入住天數的費率，而非每個入住日期。當您為以 LOS 為基礎的價格指定 <StatusApplicationControl> 元素時，@Start 和 @End 屬性表示適用 LOS 費率的入住日期範圍。

雖然使用 LOS 定價不再是每晚房價，但所有其他 ARI 功能 (庫存、供應情形、規則、促銷活動等) 仍適用於這些費率，並在夜間層級指定。這表示如果您的系統與以 LOS 為基礎的定價系統更加一致，除了利用每晚的可用性和限制更新授予的頻寬效率之外，您仍可利用豐富的 ARI 功能組合。

重點提示： 帳戶中的每項屬性都應採用 LOS 費率或日期費率。

如要為您的帳戶啟用以 LOS 為基礎的定價，請聯絡您的 TAM 或與我們聯絡。

重點提示： 您必須先傳送四種訊息類型 (交易、費率、庫存和供應情形)，才能提供價格。建議您將 ARI 訊息的大小設為 <OTA_HotelRateAmountNotifRQ> 至 5MB，並限制每秒上傳 400 個檔案。

ARI 會使用下列要求訊息：

• Transaction (資源資料)：定義類型和套件 (費率方案) 資訊。

• OTA_HotelRateAmountNotifRQ：針對指定日期範圍，定義每項產品 (房型和費率方案組合) 根據日期或 LOS 計算的入住人數。

• OTA_HotelAvailNotifRQ：根據房型和房價方案定義空房資訊和限制。您也可以透過這則訊息更新商品目錄，但建議使用 OTA_HotelInvCountNotifRQ。

• OTA_HotelInvCountNotifRQ：定義可售出的實體房間庫存或房間數量。

• TaxFeeInfo (選用)：定義各項資源的稅金和費用。如果 OTA_HotelRateAmountNotifRQ 訊息中指定了 AmountAfterTax，則不需要這則訊息。

• Promotions (選用) 定義特定預訂、住宿和使用者的促銷費率。

• RateModifications (選用) 定義特定預訂、住宿和使用者的費率修改規則。

• ExtraGuestCharges (選用) 定義兒童和其他成人的費率設定方式。

每則訊息都包含一部分資訊，Google 會使用這些資訊，計算使用者在特定入住/退房日期和可住人數的房源時，向他們顯示的價格和供應情形。

重點提示： ARI 功能僅限於這份廣告空間與定價 (ARI) XML 參考資料和 ARI 指南中所述的訊息和元素。我們的 ARI 導入作業不支援任何本文未明確記錄的 OTA 訊息、元素或屬性。

此外，使用 ARI 動態饋給類型時，系統也不支援這個廣告空間與定價 (ARI) XML 參考資料中未涵蓋的其他交易訊息元素。

Google 會持續更新並改善 API。如果您在系統中使用其他定價功能，請通知 Technology Account Manager(TAM)，以便優先使用這些功能，否則這些功能會通知您這些功能是否已規劃推出。

ARI XML 參考資料修訂版本記錄

下表僅列出功能變更的說明文件更新。

日期	異動
2020 年 8 月 14 日	第 1 版。
2020 年 10 月 21 日	新增了促銷訊息類型。
2020 年 11 月 17 日	針對交易 (資源資料) 訊息，更新端點，並在 PropertyDataSet 元素中加入 action 屬性。
2020 年 11 月 24 日	如果是交易 (資源資料) 訊息，請新增 <AllowablePackageIDs> 和 <AllowableRoomIDs> 元素。
2021 年 2 月 4 日	已新增回應訊息。
2021 年 2 月 25 日	新增了 OTA_HotelInvCountNotifRQ。
2020 年 10 月 21 日	新增「費率調整」訊息類型。