Hint Response メッセージ

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

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

Hint Response メッセージでは、選択したホテルとその宿泊プランの料金を次の方法で変更します。

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

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

完全一致旅行プランのリクエストとレスポンスのフロー

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

パートナーの回答

次のヒント応答メッセージでは、1 つの宿泊施設と 1 つの旅行プランを定義しています。

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

Google の対応

Google はヒント応答メッセージに対し、次のような <Query> を返します。

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

<Transaction> の作成

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

5/20/23 - 5/23/23

チェックイン期間のリクエストとレスポンスのフロー

ヒント応答メッセージでは、最初のチェックイン日から最後のチェックイン日までのチェックイン日の範囲を指定できます。Google が新しい料金データを取得すると、そのホテルのチェックイン日ごとに、指定した滞在日数までの宿泊プランが取得されます。

パートナーの期間

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

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

Google の対応

Google はこのヒント応答メッセージに対し、次のような <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 日です。

期間指定滞在のリクエストとレスポンスのフロー

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

パートナーの宿泊期間

期間指定滞在を使用するヒント応答メッセージ age の例を次に示します。

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

Google の対応

Google はヒント応答メッセージに対し、次のような <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