料金の概要

宿泊料金とは、チェックイン日と宿泊日数を組み合わせた特定の旅行プランにおける 2 人部屋の最安料金です。

概要

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

Google では通常、検索結果を表示する際に料金キャッシュの料金を使用します。お客様が Google に料金の更新を含むトランザクション メッセージを送信すると、Google はそのデータをキャッシュに保存します。

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

料金更新のサイズ

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

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

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

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

料金改定の対象となるホテルと旅行プラン

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

料金の更新

料金を更新する一般的な手順は次のとおりです。

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

  2. 変更済み料金のみ: Google はお客様のサーバーにヒント リクエスト メッセージを送信します。

  3. 変更済み料金のみ: サーバーは、料金を変更するホテルまたは旅行プランの組み合わせを定義するヒント レスポンス メッセージを返します。

  4. Google が販売者のサーバーにクエリ メッセージを送信します。クエリ メッセージには、Google が料金を必要とするホテル ID と旅行プランが含まれています。

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

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

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

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

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

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

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

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

  • 滞在日数: 各旅行プランの滞在の合計費用と 1 泊の料金を指定します。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> 要素に分割されます。