提示回應訊息

Google 傳送提示要求訊息時，伺服器應傳回提示回應訊息，指明自 Google 上次收到這些伺服器傳回的成功提示回應後，價格有所變動的飯店。如果價格有任何變動，Google 會傳送 <Query>，擷取指定飯店和行程的最新價格資料。

如要瞭解重新定價程序，請參閱「定價總覽」。

提示回覆訊息會使用下列方法，重新計算所選飯店和行程的價格：

提示回覆訊息的根元素為 <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 晚的住宿天數。預設住宿天數為 30 天。

範圍住宿要求和回應流程

提示回覆訊息可以包含已變更的日期範圍。Google 會根據這些日期擷取受影響的行程。實際擷取的行程組合取決於有變更的日期組合和最長住宿天數。

合作夥伴的住宿範圍

以下範例 Hint 回應訊息使用範圍住宿：

<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