当 Google 发送 Hint 请求消息时,您的服务器应使用一条提示响应消息进行响应,指明自 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
入住日期范围请求和响应流程
“Hint Response”消息可以指定入住日期的范围,从第一个入住日期开始,到最后入住日期结束。当 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