供應情形訊息

總覽

「供應情形」訊息 (OTA_HotelAvailNotifRQ) 會定義特定行程的產品 (房型和費率方案的組合) 是否可在適用日期銷售。傳送「供應情形」訊息時，請指出產品的供應情形或限制是否有所變更。

重點提醒： 你也可以使用「供應情形」訊息類型更新房源資訊，但建議使用「房源資訊」訊息類型 (OTA_HotelInvCountNotifRQ)。

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

夜間供應限制

您可以在「預訂時間」訊息中定義限制，控管預訂的整體可用性。其中一種值得注意的限制是「每晚供應情形」：產品是否可在特定日期銷售。如要開放預訂住宿 (從入住到退房)，所有日期都必須有空房，且符合所有其他預訂和住宿限制。

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

限制設定

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

如要銷售產品，住宿期間所有晚上的所有產品組合都必須有 <RestrictionStatus Restriction="Master" Status="Open">。你必須為每個產品明確傳送 Open 給 Google，或變更 Hotel Center 中的預設值。如要完成這項操作，請前往 Hotel Center 的「價格」>「設定」頁面，然後編輯「預設供應情形」欄位。

其他限制

抵達/出發

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

預訂時差下限和上限

規定行程必須在抵達前至少或最多幾天內購買。

最短和最長入住天數

限制抵達日期為此日期的行程住宿天數。

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

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

入住天數模式

可精確控管這個抵達日期允許的住宿天數。

一般指南

• 供應情形限制會依飯店、日期、房型和房價方案而有所不同。

• 如果住宿期間 (從入住到退房) 或使用者可預訂住宿的時間沒有任何限制，產品才能預訂。

• 每當特定日期的產品供應限制有異動時，請傳送供應情形訊息更新給 Google。

範例

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

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

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

重點： 只要有空房，請傳送更新訊息給 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 給 Google，或變更 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>