料金の概要

ホテル料金とは、チェックイン日と宿泊日数を組み合わせた宿泊プランに対する 2 人部屋の最安値のことです。

概要

ホテルまたは旅行プランの組み合わせに対して定義した料金は、ホテルの検索結果の中心になります。料金の最新性、正確性、競争力を維持することは非常に重要です。

Google は通常、検索結果を表示する際に料金キャッシュからの料金を使用します。料金の更新内容を含む Transaction メッセージを Google に送信すると、Google はそのデータをキャッシュに保存します。

また、Google はホテル広告アカウントの最新の料金をリアルタイムでリクエストすることもできます。ユーザーが特定のホテルや旅行プランの組み合わせを検索すると、Google は「ライブ」リクエストまたはライブ料金クエリ メッセージを送信できます。指定された期間内に応答した場合、ユーザーがリクエストした旅行プランの結果にその料金が表示されます。また、ライブ料金クエリの結果は、今後のリクエストに対応できるようにキャッシュに保存されます。

料金改定の規模

客室の料金を設定するときは、事前予約と滞在日数（LoS）の値、およびそれらの値と客室 ID または料金プラン ID の組み合わせごとに料金を指定します。予約と LoS の値はデフォルトで次のようになります。

  • 330 日前までの予約
  • 最大 30 泊

これらの一般的なガイドラインに基づいて、シングルルームの料金には、チェックイン日と宿泊数の組み合わせごとに 1 つ、最大 9,900 の個別のエントリ（330 × 30）が必要になる場合があります。

次のマトリックスは、単一のホテルの宿泊プランデータの一部を示しています。マトリックス内で料金が表示されている各セルは、チェックイン日と滞在日数を組み合わせた 1 つの旅行プランの組み合わせを表します。各旅行プランは、Google が宿泊施設に対してリクエストする個別の値を表します。

料金が変更されたホテルと旅行プラン

Google が設定するホテルの料金は、ホテルリストによって定義されます。無効にしない限り、ホテルリスト フィード内のすべてのホテルは、トランザクション メッセージ（場合によってはライブ料金クエリ）で料金が更新されます。

価格の更新

料金を更新する一般的なプロセスは次のとおりです。

  1. 初期設定時にホテルリストでホテルの料金を設定し、リストが変更されると定期的に更新します。

  2. 変更済み料金のみ: Google がサーバーに Hint Request メッセージを送信します。

  3. 変更済み料金のみ: サーバーは、料金を変更する必要があるホテルまたは旅行プランの組み合わせを定義する Hint Response メッセージを返します。

  4. Google はサーバーにクエリ メッセージを送信します。クエリ メッセージには、Google が料金を必要とするホテル ID と宿泊プランが含まれます。

  5. ライブ料金クエリの場合、Google は、現在のオークションにホテルまたは旅行プランを表示するために応答する必要がある時間制限を指定します。

  6. サーバーは、新しい料金を定義するトランザクション メッセージで応答します。

  7. Google は Transaction メッセージの料金データでキャッシュを更新します。

プル型料金と変更済み料金について詳しくは、配信モードをご覧ください。

トランザクション メッセージを使用した料金設定

ホテルまたは旅行プラン（チェックイン日と宿泊日数の組み合わせ）の料金を設定するには、旅行プランごとに 1 つの <Result> を含む Transaction メッセージを使用します。

価格を設定する際は、次のガイドラインに従ってください。

  • 料金: 各旅行プランで利用可能な 2 人部屋の最低料金を指定します。Hotel Prices API で設定する料金とサイトに表示される料金が異なると、ユーザーを混乱させ、予約を逃してしまう可能性があります。

  • 宿泊日数: 各旅行プランの滞在費用の合計と 1 泊あたりの料金を指定します。Google が 1 泊の料金を計算します。

  • ポリシー: 料金を設定する際は、Google の料金の精度に関するポリシーを遵守してください。そのため、Google の検索結果に表示される料金は、最終的な予約料金と著しく異なっていない必要があります。

  • すべて込みの料金: 米国とカナダのエンドユーザー向けのリスティングに表示するには、通常、ホテルが税金と手数料を基本料金とは別にする必要があります。詳細については、税金と手数料のポリシーをご覧ください。

  • 丸め: 料金、税金、手数料の値は丸めないでください。

広告枠からホテルを削除する方法については、広告枠の削除をご覧ください。

料金に関するメッセージ

トランザクション メッセージを使用して宿泊プランの料金を変更する場合は、<Result> の次の子要素が必要です。

  • <Property>
  • <Baserate>
  • <Tax>
  • <OtherFees>
  • <Checkin>（旅行プラン）
  • <Nights>（旅行プラン）

トランザクション メッセージには、optionally を使用して <Result> の次の子要素を含めることができます。

  • <AllowablePointsOfSale>
  • <ChargeCurrency>
  • <Custom[1-5]>
  • <RoomBundle>
  • <RoomID>

これらの各要素の詳細については、<Transaction> をご覧ください。

料金の例

次の例では、チェックイン日が 6 月 7 日で 1 泊から 7 泊の 1 部屋の料金（デフォルトの 2 人部屋）を設定しています。

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-08-24T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>1</Nights>
    <Baserate currency="USD">209.99</Baserate>
    <Tax currency="USD">25.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">419.98</Baserate>
    <Tax currency="USD">25.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>3</Nights>
    <Baserate currency="USD">614.97</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>4</Nights>
    <Baserate currency="USD">819.96</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>5</Nights>
    <Baserate currency="USD">999.95</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>6</Nights>
    <Baserate currency="USD">1193.94</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>7</Nights>
    <Baserate currency="USD">1259.93</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
</Transaction>

各トランザクション メッセージには、メッセージの合計サイズが 100 MB を超えない限り、任意の数の <Result> 要素を含めることができます。

料金の更新頻度

価格は、変更があるたびに更新する計画を立ててください。これを行う方法は、料金情報の更新方法としてプル型料金と変更済み料金のどちらを選択したかによって異なります。詳しくは、配信モードの選択をご覧ください。

Google から送信されるライブ料金クエリの頻度と数も設定できます。詳しくは、ライブ料金クエリをご覧ください。

すべて込みの料金

ユーザーの地理的な位置によっては、項目別の料金ではなく、すべて込みの料金の使用を検討することもできます。

すべて込みの料金には、Transaction メッセージの <Baserate> 要素に含まれる客室の基本料金と税金、手数料の合計額が含まれます。Itemized 料金では、料金を <Baserate> 要素、<Taxes> 要素、<OtherFees> 要素に分割します。