在庫メッセージ

概要

在庫メッセージ（OTA_HotelInvCountNotifRQ）は、特定の客室タイプで予約可能な在庫数（実際の客室数）を定義します。在庫メッセージを送信する際は、特定の日付にそのタイプの客室が何室利用可能かを示します。そのタイプの客室が空いていない場合、その客室タイプと日付を含む商品は表示されません。

以降のセクションでは、一般的なガイドライン、基本的な例、在庫の追加と更新、在庫メッセージの送信を開始するための手順について説明します。

インベントリ関連のさまざまなシナリオの例については、ハウツーをご覧ください。

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

XML リファレンスには、必須要素と省略可能な要素の説明が記載されています。属性と子要素の詳細については、インベントリ要素と属性をご覧ください。

構文とスキーマ

インベントリメッセージを作成する際は、インベントリ構文の例を参照して、正しい形式に従っていることを確認してください。

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

ガイドライン

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

在庫は、ホテル、日付、客室タイプをキーとして管理されます。
関連する料金プランと宿泊人数に対する料金を表示するには、滞在期間のすべての夜で在庫数が 0 より大きい必要があります。
在庫数が 0 と等しい場合、指定された客室 ID と日付範囲で客室を予約することはできません。
CountType は「確実な在庫」の数を示すため、有効にするには常に 2 の値を持つ必要があります。
システムで部屋の予約またはキャンセルが発生するたびに、更新された在庫を送信します。

在庫と在庫状況

在庫は、物理的な数に基づいて予約可能な客室の数です。空室状況は、客室タイプと料金プランの組み合わせが予約可能かどうかを示します。ARI では、空室状況と在庫は日付のセットまたは宿泊施設のタイプに基づいて変動する可能性があり、どちらにも対応するメッセージタイプがあります。空室在庫と空室状況は、ホテル、日付、客室タイプをキーとしており、空室状況には料金プランも含まれます。

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

可用性には 2 つのコンセプトがあります。まず、特定の宿泊期間における商品の全体的な在庫状況があります。これは、毎晩の料金が設定されているかどうか、関連する客室タイプの在庫、在庫状況の制限が解除されているかどうかなどの要因の影響を受けます。2 つ目は、特定の日付の商品に対する特定の制限です。これは OTA_HotelAvailNotifRQ の <RestrictionStatus Restriction="Master" Status="Open"/> で表されます。この在庫状況を終了することは「販売停止」と呼ばれます。

商品の料金を表示するには、在庫が 0 より大きい整数で、空室状況の制限がオープンである必要があります。

例

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

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

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

HotelCode には、システム内で宿泊施設を識別するために使用した一意のホテル ID を使用します。この値は、ホテルリストフィードの <listing> 要素の <id> を使用して指定した HotelID と一致する必要があります。<RoomID> には、システム内で部屋タイプに使用した ID と同じ 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>

その他の例については、インベントリの例をご覧ください。

入門ガイド

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

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

説明

特定の期間でこの客室タイプを予約できる残り客室がないことを示す必要があります。これは通常、売り切れが理由です。

解決策

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