庫存訊息

總覽

「房源」訊息 (OTA_HotelInvCountNotifRQ) 會定義特定房型可預訂的房源數量 (實體房間數)。傳送房源訊息時，請指出特定日期可用的房型數量。如果沒有該類型的房間，系統就不會顯示涉及該房型和日期的產品。

以下各節將介紹一般指南、基本範例，以及操作情境，協助你開始新增及更新商品目錄，並傳送商品目錄訊息。

如需各種與目錄相關情境的範例，請參閱「操作說明」。

必要和選用元素

XML 參考資料提供必要和選用元素的說明。如要瞭解屬性和子元素的詳細資料，請參閱「目錄元素和屬性」。

語法和結構定義

建立 Inventory 訊息時，請參考庫存語法範例，確保格式正確。

你可以使用 xmllint 等第三方 XML 工具，先透過已發布的架構驗證動態饋給，再提交給 Google。如需「房源」訊息結構定義，請參閱飯店廣告結構定義。

指南規範

請根據下列指南撰寫商品目錄訊息：

  • 庫存會依飯店、日期和房型分類。

  • 如要顯示相關費率方案和入住人數的價格，住宿期間每晚的房源數量都必須大於 0。

  • 如果房源數量等於 0，則指定房源 ID 和日期範圍的客房將無法預訂。

  • CountType 一律必須具有 2 的值，才算有效，因為這表示「確定有空房」的數量。

  • 每當系統中發生訂房或取消訂房的情況，請傳送更新後的房源資訊。

廣告空間與供應量

房源是指可預訂的房間數量 (以實際數量為準)，而空房狀況則是指是否可預訂房型和房價方案的組合。對於 ARI，空房情況和房源都會因日期或住宿類型而異，兩者都有對應的訊息類型。房源和供應情形會依飯店、日期和房型而異，供應情形還會依房價方案而異。

即使有廣告空間，也可能「沒有供應情形」，因為廣告空間和供應情形是彼此獨立的。

可用性有兩種概念。首先，產品在特定住宿期間的整體供應情形會受到多項因素影響，例如每晚是否都有定義價格、相關房型的空房數，以及供應情形限制是否開放。其次，特定日期產品的具體限制以 <RestrictionStatus Restriction="Master" Status="Open"/> 表示，並位於 OTA_HotelAvailNotifRQ 中，關閉這項供應情形稱為「停止銷售」。

如要顯示產品價格，房型庫存必須大於 0，且供應情形限制必須開放。

範例

本節提供使用必要和選用元素的商品目錄訊息基本範例。準備好檔案後，您需要透過 POST 訊息將檔案傳送至下列端點：

https://www.google.com/travel/hotels/uploads/ota/hotel_inv_count_notif

如要進一步瞭解如何推送/POST 訊息，請參閱推送訊息。

請將 HotelCode 替換為系統中用於識別房源的專屬飯店 ID。這個值必須與飯店清單動態饋給中 <listing> 元素內使用 <id> 指定的飯店 ID 相符。請將 <RoomID> 替換為系統中使用的房型 ID。與系統保持一致性，是確保 Google 正確顯示資料的關鍵。

以下範例說明如何為 12 月的 13 間可預訂客房設定房源：

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="13" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

如需更多範例，請參閱「廣告空間範例」。

使用指南

本節提供您在傳送目錄訊息時可能遇到的情境。

情境：如何禁止預訂會議室

說明

你必須指出特定日期範圍內，此房型已無可預訂的房間，最常見的原因是已售完。

解決方案

將 <InvCount Count> 設為 0 值，並新增所需日期範圍。

範例

本範例說明如何使用 InvCount，將指定房型和日期 (例如 1 月的前幾週) 的房源設為 0。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-01-15"
                                InvTypeCode="ROOMID"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>