概要
空室状況メッセージ(OTA_HotelAvailNotifRQ
)は、指定された宿泊プランのプロダクト(料金プランと組み合わせた客室タイプ)を、該当する日付で販売できるかどうかを定義します。在庫状況のメッセージを送信する場合は、商品の在庫状況または制限が変更されたかどうかを示します。
以下のセクションでは、可用性メッセージを使用して空き情報の追加と更新を開始するための一般的なガイドライン、基本的な例、手順のシナリオについて説明します。
1 泊の空き状況の制限
空き状況メッセージでは、予約の全体的な空室状況を制御する制限を定義できます。代表的な制限のタイプの一つに、「夜間の在庫状況」、つまり商品を特定の日に販売できるかどうかというものがあります。滞在(チェックインからチェックアウトまで)を予約するには、すべての日付で 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>
を使用して指定されたホテル 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: 特定の日付に商品を販売する方法
説明
客室タイプと料金プランの組み合わせ(プロダクト)を特定の日付に利用できるようにする場合。
解決策
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
に設定し、日付を指定します。
サンプル
このサンプルは、指定した日付に商品の 1 泊の在庫状況を「販売停止」またはクローズする方法を示しています。
<?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>