メッセージを評価する

概要

料金メッセージ（OTA_HotelRateAmountNotifRQ）は、1 泊の 特定の日付における各客室タイプと料金プランの組み合わせごとの宿泊料金 あります。料金メッセージでは、Google は宿泊人数に基づく料金をサポートしています。 最大人数に基づいて異なる 1 泊の料金を指定できます。 確保できます。

以降のセクションでは、一般的なガイドライン、基本的な例、 料金の追加と更新、料金情報の送信 評価メッセージ。

一致率の動作

ユーザーが特定の宿泊人数をリクエストした場合に表示される料金は、 料金メッセージでの料金の定義方法。このセクションでは、 ユーザー リクエストは、宿泊人数に応じて料金にマッチングされます。 定義した料金に関する情報が含まれます。

基本原則

  • 特定の宿泊人数に対して定義された料金は、それより低い宿泊人数すべてに適用されます。 使用できます。

  • 定義された値を超える宿泊人数のリクエストは不可とみなされます。

  • 宿泊人数ベースの料金は、日付単位と LOS ベースの両方に適用されます。 料金モデルについては後ほど説明します。つまり、キャンペーンごとに 。特定の宿泊料金が存在しない場合、 次が使用されます。また、サービス アカウントの AdditionalGuestAmounts を使用する追加のゲストと子供 または ExtraGuestCharges 定員の上限が適用されます。

メリットと例

効率性

宿泊料金が同じ場合、料金の 宿泊人数に応じた料金を提示しますメッセージをシンプルにするには、 客室タイプと料金プランでサポートされる最高宿泊人数の値を指定します。 設定以下の宿泊人数のユーザーに対して、その料金が表示されます あります。

例: 客室タイプと料金プランは、 定員 1 ～ 4 です。レートメッセージを使用して、最大レートに 1 つのレートを 定員 4 名です。1 人、2 人、3 人の宿泊人数を検索しているユーザー 同じ割合で表示されます5 以上を検索したユーザーには料金が表示されません。

管理

別の宿泊人数に対する個別の料金を明示的に指定できます。送信 より細かくコントロールしたい場合は、宿泊人数に異なる料金を設定できます。 Google はリクエストを宿泊料金と照合します。

例: 宿泊人数 3 人と 1 人に対して料金が定義されている場合、1 人利用 検索には 1 人部屋の料金、2 人部屋の検索には 1 人部屋の料金が表示されます。 宿泊人数が 3 倍以上になり、4 以上を検索したユーザーには 料金。

さまざまなレートに関連するシナリオのその他の例については、以下をご覧ください。 ハウツー。

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

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

構文とスキーマ

レートの構文を使用する レート メッセージを作成するときに参照用として 正しい形式に従っていることを確認します

サードパーティ XML ツール（xmllint など）を使用して、 Google に送信する前に、公開スキーマを更新する。「料金」メッセージでは、 ホテル広告のスキーマをご覧ください。

料金モデル

日付ごとの料金

ほとんどの宿泊施設で使用されている標準の料金モデルです。per-date すべての滞在日で合計され、 提示しますこのモデルでは、Rate 要素のすべての料金が適用されます。 で指定された期間に適用されるものとして解釈されます <StatusApplicationControl>。

LOS ベースの料金

LOS ベース（滞在日数）料金モデルは、 到着日と滞在日数の組み合わせ。 LOS ベースの料金モデルは 1 日単位です。たとえば、100 ドルの送料を 滞在日数 3 の場合、合計金額は 3 x$100=$300 となります。

LOS ベースの料金モデルを利用するには、次の条件を指定します。 StatusApplicationControl 要素に対する RatePlanType="26"。さらに、 RateTimeUnit 属性と UnitMultiplier 属性を Rate 要素に XML。これにより、指定された Rate 要素に含まれるすべての料金が宿泊に適用されます。 <StatusApplicationControl> で指定された到着日と UnitMultiplier に指定された LOS 値。

1 つの 1 つの料金モデルで、日付単位と LOS ベースの両方の料金モデルを利用できます。 各プロパティで使用する料金モデルは 1 つのみです。 LOS ベースの料金を実装する場合は、次の点に注意してください。

  • LOS ベースを使用している場合、異なる滞在日数の料金が合算されることはありません 料金。たとえば、LOS レートが 3 の場合、LOS レートが次の値の組み合わせになることはありません。 LOS レートを 4 にするには、1 をLOS レートの 4 は、明示的に あります。
  • LOS ベースの料金における 1 泊の料金は、個別の宿泊料金としては使用されません 日付単位の料金設定です
  • 各宿泊施設では、LOS ベースの料金または日付ごとの料金のみを使用する必要があります。 表示方法によって異なります。

アカウントで LOS ベースの料金を有効にするには、TAM にリクエストしてください。 またはお問い合わせください。

ガイドラインまたは措置

日付ごとの料金

Delta: 指定された宿泊人数あたりの料金を追加または更新します。 で指定された客室タイプ、料金プラン、宿泊日の組み合わせ <StatusApplicationControl>。

  • レートの更新では、デフォルトで Delta アクションが使用されます。
  • Delta を更新しても、以前に保存された他の 定員です。たとえば、1 つの料金と 10, 000 以上の 2 人部屋の客室を用意し、1 人部屋の Delta 料金の更新情報を送信する 場合、2 人部屋の宿泊料金は変わりません。

Overlay: 客室タイプの既存の宿泊人数あたりの料金をすべて削除します。 <StatusApplicationControl> で指定された日付に置換され、 新しい料金でターゲティングできますたとえば、1 つの料金と 10, 000 以上の 2 人部屋があり、1 人部屋の Overlay の更新情報を送信した場合 場合、以前の料金（シングル プランとダブル プランの料金）は 宿泊人数は該当せず、更新後は 1 人の宿泊料金のみが残ります。

Remove: 客室タイプの既存の宿泊人数あたりの料金をすべて削除します。 料金プラン、<StatusApplicationControl> で指定された期間。

LOS ベースの料金

Delta: 指定した LOS 値のみごとのレートを追加または更新します。 で指定された客室タイプ、料金プラン、チェックイン日の組み合わせ。 <StatusApplicationControl>。関連付けられているすべての宿泊人数の料金を置き換えます 確認できます。

  • レートの更新では、デフォルトで Delta アクションが使用されます。
  • Delta を更新しても、以前に保存された他の 滞在日数。たとえば、LOS 1 と 2 の料金を指定した場合、 LOS 1 に対して Delta の料金更新を送信し、次に LOS 2 の宿泊人数あたりの料金を送信します。 変更はありません。
  • Delta を更新すると、以前に保存された宿泊人数あたりの料金がすべて上書きされます。 滞在日数をカウントしますたとえば、1 つの ID と ID で 1 つの LOS 1 の 2 人部屋の宿泊料金と、LOS 1 の Delta の料金更新データを送信する では、2 人部屋の宿泊料金は削除されます。

Overlay: LOS、客室の既存の宿泊人数あたりの料金をすべて削除します <StatusApplicationControl> で指定されたタイプ、料金プラン、チェックイン日 新しい料金に置き換えますたとえば、期間内で LOS 1 と 2 があり、LOS 1 の Overlay の更新を送信すると、Google によって削除されます 以前のすべての料金（LOS 1 と 2）が適用され、LOS 1 のレートのみが残ります。 おすすめします。

Remove: 次の期間の全 LOS の既存の宿泊人数あたりの料金をすべて削除します。 客室タイプ、料金プラン、チェックイン日が <StatusApplicationControl>。

税金関連

税金と手数料がシンプルな場合は、合計額を AmountAfterTax。複雑な税金（ （1 泊ではなく）滞在日数は AmountAfterTax で表すことはできません。

通常は、代わりに TaxFeeInfo を使用することをおすすめします。 AmountAfterTax。

可能であれば、AmountBeforeTax AmountAfterTax）が使用されます。一部の言語 / 地域（US など）では、 税抜き価格がデフォルトで適用されます

ユーザーが支払う必要があるすべての税金と手数料（VAT、宿泊税、清掃料金、市町村名） 税金など）を含める必要があります。 物件に直接支払われます

例

このセクションでは、required と オプション要素です。ファイルを準備したら、 POST メッセージを次のエンドポイントに送信します。 https://www.google.com/travel/hotels/uploads/property_data

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

HotelCode には、システム内で使用した一意のホテル ID を あります。この値は、 <listing> 要素の <id> ホテルリスト フィードで表示できます。<PackageID> と <RoomID> には、先ほどと同じ ID を使用します。 システム内で使用する料金のプランと客室タイプをそれぞれ指定します。整合性 ユーザーとシステムを適切に管理することは 価格とデータを保護します

次の例は、Delta アクションを使用して料金を設定する方法を示しています。

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2022-02-25T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt NumberOfGuests="1" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="2" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="3" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="4" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
</OTA_HotelRateAmountNotifRQ>

入門ガイド

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

料金の追加、削除、更新方法の例については、料金 例。

シナリオ 1: 宿泊人数あたりの料金を変更する方法

説明

以前は、1 泊の料金は 2 人部屋のみに対して定義されていました（これは は 1 人で宿泊する場合に適用されます）が、現在は 1 人部屋の宿泊料金が安くなっています 。

解決策

デフォルトの Delta スコープの更新を使用して、新しい宿泊人数 1 の料金を送信します。この新しい 定員 2 の料金には影響しません。

シナリオ 2: 宿泊施設の宿泊人数あたりの料金を置き換える方法

説明

以前は宿泊人数 1 ～ 4 の料金を定義しましたが、現在は 定員 1 と 2 は有効です。

解決策

NotifType="Overlay" を使用して、特定の宿泊施設のすべての宿泊料金を置き換える。 客室タイプ、料金プラン、日付などですこのシナリオでは、Overlay アクションは次のようになります。 定員 1 と 2 の料金を表示できます。

シナリオ 3: 複数の定員に同じ料金を設定する方法

説明

特定の宿泊人数の料金は、より少ない人数のグループに販売できます。この レートの更新のみを送信することで、メッセージを簡素化できます。 最大宿泊人数が適用されます。

解決策

複数の宿泊人数に同じ料金を設定する場合は、最大宿泊人数を設定します 値があり、それが自動で作成され、 その値を使用して定員を減らします。つまり、同じことを何度も繰り返す必要はありません。 宿泊人数が 1 ～ 6 人に対する 1 泊の料金（すべて同じ場合）。6 に設定します。