Hint 回應訊息

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 擷取新的價格資料時，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