查询消息是 Google 发出的价格或元数据更新请求。它们可与拉取和价格更改传送模式搭配使用。
查询消息的根元素为 <Query>。
查询消息的结构取决于消息类型：
价格：Google 发送查询消息，请求更新指定酒店的价格。
元数据：Google 会发送查询消息，请求指定酒店的客房和套餐信息数据。
您可以在初始配置期间定义 Google 用于查询消息和实时价格查询的端点。如需了解详情，请与您的技术支持客户经理 (TAM) 联系。
Google 会将查询消息作为 HTTP POST 请求发送，并将 Content-Type 标头设置为“application/xml”，将 User-Agent 标头设置为 Google-HotelAdsPrices。通过 Google-TravelAds-Live 手动测试价格端点集成时，会出现此规则的例外情况。这些示例查询可能包含 User-Agent 标头，也可能不包含。
如需详细了解查询消息的格式，请参阅查询 XML 参考文档。
价格查询消息
价格查询消息用于指定您要为其提供价格的房源和行程组合。
当您的服务器收到价格查询消息时，应响应一个包含请求的价格信息的 <Transaction> 消息。
如需了解详情，请参阅价格概览。
查询消息有三种特殊类型：
实时价格：如果启用此功能，当用户正在积极浏览指定房源或行程组合的价格时，系统会发送查询，并且您有指定的时间范围来响应。
启用情境：启用此功能后，Google 会在向您发送的每个查询中包含用户情境建议，这些建议反映了搜索给定房源或行程组合的最常见用户类型。遵循以下建议可以提高回复效率。
元数据：此请求用于获取指定房源的客房和套餐的详细信息。
实时价格查询
实时价格查询是 Google 发出的请求，旨在根据用户搜索情况获取实时价格更新。Google 收到用户针对酒店或行程组合的搜索请求，但由于价格数据不可用或不是最新的，Google 会在用户搜索时向您请求价格更新。通过实时价格查询，Google 会尝试获取价格，并在用户搜索时在结果中显示价格。
所有实时价格查询请求都有响应时间限制，通常不超过 4000 毫秒。此限制在实时价格查询请求中指定。如果未能在规定时间内提供回复，则会导致错失参与特定机会的机会。不过，我们还是建议您提供价格，以便系统将其缓存起来，以备日后使用。响应的连接会保持打开状态 10 分钟或合作伙伴配置中指定的时间。
实时价格查询也具有上下文，可以检索以下参数的价格：用户所在国家/地区、设备类型、入住人数（房客人数），以及这些房客是成人还是儿童。借助实时价格查询，您可以显示与客户搜索内容相符的最新价格。
实时价格查询是价格更新的辅助机制。重新定价的主要机制仍然是“拉取”或“更改”定价。实时价格查询有助于填补 Google 没有酒店或行程组合价格的空白。
使用实时价格查询的规则
由于所请求的行程不典型（例如日期非常遥远，或者酒店的搜索次数非常少），因此没有给定行程的缓存数据。
所请求的日期是非默认日期。
注意：默认日期不符合实时价格查询的条件。系统仅会针对非默认日期请求实时价格查询。
Google 通常会缓存实时价格的结果，以免再次查询同一酒店或行程。它可以请求单个酒店或行程组合，也可以请求多家酒店或单个行程组合。
借助包含情境信息的实时价格功能，Google 可以根据用户的设备类型、用户搜索时所在的国家/地区以及入住人数（包括儿童）发送特定的实时价格请求。查询消息和交易消息都会展开，以包含用于定义查询参数的 <Context> 元素。如果从包含上下文的实时定价查询收到的价格是针对特定入住人数的价格，则可以将其缓存为客房套餐；如果是针对用户所在国家/地区或用户设备的价格，则可以将其缓存为条件式费率。
使用情境查询
上下文查询是定期请求，用于更新指定房源或行程组合的数据库。其中包含适用于这些组合的热门用户情境列表。如果使用条件式费率，则发送所有可能的用户情境的费率可能会很昂贵，因此您可以使用此用户情境列表来限制响应。仅针对指定用户情境返回价格即可涵盖绝大多数相关用户查询。
如果您有意接收包含上下文的查询，请与您的技术支持客户经理 (TAM) 联系。他们可以确认您是否已准备好接收此类消息，然后进行配置调整，以便开始向您发送查询中的用户上下文。
元数据查询消息
元数据查询消息包含有关指定房源的客房和套餐信息的详细信息。
收到元数据查询消息后，您应响应 <Transaction> 消息，在 <Result> 元素中指定请求的房源的价格。
如需了解详情，请参阅定义房间和软件包元数据。
控制查询
本部分介绍了如何控制哪些房源和行程可以成为 Google 发送的查询消息的主题。
行程边界
您可以使用 <ItineraryCapabilities> 确定价格查询的可能边界。您可以定义规则来确定您支持的日期范围和最长入住晚数。
您可以为 <MaxAdvancePurchase> 和 <MaxLengthOfStay> 设置适用于所有酒店或行程组合的默认值。您还可以为酒店组定义这些设置。
查询消息示例
本部分展示了多个价格查询消息和元数据查询消息示例。如需查看其他示例，请参阅 Query XML 参考文档。
行程示例
以下示例显示了价格 <Query>，用于请求更新 4 家酒店的价格，入住晚数为 3 晚，开始日期为 2023 年 5 月 23 日：
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<Checkin>2023-05-23</Checkin>
<Nights>3</Nights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
以下示例请求更新每家酒店的价格：
5/23/18 - 6/26/18
实时价格查询示例
以下示例展示了一个响应时间限制为 500 毫秒的实时价格查询：
<?xml version="1.0" encoding="UTF-8"?>
<Query latencySensitive="true">
<!-- Note that the latencySensitive attribute is not present by default but can
be configured to be displayed, on request, by Google. This attribute is only
displayed for a Live Pricing Query request -->
<Checkin>2023-05-23</Checkin>
<Nights>2</Nights>
<DeadlineMs>500</DeadlineMs>
<!-- The deadline represents the timeframe by which a response will need to be
received by. This element is only displayed for a Live Pricing Query request -->
<PropertyList>
<Property>6781291</Property>
</PropertyList>
<!-- Note that Context tags are potentially repeatable -->
<Context>
<!-- The total number of guests occupying the room (adults+children) -->
<Occupancy>3</Occupancy>
<OccupancyDetails>
<NumAdults>2</NumAdults>
<!-- In this example one of the 3 guests is a 5yr old child -->
<Children>
<Child age="5"/>
</Children>
</OccupancyDetails>
<!-- The user was located in the US when this search was made -->
<UserCountry>US</UserCountry>
<!-- The user was searching from a mobile device at the time of search -->
<UserDevice>mobile</UserDevice>
</Context>
</Query>
以下示例请求单个酒店的价格：
6/23/23 - 6/25/23
如需查看针对此查询的示例交易消息响应，请参阅价格和客房空房情况（交易）XML 参考。
包含上下文的查询示例
以下示例展示了 With Context 查询示例：
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<Checkin>2023-05-23</Checkin>
<Nights>2</Nights>
<PropertyContextList>
<PropertyContext>
<Property>8675309</Property>
<!-- In the future, occupancy and device might be specified -->
<Context><UserCountry>US</UserCountry></Context>
<Context><UserCountry>GB</UserCountry></Context>
</PropertyContext>
<PropertyContext>
<Property>8675310</Property>
<Property>8675311</Property>
<Context><UserCountry>CA</UserCountry></Context>
</PropertyContext>
</PropertyContextList>
</Query>
使用上下文查询时，仅指定用户所在的国家/地区上下文。未来，此类查询可能还会指定用户设备和入住人数。
入住日期范围
如果您使用“价格已更改”功能，则查询消息的结构取决于您为入住日期范围、确切行程或范围行程使用的提示类型。如需详细了解每种提示类型，请参阅提示响应消息。
以下示例展示了针对入住日期范围的价格 <Query> 消息：
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<FirstDate>2023-05-23</FirstDate>
<LastDate>2023-05-26</LastDate>
<Nights>3</Nights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
以下示例请求更新以下住宿（针对每家酒店）的价格：
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/24/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23
范围住宿
以下示例展示了针对价格范围型住宿的价格 <Query> 消息：
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<FirstDate>2023-05-23</FirstDate>
<LastDate>2023-05-26</LastDate>
<AffectedNights>3</AffectedNights>
<PropertyList>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</PropertyList>
</Query>
以下示例请求更新每家酒店的价格：
5/23/23 - 5/24/23
5/23/23 - 5/25/23
5/23/23 - 5/26/23
5/24/23 - 5/25/23
5/24/23 - 5/26/23
5/24/23 - 5/27/23
5/25/23 - 5/26/23
5/25/23 - 5/27/23
5/25/23 - 5/28/23
在指定日期之前（包括该日期）开始的 Plus 住宿：
5/20/23 - 5/23/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
元数据查询消息
以下示例展示了一个 <Query> 消息，用于请求更新多个房源的客房和套餐信息的元数据：
<?xml version="1.0" encoding="UTF-8"?>
<Query>
<HotelInfoProperties>
<Property>pid5</Property>
<Property>pid8</Property>
<Property>pid13</Property>
<Property>pid21</Property>
</HotelInfoProperties>
</Query>
您可以使用用于定义房间和文件包元数据的 Transaction 消息来响应此类 Query 消息。如需了解详情，请参阅定义房间和软件包元数据。