Hint Response メッセージ

Google がヒント リクエスト message とした場合、サーバーは は、ユーザーが予約したホテルを指定したヒント応答メッセージで応答する必要があります。 Google が前回正常にヒントを受け取ってから、料金が変更されている 同じサーバーからのレスポンスです。料金に変更があった場合は <Query> を送信し、指定された ホテルと旅行プラン

料金変更プロセスの概要については、 料金の概要

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

で確認できます。

Hint Response メッセージのルート要素は <Hint> です。ホテルまたはレストランを 1 つ以上の <Item> 要素を使用して更新する旅行プラン。単一のヒント レスポンス メッセージでは、任意の数の <Item> 要素を定義できます。

各ヒント レスポンス メッセージでは、メッセージに対して少なくとも 1 つの <Property> 要素を指定する必要があります。 毎週<Item>。<Property> は、 ホテルリストデフォルトでは、<Item> ごとに 1 つのホテル ID を指定します。 ブロックします。ただし、1 つの商品アイテムで複数のホテルを許可するように 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 泊を使用しています。

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

ヒント応答メッセージには、変更された日付の範囲を含めることができます。この これらのホテルのいずれかによって影響を受ける旅行プランを取得するよう Google に指示する できます。実際に取得される旅行プランのセットは、両方の機能 最大宿泊日数を変更できます。

パートナーの長期滞在

次のヒント レスポンス メッセージの例では、期間指定滞在を使用しています。

<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