交易消息概览

交易消息会将有关客房、价格和套餐的数据发送给 Google。 交易消息主要有两种类型:

  1. 行程数据:定义客房套餐和行程数据,包括:

    • 酒店价格和房源:为符合特定要求的行程设置最低价格。如需了解详情,请参阅更新价格。 您还可以从房源中移除房间。如需了解详情,请参阅移除商品目录

    • 客房套餐:为实体客房与附加服务套餐的组合设置行程价格。如需了解详情,请参阅聊天室套装。 Google 会缓存交易消息的内容,以便随时提供价格信息。在某些情况下,Google 会确定其缓存中的值不是最新值,因此可能会发送额外的 <Query> 消息(或在某些情况下,发送实时价格查询)来获取更新后的价格。此类数据通常变化非常频繁。如需定义交易消息的价格和供应情况,请使用 <Result>

  2. 客房和套餐元数据:指定有关客房和套餐的详细信息,例如说明、照片和最多入住人数。这些数据不会经常更改。如需定义元数据事务消息,请使用 <PropertyDataSet>。Google 会存储这些元数据,以便您在价格信息中引用它们,而无需在每条价格信息中都包含有关客房和套餐的重复信息。如需了解详情,请参阅定义房间和软件包元数据

交易消息的根元素是 <Transaction>。使用 <Transaction> 元素作为根元素的消息需要至少一个子元素。交易消息可以包含任意数量的子元素,只要消息总大小不超过 100MB 即可。

如需查看针对 Google 请求的交易消息响应示例,请参阅价格和客房空房情况(交易)XML 参考

分发模式

您发送交易消息的类型和频率取决于您的交付模式:

  • 对于拉取交付模式,您会在收到 Google 发送的 <Query> 时发送交易消息。
  • 对于价格更改传送模式,您会在收到 <HintRequest><Query> 并做出响应后发送交易消息。

如需了解详情,请参阅价格交付模式

实时价格查询

无论您采用哪种传送模式,Google 也可能会向您发送称为实时价格查询的请求。这些 Query 消息旨在响应当前搜索来寻求价格。如果您在指定的时间范围内(通常为几百毫秒)做出响应,则您的广告可以参与竞价。 您的搜索结果还可以更好地匹配客户,包括其所在国家/地区和设备类型,以及他们指定的房客人数。如需了解详情,请参阅实时价格查询

邮件大小

您可以在单个交易消息中包含任意组合的数据更新,但每条消息的大小不得超过 100MB。通常,所有拉取请求和提示请求的响应时间限制为 100 秒。此超时时间是一个可配置的字段,可根据要求由 Google 进行调整。Google 建议您将超时时间设置为 10 分钟,以处理非常大的消息。

为了大幅缩减消息大小,并可能避免消息大小和超时问题,请使用交易消息预先定义您的客房和套餐元数据。 您还可以通过向消息标头添加 Content-Encoding: gzip,将 GNU 压缩内容添加到消息中。