Google がヒント リクエスト メッセージを送信すると、お客様のサーバーは、前回 Google が同じサーバーから正常にヒント レスポンスを受信してから料金が変更されたホテルを指定するヒント レスポンス メッセージで応答する必要があります。料金に変更があった場合は、指定されたホテルと旅行プランの更新された料金データを取得する <Query>
が送信されます。
料金変更プロセスの概要については、料金の概要をご覧ください。
ヒント レスポンス メッセージでは、以下のメソッドを使用して、選択したホテルとその旅行プランの料金を変更します。
ヒント応答メッセージのルート要素は <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