提示回复消息

当 Google 发送提示请求消息时，您的服务器应响应一个提示响应消息，其中指定自上次 Google 从这些服务器成功收到提示响应以来价格发生变化的酒店。如果价格发生任何变化，Google 会发送 <Query> 以提取所指酒店和行程的更新价格数据。

如需大致了解重新定价流程，请参阅价格概览。

提示响应消息使用以下方法重新为所选酒店及其行程定价：

Hint 回应消息的根元素为 <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 晚。默认的住宿晚数为 30 晚。

范围型住宿请求和响应流程

提示回复消息可以包含已更改的日期范围。这会告知 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