料金の概要

ホテルの料金は、チェックイン日と宿泊日数を組み合わせた特定の旅行プランの 2 名 1 室利用時の最低料金です。

概要

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

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

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

料金改定の規模

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

  • 最大 330 日間の事前予約
  • 最大 30 泊

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

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

料金が改定されるホテルと旅行プラン

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

料金を更新する

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

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

  2. 料金の変更のみ: Google からお客様のサーバーに ヒント リクエスト メッセージが送信されます。

  3. 料金の変更のみ: お客様のサーバーは、料金を変更するホテルまたは旅行プランの組み合わせを定義する Hint Response メッセージで応答します。

  4. Google はお客様のサーバーに Query メッセージを送信します。Query メッセージには、Google が料金情報を必要とするホテル ID と旅行プランが含まれます。

  5. ライブ料金クエリの場合、ホテルまたは宿泊プランが現在のオークションに表示されるようにするには、応答しなければならない時間制限が Google によって指定されます。

  6. お客様のサーバーは、新しい料金を定義する Transaction メッセージで応答します。

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

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

Transaction メッセージによる料金設定

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

料金を設定する際は、次のガイドラインを参考にしてください。

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

  • 宿泊日数: 各旅行プランの宿泊料金の合計と1 泊あたりの料金を指定します。1 泊あたりの料金は自動的に計算されます。

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

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

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

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

料金関連メッセージ

Transaction メッセージを使用して旅行プランの料金を変更する場合は、<Result> の次の子要素が必須です。

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

optionallyTransaction メッセージには、<Result> の次の子要素を含めることができます。

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

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

料金の例

次の例では、6 月 7 日のチェックイン日で、1 ～ 7 泊の客室（デフォルトの定員 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 から送信されるライブ料金クエリの頻度と数も設定できます。詳細については、ライブ料金クエリをご覧ください。

すべて込みの料金

ユーザーの地理的位置によっては、個別料金ではなく、オール インクルーシブ料金の使用を検討してください。

オールインクルーシブ料金には、客室の基本料金の合計額と、トランザクション メッセージの <Baserate> 要素の税金と手数料が含まれます。Itemized の料金は、<Baserate>、<Taxes>、<OtherFees> の各要素に分割されます。