Hint 回應訊息

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

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

Hint Response 訊息會使用以下方法為所選飯店重新房價 與其行程:

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

每則提示回應訊息都必須指定至少一個 <Property> 元素 每個 <Item><Property> 會使用與 飯店清單。根據預設,您必須為每個「<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 回應訊息範例定義了含有 入住日期的日期範圍:

<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 回應訊息使用了區間停留時間:

<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