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