定价概览

酒店价格是指指定行程（入住日期和入住晚数）的双人间的最低价格。

概览

您为酒店或行程组合定义的价格是酒店搜索结果的核心。请务必及时更新价格，确保价格准确且具有竞争力。

Google 在显示搜索结果时通常会使用价格缓存中的价格。每当您向 Google 发送包含价格更新的交易消息时，Google 都会缓存这些数据。

Google 还可以针对酒店广告账号向您实时请求更新价格。当用户搜索特定的酒店或行程组合时，Google 可能会向您发送“实时”请求或实时价格查询消息。如果您在指定时间范围内做出回复，则该价格可能会显示在用户请求的行程结果中。Google 还会缓存实时价格查询的结果，以便在日后处理请求时使用。

价格更新的大小

设置房间价格时，您需要提供提前预订和住宿晚数 (LoS) 值，以及这些值与房间 ID 或房价方案 ID 的每个组合的价格。预订和 LoS 值默认为：

  • 最多提前 330 天预订
  • 最多 30 晚的住宿

根据这些一般准则，单个房间的价格最多可能需要 9,900 个单独的条目（330 * 30），每个条目对应一个入住日期和晚数组合。

下表展示了单个酒店的行程数据的一部分。矩阵中包含价格的每个单元格都代表一个入住日期和住宿晚数的行程组合；每个行程都代表 Google 为房源请求的单独值：

哪些酒店和行程会重新定价

Google 提供价格的酒店由您的酒店列表定义。除非停用，否则酒店列表 Feed 中的所有酒店都会使用交易消息或在某些情况下使用实时价格查询进行重新定价。

更新价格

更新价格的一般流程如下：

  1. 您可以在初始设置期间在酒店列表中指定要为其设置价格的酒店，然后在列表发生变化时定期更新。

  2. 仅限价格更改：Google 会向您的服务器发送提示请求消息。

  3. 仅限价格更改：您的服务器会响应一个提示响应消息，其中定义了应重新定价的酒店或行程组合。

  4. Google 向您的服务器发送查询消息。查询消息包含 Google 需要价格的酒店 ID 和行程。

  5. 对于实时价格查询，Google 会指定一个响应期限，您必须在该期限内响应，酒店或行程才能显示在当前竞价中。

  6. 您的服务器会响应一个交易消息，其中定义了新价格。

  7. Google 会使用交易消息中的价格数据更新其缓存。

如需详细了解“拉取”和“价格更改”模式，请参阅传送模式。

使用交易消息进行定价

如需为酒店或行程（入住日期加住宿晚数的组合）设置价格，请使用交易消息，并为每个行程添加一个 <Result>。

设置价格时，请遵循以下准则：

  • 费率：为每条行程提供最低双人入住费率。如果您使用 Hotel Prices API 设置的房价与您网站上显示的房价不同，可能会让用户感到困惑，并导致预订量减少。

  • 晚数：为每个行程指定住宿总费用以及每晚费率。Google 会为您计算每晚费率。

  • 政策：在设置费率时，请遵守 Google 的价格精准政策。这要求 Google 搜索结果中显示的价格与最终的预订价格没有明显差异。

  • 全包式定价：通常，您的酒店必须将税费和其他费用与基本房价分开，才能在面向美国和加拿大最终用户的商家信息中展示。如需了解详情，请参阅税费和其他费用政策。

  • 舍入：请勿舍入价格、税费和费用的值。

如需了解如何从房源中移除酒店，请参阅移除房源。

价格消息

使用交易消息重新定价行程时，<Result> 的以下子元素是必需的：

  • <Property>
  • <Baserate>
  • <Tax>
  • <OtherFees>
  • <Checkin>（行程）
  • <Nights>（行程）

您可以在交易消息中optionally添加 <Result> 的以下子元素：

  • <AllowablePointsOfSale>
  • <ChargeCurrency>
  • <Custom[1-5]>
  • <RoomBundle>
  • <RoomID>

如需详细了解这些元素中的每一个，请参阅 <Transaction>。

价格示例

以下示例设置了入住日期为 6 月 7 日、1 晚至 7 晚的客房（默认双人入住）价格：

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-08-24T16:20:00-04:00" id="42">
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>1</Nights>
    <Baserate currency="USD">209.99</Baserate>
    <Tax currency="USD">25.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>2</Nights>
    <Baserate currency="USD">419.98</Baserate>
    <Tax currency="USD">25.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>3</Nights>
    <Baserate currency="USD">614.97</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>4</Nights>
    <Baserate currency="USD">819.96</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>5</Nights>
    <Baserate currency="USD">999.95</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>6</Nights>
    <Baserate currency="USD">1193.94</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
  <Result>
    <Property>1234</Property>
    <Checkin>2018-06-07</Checkin>
    <Nights>7</Nights>
    <Baserate currency="USD">1259.93</Baserate>
    <Tax currency="USD">21.12</Tax>
    <OtherFees currency="USD">2.00</OtherFees>
  </Result>
</Transaction>

每条事务消息可以包含任意数量的 <Result> 元素，前提是消息的总大小不超过 100MB。

价格更新频率

您应根据价格变动频率来更新价格。具体操作方法取决于您选择的是“拉取”还是“更改价格”方法来更新价格信息。如需了解详情，请参阅选择传送模式。

Google 向您发送实时价格查询的频率和数量也可以进行配置。如需了解详情，请参阅实时价格查询。

全包价

根据用户的地理位置，您可以考虑使用包价而非明细价格。

全包价格包括房间基本费率的总价值，以及交易消息中 <Baserate> 元素中的税费和费用。Itemized 定价会将价格拆分为 <Baserate>、<Taxes> 和 <OtherFees> 元素。