在庫メッセージ

概要

在庫メッセージ（OTA_HotelInvCountNotifRQ）は、特定の客室タイプで予約できる在庫数（物理的な部屋の数）を定義します。インベントリ メッセージを送信すると、そのタイプの客室のうち、特定の日に空いているものの数が示されます。そのタイプの部屋が利用できない場合、その部屋タイプと日付に関連する商品は表示されません。

以下のセクションでは、インベントリの追加と更新、インベントリ メッセージの送信を開始するための一般的なガイドライン、基本的な例、入門シナリオについて説明します。

インベントリ関連のさまざまなシナリオの例については、入門ガイドをご覧ください。

必須要素と省略可能な要素

XML リファレンスでは、必須要素と省略可能な要素について説明しています。属性と子要素について詳しくは、在庫の要素と属性をご覧ください。

構文とスキーマ

インベントリ メッセージを作成するときは、インベントリ構文の例を参考として使用し、正しい形式に従うようにしてください。

xmllint などのサードパーティの XML ツールを使用して、Google に送信する前に公開スキーマでフィードを検証できます。Inventory メッセージ スキーマについては、ホテル広告スキーマをご覧ください。

ガイドライン

在庫メッセージには次のガイドラインを使用します。

  • 在庫は、ホテル、日付、客室タイプによってキー付けされます。

  • 関連付けられた料金プランと宿泊人数の料金を表示するには、すべての宿泊日数の在庫数が 0 を超えている必要があります。

  • 在庫数が 0 に等しい場合、指定された客室 ID と期間ではその会議室を予約できなくなります。

  • CountType は「一定の可用性」を示すため、常に 2 の値が有効である必要があります。

  • システムで会議室の予約やキャンセルが発生するたびに、更新された在庫を送信します。

広告枠と在庫状況

「在庫」は、実際の数に基づく予約可能な客室の数であり、空室状況は、客室タイプと料金プランの組み合わせが予約できるかどうかを示します。ARI の場合、空き状況と在庫はどちらも日付や宿泊施設のタイプに応じて異なり、どちらにも対応するメッセージ タイプがあります。空室状況と空室状況はホテル、日付、客室タイプ別に設定され、空室状況の料金プランが追加されています。

在庫と在庫状況が互いに独立しているため、在庫がある場合でも「在庫状況なし」になる場合があります。

可用性には 2 つのコンセプトがあります。1 つ目は、特定の宿泊でのプロダクトの全体的な空室状況です。これは、毎晩に定義された料金、関連する客室タイプの在庫、空室状況の制限がオープンかどうかなどの要因によって左右されます。2 つ目は、特定の日付の商品に制限を設けることです。これは OTA_HotelAvailNotifRQ の <RestrictionStatus Restriction="Master" Status="Open"/> で表されます。この在庫状況の終了を「販売停止」と呼びます。

商品の価格を表示するには、在庫には客室について 0 より大きい整数を指定する必要があります。また、商品の価格を表示するには、空室状況が制限されている必要があります。

例

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

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

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

HotelCode には、宿泊施設の識別のためにシステム内で使用した一意のホテル ID を使用します。この値は、ホテルリスト フィードの <listing> 要素の <id> を使用して指定されたホテル ID と一致する必要があります。<RoomID> には、システム内で客室タイプに使用したものと同じ ID を使用します。Google がデータを正しく表示するためには、システムとの整合性が不可欠です。

次の例では、12 月に予約可能な 13 の会議室の在庫を設定する方法を示しています。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="13" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

その他の例については、広告枠の例をご覧ください。

入門ガイド

このセクションでは、Inventory メッセージの送信中に発生する可能性のあるシナリオについて説明します。

シナリオ: 会議室の予約をブロックする方法

説明

特定の日付にこの部屋タイプで予約できる部屋が残っていないことを示す必要があります。これは通常、満席であることが原因です。

解決策

<InvCount Count> の値を 0 に設定し、目的の期間を追加します。

サンプル

このサンプルは、InvCount を使用して、指定した部屋と日付（たとえば 1 月の最初の数週間）のインベントリを 0 に設定する方法を示しています。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2022-02-25T20:50:37-05:00"
                          Version="3.0">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-01-01"
                                End="2023-01-15"
                                InvTypeCode="ROOMID"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>