Hint 回應訊息

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

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

提示回覆訊息會使用下列方法重新定價所選飯店及其行程：

Hint 回應訊息的根元素為 <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