OTA_HotelAvailNotifRQ

構文

OTA_HotelAvailNotifRQ メッセージでは、次の構文を使用します。
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="timestamp"
                       Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_account_name"/>
    </Source>
  </POS>
  <AvailStatusMessages HotelCode="HotelID">
    <AvailStatusMessage BookingLimit="integer">
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean_value"
                                Tue="boolean_value"
                                Weds="boolean_value"
                                Thur="boolean_value"
                                Fri="boolean_value"
                                Sat="boolean_value"
                                Sun="boolean_value"
                                InvTypeCode="RoomID"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean_value"
                                Tue="boolean_value"
                                Weds="boolean_value"
                                Thur="boolean_value"
                                Fri="boolean_value"
                                Sat="boolean_value"
                                Sun="boolean_value"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID"/>
      <LengthsOfStay>
        <LengthOfStay Time="integer"
                      TimeUnit="[Day]"
                      MinMaxMessageType="[SetMaxLOS|SetMinLOS|SetForwardMaxStay|
                      SetForwardMinStay]"/>
      </LengthsOfStay>
      <RestrictionStatus Status="[Close|Open]"
                         Restriction="[Arrival|Departure|Master]"
                         MaxAdvancedBookingOffset="integer"
                         MinAdvancedBookingOffset="integer"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

要素と属性

OTA_HotelAvailNotifRQ メッセージには、次の要素と属性があります。
要素 / @属性 発生数 説明
OTA_HotelAvailNotifRQ 1 複合要素 客室料金の可用性(客室料金を取得できるかどうか)を定義するメッセージのルート要素。
OTA_HotelAvailNotifRQ / AvailStatusMessages 1 AvailStatusMessages 1 つ以上の <AvailStatusMessage> 要素のコンテナ。
OTA_HotelAvailNotifRQ / AvailStatusMessages / @HotelCode 1 String 宿泊施設の一意の識別子。この値は、ホテルリスト フィードの <listing> 要素の <id> を使用して指定した HotelID と一致する必要があります。HotelID は Hotel Center にも表示されます。
OTA_HotelAvailNotifRQ / POS 0~1 POS このメッセージのパートナー アカウントを指定するコンテナ(通常、バックエンドが複数のパートナー アカウントの料金フィードを提供している場合に使用されます)。
OTA_HotelAvailNotifRQ / POS/ Source 1 Source <POS> が存在する場合は必須で、<RequestorID> のコンテナです。
OTA_HotelAvailNotifRQ / POS / RequestorID 1 RequestorID <POS> が存在する場合は必須で、パートナー アカウントを定義します。
OTA_HotelAvailNotifRQ / POS / RequestorID / @ID 1 String このメッセージのパートナー アカウント。この文字列の値は、Hotel Center の [アカウント設定] ページに表示されている [パートナーキー] の値です。

注: 複数のアカウントのフィードを提供するバックエンドを使用している場合、この値は、Transaction(宿泊施設データ)メッセージの partner 属性値と、同じアカウントの <OTA_HotelRateAmountNotifRQ> メッセージの <RequestorID> 要素にある ID 属性値に一致する必要があります。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage 1~n AvailStatusMessage 1 つの宿泊施設に関する、異なる期間での客室料金の可用性と制限を定義します。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / @BookingLimit 1 Int <StatusApplicationControl> の期間で予約可能な残り客室数。BooklingLimit が指定されている場合、<StatusApplicationControl> では InvTypeCode を指定する必要があり、<AvailStatusMessage> には <LengthOfStay> または <RestrictionStatus> を含めることはできません。0 以上である必要があります。指定しない場合のデフォルトは 0 です。

注: 特定の <StatusApplicationControl> 設定に関する空室状況を確立するには、BookingLimit 属性を少なくとも 1 回設定する必要があります。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl 1 StatusApplicationControl 期間のほか、客室タイプ(InvTypeCode)と料金プラン(RatePlanCode)の識別子を定義します。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Start 1 Date 期間の開始日。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @End 1 Date 期間の終了日。start の値以上にする必要があります。startend が等しい場合は、その日付に更新が適用されます。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Mon 0~1 Boolean 月曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的には true に設定されていない他の曜日が除外されます(実質的には StartEnd 内の日付から除外されます)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Tue 0~1 Boolean 火曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的には true に設定されていない他の曜日が除外されます(実質的には StartEnd 内の日付から除外されます)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Weds 0~1 Boolean 水曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的には true に設定されていない他の曜日が除外されます(実質的には StartEnd 内の日付から除外されます)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Thur 0~1 Boolean 木曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的には true に設定されていない他の曜日が除外されます(実質的には StartEnd 内の日付から除外されます)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Fri 0~1 Boolean 金曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的には true に設定されていない他の曜日が除外されます(実質的には StartEnd 内の日付から除外されます)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sat 0~1 Boolean 土曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的には true に設定されていない他の曜日が除外されます(実質的には StartEnd 内の日付から除外されます)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @Sun 0~1 Boolean 日曜日を明示的に含めるには、true または 1 に設定します。

true に設定すると、明示的には true に設定されていない他の曜日が除外されます(実質的には StartEnd 内の日付から除外されます)。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @InvTypeCode 1 String 在庫の一意の識別子(客室タイプ)。この値は、Transaction(宿泊施設データ)メッセージの <RoomID> に対応します。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / StatusApplicationControl / @RatePlanCode 0~1 String 料金プランの一意の識別子。この ID は、Transaction(宿泊施設データ)メッセージの <PackageID> の値に対応します。料金プランの詳細を定義し、料金プランが参照される場所は、<OTA_HotelRateAmountNotifRQ> メッセージと <OTA_HotelAvailNotifRQ> メッセージ両方の <StatusApplicationControl> 内です。

<AvailStatusMessage>BookingLimit 属性が含まれている場合、RatePlanCode 属性は適用されず、指定できません。<RestrictionStatus> または <LengthOfStay> が指定されている場合は指定する必要があります。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay 0~1 LengthsOfStay LOS 制限を定義するためのコンテナ。<AvailStatusMessage>BookingLimit 属性が含まれている場合は、指定できません。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay 1~n LengthOfStay 滞在日数に関する制限を定義します。複数の <LengthOfStay> 要素を使用する場合は、それぞれの要素で異なる MinMaxMessageType 値を指定する必要があります。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @Time 1 Int 滞在日数の測定の単位値。値 0 は、制限なしとして扱われます。たとえば、<LengthOfStay Time="0" MinMaxMessageType="SetMaxLOS"/> は最大滞在日数がないことを意味します。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @TimeUnit 0~1 Enum

時間の単位。指定しない場合のデフォルトは「Day」です。有効な値は次のとおりです。

  • Day
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / LengthsOfStay / LengthOfStay / @MinMaxMessageType 1 Enum 各種の滞在日数の制限。SetMaxLOSSetMinLOS は到着ベースで、到着日の時点で 1 日目になります。 SetForwardMinStaySetForwardMaxStay は滞在期間ベースで、実際の滞在期間で計測します。最大値は最小値以上にする必要があります。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus 0~1 RestrictionStatus 旅行プランの制限を定義します。<AvailStatusMessage>BookingLimit 属性が含まれている場合は、指定できません。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Status 0~1 Enum

Restriction 属性で指定された制限のタイプが開 / 閉のいずれであるかを示します。有効な値は次のとおりです。

  • Open
  • Close

注: 特定の <StatusApplicationControl> 設定に関する客室料金の可用性を確立するには、Status 属性を Open に設定する必要があり、Restriction 属性を少なくとも 1 回は Master に設定する必要があります。または、パートナーが Google に料金を提示し、BookingLimit が 0 より大きい場合、パートナーはアカントのデフォルトで Status 属性を Open にするように構成することを Google に依頼できます。

OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @Restriction 0~1 Enum

Status が指定されている場合、この属性は必須です。

有効な値は次のとおりです。

  • Arrival: この値を指定すると、StartEnd の期間(両日を含む)にチェックイン日が含まれる旅行プランが許可されません。
  • Departure: この値を指定すると、StartEnd の期間(両日を含む)にチェックアウト日が含まれる旅行プランが許可されません。
  • Master: この値は、その日付の予約の客室料金が利用できるかどうかを示します。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MinAdvancedBookingOffset 0~1 Int 到着日までの最小日数(その到着日でこの客室料金を予約可能)。
OTA_HotelAvailNotifRQ / AvailStatusMessages / AvailStatusMessage / RestrictionStatus / @MaxAdvancedBookingOffset 0~1 Int 到着日までの最大日数(その到着日でこの客室料金を予約可能)。

例 1

最小 / 最大の滞在日数(到着日ベース) + 最小 / 最大の事前購入 + Closed-to-Arrival + 在庫数

<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2020-05-13T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage BookingLimit="5">
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5"
                      MinMaxMessageType="SetMaxLOS"/>
        <LengthOfStay Time="2"
                      MinMaxMessageType="SetMinLOS"/>
      </LengthsOfStay>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close"
                         Restriction="Arrival"
                         MaxAdvancedBookingOffset="30"
                         MinAdvancedBookingOffset="7"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

例 2

最小 / 最大の滞在日数(滞在期間ベース)

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2020-05-13T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <LengthsOfStay>
        <LengthOfStay Time="5"
                      MinMaxMessageType="SetForwardMaxStay"/>
        <LengthOfStay Time="2"
                      MinMaxMessageType="SetForwardMinStay"/>
      </LengthsOfStay>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

例 3

Closed-to-Departure(指定の日にチェックアウトする旅行プランを許可しない)

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2020-05-13T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close"
                         Restriction="Departure"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

例 4

Closed-to-Arrival(指定の日にチェックインする旅行プランを許可しない)

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2020-05-13T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close"
                         Restriction="Arrival"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

例 5

「Open」の空室状況、制限なし

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2020-05-13T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage BookingLimit="5">
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open"
                         Restriction="Master"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

例 6

週末のみに適用される、最小 / 最大の予約可能期間の制限

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2020-05-13T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-01-01"
                                End="2020-06-30"
                                Mon=”false”
                                Tue=”false”
                                Weds=”false”
                                Thur=”false”
                                Fri=”false”
                                Sat=”true”
                                Sun=”true”
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus MaxAdvancedBookingOffset="30"
                         MinAdvancedBookingOffset="2"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>

例 7

客室タイプと料金プランに関して、同じ日付に複数の制限を設定する。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelAvailNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                       TimeStamp="2020-05-13T20:50:37-05:00"
                       Version="3.0">
  <AvailStatusMessages HotelCode="Property_1">
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Close"
                         Restriction="Master"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open"
                         Restriction="Arrival"/>
    </AvailStatusMessage>
    <AvailStatusMessage>
      <StatusApplicationControl Start="2020-05-18"
                                End="2020-05-23"
                                InvTypeCode="RoomID_1"
                                RatePlanCode="PackageID_1"/>
      <RestrictionStatus Status="Open"
                         Restriction="Departure"/>
    </AvailStatusMessage>
  </AvailStatusMessages>
</OTA_HotelAvailNotifRQ>