料金の概要

ホテルの料金は、指定された宿泊プラン（チェックイン日と宿泊日数の組み合わせ）の 2 人部屋の最低料金です。

概要

ホテルや宿泊プランの組み合わせに定義する料金は、ホテル検索結果の中心となります。料金を最新かつ正確なものにし、競争力のあるものに保つことが非常に重要です。

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

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

料金変更のサイズ

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

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

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

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

価格マトリックス

再価格設定の対象となるホテルと旅程

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

料金を更新する

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

料金を設定するホテルは、初期設定時にホテルリストで定義します。その後、リストが変更されたときに定期的に更新します。
料金が変更された場合のみ: Google はお客様のサーバーにヒントリクエストメッセージを送信します。
料金の変更のみ: サーバーは、料金を変更するホテルと宿泊プランの組み合わせを定義する Hint Response メッセージで応答します。
Google はお客様のサーバーに Query メッセージを送信します。Query メッセージには、Google が料金を必要とするホテルの ID と宿泊プランが含まれます。
ライブ料金クエリの場合、Google は、ホテルまたは宿泊プランが現在のオークションに表示されるために応答する必要がある時間制限を指定します。
お客様のサーバーは、新しい料金を定義するTransaction メッセージで応答します。
Google は、Transaction メッセージの料金設定データでキャッシュを更新します。

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

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

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

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

料金: 各旅程で利用可能な 2 人部屋の最安値を提示します。サイトに表示される料金と異なる料金を Hotel Prices API で設定すると、ユーザーが混乱し、予約の損失につながる可能性があります。
宿泊日数: 各旅行プランの宿泊料金の合計と1 泊あたりの料金を指定します。1 泊あたりの料金は自動で算出されます。
ポリシー: 料金を設定する際は、Google の料金の精度に関するポリシーを遵守してください。そのため、Google の検索結果に表示される価格と最終的な予約価格が大きく異なることはありません。
すべて込みの料金: 米国とカナダのエンドユーザー向けのリスティングに表示されるには、通常、ホテルは基本料金から税金と手数料を分けて表示する必要があります。詳しくは、税金と手数料に関するポリシーをご覧ください。
端数処理: 価格、税金、手数料の値を端数処理しないでください。

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

料金関連メッセージ

Transaction メッセージを使用して旅程の価格を再設定する場合は、<Result> の次の子要素が必須です。

<Property>
<Baserate>
<Tax>
<OtherFees>
<Checkin>（旅程）
<Nights>（旅程）

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

<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> の各要素に分割されます。