このページは Cloud Translation API によって翻訳されました。

在庫メッセージ

概要

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

以降のセクションでは、一般的なガイドライン、基本的な例、在庫の追加と更新、在庫確認と在庫メッセージ。

在庫に関するさまざまなシナリオの例については、ハウツー。

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

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

構文とスキーマ

[広告枠構文の例を在庫メッセージを作成する際には、確認します。

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

ガイドライン

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

在庫はホテル、日付、部屋のタイプによって設定されます。
在庫数は注文の全期間で 0 より大きくする必要があります関連付けられている料金プランと宿泊人数の料金を表示します。
在庫数が 0 の場合、会議室は予約できません。予約して予約できます。
CountType は、有効な 2 の値を常に持つ必要があります。これは、「確定した可用性」のカウントが自動的に返されるためです
会議室の予約やキャンセルのたびに最新の在庫を送信するシステム内で発生します

で確認できます。

広告枠と在庫状況

[在庫] は、物理的な数と施設数に基づく予約可能な部屋の数です。空室状況は、客室タイプと料金プランの組み合わせが予約できるようになります。ARI の場合、空室状況と在庫は、日付や宿泊施設の種類によって異なる場合があります。どちらにも対応するメッセージタイプがあります。在庫と空室状況はホテル、日付、部屋を基準とする可用性に関する料金プランが追加されました

「空き情報がない」状態になり在庫がある場合でも可用性は互いに独立しています

可用性のコンセプトは 2 つあります。まず全体的な可用性です次のような要因によって影響を受ける、特定の滞在中の商品毎晩定義されている料金、関連付けられた客室タイプの在庫、可用性の制限がオープンになります2 つ目は特定の日付の商品に対する制限。OTA_HotelAvailNotifRQ の <RestrictionStatus Restriction="Master" Status="Open"/> で表され、閉じます。この空き情報を「販売停止」と呼びます。

広告枠には、客室と空室状況に対して 0 より大きい整数を指定してください商品の価格を表示するには、制限を開いておく必要があります。

例

このセクションでは、必須のインベントリメッセージの基本的な例を示します。オプション要素です。ファイルの準備ができたら、 Google からこのエンドポイントへの POST メッセージ経由:

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

メッセージを push/POST する方法の詳細については、push または POST のメッセージ。

HotelCode には、システム内で使用した一意のホテル ID をあります。この値は、 <listing> の <id> 要素ホテルリストフィード。<RoomID> には、システム内で使用したものと同じ ID を。Google でデータが正しく表示されるようにするには、システムとの整合性が重要です。

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

<?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 を使って広告枠を 0 に設定する方法を示しています。特定の部屋と日付（1 月の最初の数週間など）でアクセスできます。

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