Availability Message

概要

空室状況メッセージ（OTA_HotelAvailNotifRQ）は、特定の旅程の商品（客室タイプと料金プランの組み合わせ）を該当する日付で販売できるかどうかを定義します。在庫状況メッセージを送信する際は、商品の在庫状況または制限が変更されたかどうかを示します。

以降のセクションでは、一般的なガイドライン、基本的な例、Availability メッセージを使用して在庫状況を追加、更新する方法について説明します。

夜間の利用制限

Availability メッセージを使用すると、予約の全体的な可用性を制御する制限を定義できます。制限の重要なタイプの一つに「夜間販売」があります。これは、特定の日付に商品を販売できるかどうかを示します。宿泊（チェックインからチェックアウトまで）を予約可能にするには、すべての日付で 1 泊あたりの空室があり、予約と宿泊に関するその他の制限をすべて満たしている必要があります。

制限の設定

デフォルトでは、Restriction="Master" の RestrictionStatus は閉じられています。つまり、デフォルトでは毎晩「販売停止」が行われます。

販売可能な商品にするには、宿泊のすべての夜のすべての商品の組み合わせで <RestrictionStatus Restriction="Master" Status="Open"> が必要です。各商品について明示的な Open を Google に送信するか、Hotel Center でデフォルトを変更する必要があります。この設定を行うには、Hotel Center の [料金 > 設定] ページに移動し、[デフォルトの空室状況] フィールドを編集します。

その他の制限

到着/出発
指定した日に到着または出発する宿泊プランの販売を禁止します。デフォルトでは Open です。
予約の最小オフセットと最大オフセット
到着日の少なくともまたは最大で特定の日数前に、旅行プランを購入する必要があります。
最小滞在日数と最大滞在日数
この到着日を含む宿泊プランの滞在日数を制限します。
最小および最大の滞在期間（または「滞在期間」）
この滞在日を含む宿泊プランの滞在日数を制限します。
滞在日数のパターン
この到着日に許可される滞在日数を正確に制御できます。

一般的なガイドライン

  • 空室状況の制限は、ホテル、日付、客室タイプ、料金プランをキーとして設定されます。

  • 宿泊（チェックインからチェックアウトまで）またはユーザーが宿泊を予約できるタイミングに適用される制限が課されていない場合にのみ、商品を予約できます。

  • 特定の日付の商品の在庫制限に変更があった場合は、そのたびに Google に在庫状況メッセージの更新を送信します。

例

このセクションでは、必須要素と省略可能な要素を使用した可用性メッセージの基本的な例を示します。ファイルを作成したら、次のエンドポイントに POST メッセージを送信して Google に送信する必要があります。

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

メッセージを push/POST する方法については、メッセージの push をご覧ください。

HotelCode には、システム内で宿泊施設を識別するために使用した一意のホテル ID を使用します。この値は、ホテルリスト フィードの <listing> 要素の <id> を使用して指定した HotelID と一致する必要があります。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: 特定の日に商品を販売する方法

説明

特定の日に客室タイプと料金プランの組み合わせ（商品）を利用可能にしたい。

解決策

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>

料金の設定方法について詳しくは、料金が不足している、または不完全である場合のトラブルシューティングをご覧ください。

シナリオ 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>