交易消息概览

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

  1. 行程数据：定义客房套餐和行程数据，包括：

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

    • 客房套餐：为实体客房与一揽子附加服务的组合设置行程价格。如需了解详情，请参阅 Room 软件包。 Google 会缓存交易消息的内容，以便随时提供价格。在某些情况下，Google 会确定其缓存中的值已过时，因此可能会发送额外的 <Query> 消息（在某些情况下，还会发送实时价格查询）以获取更新后的价格。这些数据通常会非常频繁地更改。如需定义交易消息的价格和空房情况，请使用 <Result>。

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

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

如需查看回复 Google 请求的交易消息示例，请参阅价格和客房空房情况（交易）XML 参考。

分发模式

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

  • 对于拉取式传送模式，您可以在收到 Google 发送的 <Query> 时发送交易消息。
  • 对于“价格更改”传送模式，您可以在收到 <HintRequest> 和 <Query> 并做出回复后发送交易消息。

如需了解详情，请参阅价格传送模式。

实时价格查询

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

邮件大小

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

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