ヒント応答メッセージ

Google から Hint request message が送信されると、お客様側のサーバーはそれに対し、前回 Google がその同じサーバーから正常に Hint Response メッセージを受信して以降に料金が変更されたホテルを指定する、Hint Response メッセージで応答する必要があります。料金変更があった場合、Google は <Query>を送信して、指定された ホテルと宿泊プランの更新済み料金設定データを取得します。

料金の改定プロセスについて詳しくは、 料金の概要をご覧ください。

ヒント応答メッセージでは、次の方法で選択したホテルとその宿泊プランの料金を改定します。

Hint Response メッセージのルート要素は <Hint> です。更新するホテルや 宿泊プランは、1 つ以上の <Item> 要素を使用してリクエストします。1 つのヒント 応答メッセージでいくつでも <Item> 要素を定義できます。

各 Hint Response メッセージでは、<Item> ごとに少なくとも 1 つの <Property> 要素を 指定する必要があります。<Property> は、 ホテルリストと同じ ID でホテルを指定します。デフォルトでは、<Item> ブロックごとに 1 つのホテル ID を指定します。ただし、チェックイン日期間や期間指定滞在を使用して料金を改定している場合は、1 つのアイテム ブロックに複数のホテルを含めることを許可するよう Google に指示できます。

完全一致宿泊プランのリクエストと応答のフロー

ヒント メッセージは、個々の宿泊プラン（チェックイン日と滞在日数の組み合わせなど）に基づいて作成できます。この場合、ホテルのチェックイン日と滞在日数を指定すると、Google はその宿泊プランについてのみ新しい料金データを取得します。

パートナーの応答

次の Hint Response メッセージでは、1 つの宿泊施設と 1 つの宿泊プランを定義しています。

<Hint>
  <Item>
    <Property>12345</Property>
    <Stay>
      <CheckInDate>2023-05-20</CheckInDate>
      <LengthOfStay>3</LengthOfStay>
    </Stay>
  </Item>
</Hint>

Google の対応

Google は Hint Response メッセージに対し、<Query> 次のようなものを返します。

<Query>
  <Checkin>2023-05-20</Checkin>
  <Nights>3</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

<Transaction> を作成する

これに対し、次の滞在日数でのホテルの料金更新データで <Transaction> を作成する必要があります。

5/20/23 - 5/23/23

チェックイン日の期間のリクエストと応答のフロー

Hint Response メッセージでは、最初のチェックイン日から最後のチェックイン日までのチェックイン日の範囲を指定できます。Google は新しい料金設定データを取得する際、ホテルのチェックイン日がこの期間内に該当する、指定された滞在日数の宿泊プランをすべてプルします。

パートナーの期間指定の日付

次の Hint Response メッセージの例では、チェックイン期間を指定して 1 つの宿泊施設を定義しています。

<Hint>
  <Item>
    <Property>12345</Property>
    <FirstDate>2023-05-20</FirstDate>
    <LastDate>2023-05-23</LastDate>
  </Item>
</Hint>

Google の対応

Google はこの Hint Response メッセージに対し、<Query> 次のようなものを返します。

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <Nights>5</Nights>
  <PropertyList>
    <Property>12345</Property>
  </PropertyList>
</Query>

<Transaction> を作成する

これに対し、次の滞在日数でのホテルの料金更新データで <Transaction> を作成する必要があります。

5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23
5/20/23 - 5/24/23
5/20/23 - 5/25/23

5/21/23 - 5/22/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23
5/21/23 - 5/25/23
5/21/23 - 5/26/23

5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23
5/22/23 - 5/26/23
5/22/23 - 5/27/23

この例では、滞在日数は 5 泊です。デフォルトの滞在日数は 30 日です。

期間指定滞在のリクエストと応答のフロー

Hint Response メッセージには、変更された日付の範囲を含めることができます。このメッセージは、指定された日付の影響を受ける宿泊プランをすべて取得するよう Google に通知します。実際に取得される一連の宿泊プランは、変更された日付一式と最大滞在日数の両方の関数となります。

パートナーの期間指定滞在

期間指定滞在を使用する Hint Response メッセージの例を次に示します。

<Hint>
  <Item>
    <Property>12345</Property>
    <StaysIncludingRange>
      <FirstDate>2023-05-20</FirstDate>
      <LastDate>2023-05-23</LastDate>
    </StaysIncludingRange>
  </Item>
</Hint>

Google の対応

Google は Hint Response メッセージに対し、<Query> 次のようなものを返します。

<Query>
  <FirstDate>2023-05-20</FirstDate>
  <LastDate>2023-05-23</LastDate>
  <AffectedNights>3</AffectedNights>
  <PropertyList>
    <Property>12345</Property>
    <Property>67891</Property>
  </PropertyList>
</Query>

<Transaction> を作成する

これに対し、次の滞在日数での ホテルの料金更新データで <Transaction>を作成する必要があります。

5/17/23 - 5/20/23

5/18/23 - 5/20/23
5/18/23 - 5/21/23

5/19/23 - 5/20/23
5/19/23 - 5/21/23
5/19/23 - 5/22/23

5/20/23 - 5/21/23
5/20/23 - 5/22/23
5/20/23 - 5/23/23

5/21/23 - 5/22/23
5/21/23 - 5/23/23
5/21/23 - 5/24/23

5/22/23 - 5/23/23
5/22/23 - 5/24/23
5/22/23 - 5/25/23

5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23