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

這份 XML 參考指南提供詳細的參考內容和程式碼範例，說明適用於空房、房價和房源 (ARI) 動態饋給的不同訊息、元素和屬性。

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

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

以 LOS 為基礎的定價方式

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

雖然使用以住宿天數為準的定價時，不再有每晚房價，但所有其他 ARI 功能 (空房數、供應情形、規則、促銷活動等) 仍可套用至這些房價，並以每晚為單位指定。也就是說，如果您的系統與以 LOS 為準的定價系統更為一致，除了可利用每晚的空房情況和限制更新功能，提高頻寬效率外，您仍可充分運用 ARI 的豐富功能。

重點提示： 帳戶中的每項房源都應使用以住宿天數為準的房價或每日房價。

如要在帳戶中啟用以 LOS 為準的價格，請與客戶技術管理團隊聯絡，或與我們聯絡。

重點： 你必須先傳送四種訊息類型 (交易、費率、廣告空間和供應情形)，才能取得價格。建議您將 ARI 訊息大小限制為 5MB，上傳速率則限制為每秒 400 個檔案。<OTA_HotelRateAmountNotifRQ>避免在最後一則訊息的 3 秒間隔內，傳送多個重疊的特定日期行程資訊。

ARI 使用下列要求訊息：

• Transaction (資源資料)。定義類型和套裝組合 (費率方案) 資訊。

• OTA_HotelRateAmountNotifRQ。針對特定日期範圍，定義每個產品 (房型和費率方案組合) 的每日或住宿天數 (LOS) 房價金額。

• OTA_HotelAvailNotifRQ：根據房型和房價方案定義供應情形和限制。您也可以使用這則訊息更新房源資訊，但建議使用 OTA_HotelInvCountNotifRQ。

• OTA_HotelInvCountNotifRQ：定義實體房源或可銷售的房數。

• TaxFeeInfo (選用) 定義每項房源的稅金和費用。如果 OTA_HotelRateAmountNotifRQ 訊息中已指定 AmountAfterTax，則不需要提供這則訊息。

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

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

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

每則訊息都包含部分資訊，Google 會根據這些資訊計算價格和供應情形，並在使用者搜尋特定入住和退房日期及入住人數的房源時顯示。

重點： ARI 功能僅限於本廣告空間和定價 (ARI) XML 參考資料和 ARI 指南中說明的訊息和元素。凡是未在此處明確記錄的任何 OTA 訊息、元素或屬性，我們的 ARI 實作都不支援。

此外，使用 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 日	新增費率調整訊息類型。