Hint 回應訊息

當 Google 傳送提示要求訊息時，您的伺服器應傳送「提示回應」訊息，其中指明 Google 從上次收到相同伺服器成功傳回 Hint 回應以來，價格已變更的飯店。如果價格有所變動，Google 會傳送 <Query>，擷取指定飯店和行程的更新價格資料。

如需重新定價流程的總覽，請參閱定價總覽。

Hint Response 訊息使用下列方法重新為所選飯店及其行程調整價格：

提示回應訊息的根元素為 <Hint>。您可以使用一或多個 <Item> 元素，要求更新飯店或行程。單一提示回應訊息可定義任意數量的 <Item> 元素。

每則提示回應訊息都必須為每個 <Item> 指定至少一個 <Property> 元素。<Property> 會使用與飯店清單相同的 ID 來識別飯店。根據預設，您必須為每個 <Item> 區塊指定單一飯店 ID。然而，如果您使用入住日期範圍或日期範圍來重新定價，則指示 Google 允許單一項目區塊中的多個飯店。

確切的行程要求與回應流程

提示訊息可以根據個別行程，例如結合入住日期和入住天數。在這種情況下，您可以指定飯店入住日期和入住天數，Google 就會擷取該行程的新價格資料。

合作夥伴的回應

以下提示回應訊息定義了單一屬性和單一行程：

<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 擷取新的價格資料時，會從指定日期開始，擷取飯店每個入住日期的行程，並持續延展到您指定的入住天數。

合作夥伴的日期範圍

下列提示回應訊息範例定義了單一屬性，其中包含入住日期範圍：

<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