Google がヒント リクエスト メッセージを送信すると、お客様のサーバーはヒント応答メッセージで応答する必要があります。このメッセージには、前回 Google が同じサーバーから正常にヒント応答を受信してから料金が変更されたホテルが示されています。料金に変更がある場合、Google は指定されたホテルと旅行プランの更新済み料金データを取得する <Query>
を送信します。
料金変更プロセスの概要については、料金の概要をご覧ください。
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 泊を使用しています。
期間指定滞在のリクエストとレスポンスのフロー
ヒント応答メッセージには、変更された日付の範囲が含まれる場合があります。これにより、これらの日付の影響を受ける宿泊プランを取得するよう 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