有空與否訊息

總覽

供應情形訊息 (OTA_HotelAvailNotifRQ) 定義了特定行程的產品 (房型和房價方案) 能否在適用日期販售。當您傳送供應情形訊息時，您可以指定產品的供應情形或限制是否有所變更。

重點提示： 您也可以使用供應情形訊息類型更新商品目錄，但我們建議使用商品目錄訊息類型 (OTA_HotelInvCountNotifRQ)。

以下各節將說明一般指南、基本範例和操作情境，協助您開始使用可用性訊息來新增及更新供應情形。

每晚空房限制

供應情形訊息可讓您定義限制，控制預訂的整體供應情形。「每晚供應情形」的限制類型是產品是否可在特定日期販售。為確保住宿服務 (從入住到退房) 可預訂，所有日期都必須提供夜間空房資訊，且必須滿足所有其他的預訂和入住天數限制。

注意： 如要進一步瞭解供應情形的概念，以及廣告空間和供應情形之間的差異，請參閱「廣告空間與供應情形比較」。

限制設定

根據預設，Restriction="Master" 的 RestrictionStatus 會關閉。換句話說，預設為每晚的「停止銷售」。

在所有住宿夜晚，產品的所有組合都必須包含 <RestrictionStatus Restriction="Master" Status="Open">，才能販售。您必須為各項產品傳送明確的 Open，或是在 Hotel Center 中變更預設值。方法是依序前往 Hotel Center 的「價格」>「設定」頁面，然後編輯「預設供應情形」欄位。

其他限制

抵達/出發

禁止銷售在指定日期抵達或離開的行程。預設為 Open。

最短和最長預訂位移

行程必須在抵達前購買至少特定天數，或最多一定天數。

最短與最長入住天數

針對抵達日期的行程限制入住天數。

最短和最長的入住天數 (或「入住」)

限制包含此住宿日期的行程天數。

入住天數長度

讓你確切控制這個抵達日期允許的入住天數。

一般原則

• 空房限制取決於飯店、日期、房型和房價方案。

• 只有在入住 (從入住到退房) 都沒有限制，或是使用者可以預訂住宿時，產品才可供預訂。

• 只要產品在指定日期的供應情形限制有所異動，就向 Google 傳送供應情形訊息更新。

範例

本節將透過必要和選用元素提供可用性訊息的基本範例。準備好檔案後，您需要透過 POST 訊息，將檔案傳送給 Google 這個端點：

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

如要進一步瞭解如何推送/發布訊息，請參閱「推送訊息」。

重點： 只要線上時段有異動，就傳送更新的訊息給 Google。

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

以下範例說明如何設定可用性限制：

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <AvailStatusMessages HotelCode="HOTELID">
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="202X-03-20"
                                End="202X-03-25"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay MinMaxMessageType="SetMinLOS" Time="2" TimeUnit="Day" />
      </LengthsOfStay>
      <RestrictionStatus Restriction="Master" Status="Open" />
    </AvailStatusMessage>
</OTA_HotelAvailNotifRQ>

如需更多範例，請參閱可用性範例。

使用指南

本節針對您在傳送可用性訊息時可能遇到的情境提供解決方案，特別是夜間可用性限制 (也稱為「停止銷售」)。

情境 1：如何在特定日期銷售產品

說明

您想在特定日期提供房型和房價方案組合 (產品)。

注意： 根據預設，Google 會將產品視為已啟用「停止銷售」功能 (夜間供應情形為關閉)，但您可以設定每晚的供應情形限制預設為開啟或關閉。您必須傳送每項產品的明確 Open，或是在 Hotel Center 中變更預設值。

解決方法

將 Master 限制設為 Open，並指定日期。

範例

以下範例說明如何在 3 月開放數週的產品供應情形。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-03-20"
                                End="2022-03-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

注意： 夜間供應情形限制必須為 Open (庫存量必須為大於 0 的整數)，才能顯示產品價格。

如要進一步瞭解如何設定價格，請參閱排解定價缺少問題或價格不完整的問題。

情境 2：如何在特定日期停止銷售產品

說明

您明確希望在指定日期停止銷售 (而非缺貨) 產品。

注意： 如果產品完全停用，因為房型、房價方案或其組合已停用，建議您使用交易 (屬性資料) 訊息取消對應產品，因為產品並非取決於日期。

解決方法

將 Master 限制設為 Close，並指定日期。

範例

以下範例說明如何在指定日期「停止銷售」或「關閉產品每晚的供應情形」。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       EchoToken="12345678"
                       TimeStamp="2022-03-20T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2022-04-20"
                                End="2022-04-30"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close" Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>