有空與否訊息

總覽

供應情形訊息 (OTA_HotelAvailNotifRQ) 會定義產品是否屬於產品 (房型類型加上費率方案) 則可以針對指定行程的 適用日期。傳送「有空與否」訊息時，您必須指明 產品的供應情形或限制有所變更。

重點： 您也可以使用「供應情形」訊息類型來更新商品目錄， 但建議使用商品目錄訊息類型 (OTA_HotelInvCountNotifRQ) 方法。

下列各節涵蓋一般指南、基本範例和操作說明 協助您開始使用 有空與否訊息。

夜間供應情形限制

「供應情形」訊息可讓您定義要控管 是否提供預訂其中一項值得注意的限制類型是 「nightly availability」：產品是否能在特定日期販售。 如要提供入住選項 (從入住到退房)，且每晚必須每晚時間 所有日期的供應情形，且所有其他預訂和住宿限制都必須 因此建議您建立快訊政策 在符合特定條件時通知您

注意： 如要進一步瞭解可用性的概念和差異 請參閱廣告空間與供應情形的 供應情形。

限制設定

根據預設，Restriction="Master" 的 RestrictionStatus 為關閉狀態。在其他 預設是「停止銷售」應用程式。

如要銷售產品，所有產品組合在所有住宿晚間都必須有 <RestrictionStatus Restriction="Master" Status="Open">。個人中心 必須為每項產品向 Google 傳送明確的 Open，或者變更 與 Hotel Center 預設使用的功能方法是前往 價格 >編輯 Hotel Center 的「設定」頁面，編輯「預設」 availability [供應情形]] 欄位。

其他限制

抵達/離開

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

最短與最高預訂補償

規定的購買期限必須至少達到特定數字 。

最短和最長入住天數

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

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

針對包含此入住日期的行程限制入住天數。

停留天數模式

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

一般指南

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

• 只有在沒有適用的限制時，才能預訂產品 入住時 (從入住到退房)，或使用者能預訂住宿的時間。

• 只要 產品在特定日期的供應情形限制。

範例

本節提供「供應情形」訊息的基本範例 以及選用的元素檔案準備就緒後，您需要將檔案傳送到 Google 透過 POST 訊息傳送至這個端點：

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

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

重點： 每當有空房情況時，請將最新訊息傳送給 Google。

如果是「HotelCode」，請使用系統中的專屬飯店 ID 識別屬性這個值必須符合使用 <id> 中的 <listing> 元素 飯店清單動態饋給。與系統的一致性至關重要 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 會將產品視為「停止銷售」已啟用 (每晚) 有空房，但你可以設定每晚供應情形 限制預設為開啟或關閉您必須向 Google 傳送 請明確指出各項產品的 Open，或在 Hotel Center 中變更預設設定。

解決方案

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

範例

這個範例說明如何在部分時段設定產品夜間供應情形 週。

<?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>