给消息评分

概览

“价格”消息 (OTA_HotelRateAmountNotifRQ) 指定每晚 特定日期各种客房类型和费率方案组合的入座率 范围。在“费率消息”中，Google 支持根据入住人数定价 允许根据 预计居住者人数。

以下各部分涵盖一般指南、一个基本示例和具体方法 帮助您开始添加和更新费率， 为消息评分。

匹配率行为

当用户请求具体入住人数时，他们看到的费率取决于 定义价格的方式。本部分将介绍 用户请求与您的房价相匹配，具体取决于他们的入住人数 以及您定义的费率

主要原则

  • 为特定入住人数定义的费率适用于所有入住人数较少的入住人数， （除非另有规定）。

  • 我们不接受超出所定义入住人数的请求。

  • 基于入住人数的价格适用于按日期的价格和基于 LOS 的价格 价格模式。也就是说，您可以为每一项 入住人数如果没有适用于特定入住人数的费率， 使用第二高的入住人数。您还可以为以下各项定义费用： 其他访客和儿童（使用 AdditionalGuestAmounts） 或 ExtraGuestCharges 最高可容纳为会议室定义的可容纳人数。

优势和示例

效率

对于费率金额相同的多个入住人数，您不需要设置 和每人入住的费率。您可以仅设置 客房类型和费率方案支持的最高入住人数值。 对于不超过您设置的入住人数，用户都会看到该费率 值。

示例：对于以下酒店，不同客房类型和价格方案的费率相同： 1 到 4 人。使用“费率”消息设置最高费率 4 人入住。搜索单人、双人和三人入住的用户 也会看到同样的比率搜索价格为 5 及以上的用户不会看到房价。

控制

您可以明确提供其他入住人数的单独费率。发送 如果您希望进一步控制 Google 会将请求与入住率进行匹配。

示例：如果定义了入住 3 人和 1 人入住的费率，则单人入住 搜索内容会显示单人入住比率，而对于双人住宿，则会显示单人间费率 而搜索 4 人及以上人数的用户则不会看到 。

有关各种费率相关情形的更多示例，请参阅 方法指南。

必需元素和可选元素

XML 参考 用于提供必需元素和可选元素的说明。如需详细了解 属性和子元素，请参见费率元素和 属性。

语法和架构

使用费率语法 创建“Rate”（费率）消息时作为参考 格式是否正确

您可以使用第三方 XML 工具（如 xmllint）来验证 Feed， 将已发布的架构提交给 Google。对于“评分”消息 请参阅酒店广告架构。

价格模式

按日期定价

这是大多数房源使用的标准定价模式。per-date 价格模式以设置费率为基础，设置费率是按入住天数汇总的 最终得到总价在此模型中，Rate 元素下的所有房价都是 解读为适用于 <StatusApplicationControl>。

基于 LOS 的价格

基于 LOS（住宿晚数）的定价模式基于为 到达日期和住宿晚数的组合。下 基于 LOS 的价格模式是按天计算的。例如，如果您发送的费率为 100 美元 如果住宿晚数为 3，则总价的计算公式为：3x$100=$300。

如果要使用基于 LOS 的价格模式，只需指定 对 StatusApplicationControl 元素执行 RatePlanType="26" 操作。您还需要 为代码中的 Rate 元素设置 RateTimeUnit 和 UnitMultiplier 属性 XML。这会使指定 Rate 元素下的所有房价都适用于住宿 由 <StatusApplicationControl> 中指定的到达日期和 为“UnitMultiplier”指定了 LOS 值。

您可以在单个 但每个媒体资源应只使用一种定价模式。 实施基于 LOS 的价格时，请牢记以下几点：

  • 使用基于 LOS 的费率时，不同住宿晚数的费率不会合并 定价。例如，如果 LOS 率为 3，则不会与 LOS 为 1 才能将 LOS 费率设置为 4。LOS 率 4 必须明确 。
  • 基于 LOS 的价格中的 1 晚房价不会用作单晚房价 按日期定价
  • 每个房源应仅使用基于 LOS 的价格或按日期 具体取决于费率在系统中的表示方式。

如需为您的账号启用基于 LOS 的价格，请通过您的 TAM 提出申请 或与我们联系。

指南或操作

按日期定价

Delta：仅添加或更新指定日期的每人入住费率 中所指定的房间类型、价格方案和住宿日期的组合， <StatusApplicationControl>。

  • 默认情况下，房价更新会使用 Delta 操作。
  • Delta 更新不会更改之前存储的 入住人数。例如，如果您为单个客户 双人间，并发送单人间Delta费率更新 入住人数，则双人入住费率保持不变。

Overlay：删除相应客房类型的所有现有每人入住费率。 和 <StatusApplicationControl> 中指定的日期，并替换 为其分配新的费率例如，如果您为单个客户 双人间，且您发送了单人入住的Overlay最新动态 则 Google 将删除所有以前的房价（单人间和双人间） 入住人数），且更新后仅保留单人入住费率。

Remove：删除相应客房类型的所有现有每人入住费率。 价格方案以及在 <StatusApplicationControl> 中指定的日期。

基于 LOS 的价格

Delta：仅对指定的每个 LOS 值添加或更新费率 指定的客房类型、价格方案和入住日期的组合， <StatusApplicationControl>。替换所有关联的每人入住费率 更新后的 LOS 值。

  • 默认情况下，房价更新会使用 Delta 操作。
  • Delta 更新不会更改之前存储的 住宿晚数。例如，如果您为 LOS 1 和 2 指定了费率， 并发送 LOS 1 的 Delta 费率更新，然后发送 LOS 2 的单人入住费率 保持不变
  • Delta更新会覆盖之前存储的所有入住费率 指定的住宿晚数。例如，如果您指定了单个和 LOS 1 的双人入住费率，并发送 LOS 1 的 Delta 费率更新 如只有单人入住费率，则系统将移除双人入住费率。

Overlay：删除 LOS 会议室所有现有的每人入住费率 <StatusApplicationControl>中指定的类型、价格方案和入住日期 并将其替换为新费率例如，如果您为 LOS 1 和 2，并且您针对 LOS 1 发送了 Overlay 更新，Google 将移除 所有之前的费率（LOS 1 和 2），只有 LOS 1 费率将保持不变 。

Remove：删除 指定客房类型、价格方案和入住日期 <StatusApplicationControl>。

与税务相关

如果税费和其他费用很简单，则可以使用 AmountAfterTax。复杂的税费，例如针对不同国家/地区的税费和其他费用 无法在 AmountAfterTax 中表示住宿晚数（而非每晚住宿费用）。

通常，Google 建议您使用 TaxFeeInfo，而不是 AmountAfterTax。

如果可能，您应添加 AmountBeforeTax（即使您指定了 AmountAfterTax），因为某些语言区域（例如美国）会显示 税前价格。

用户必须支付的所有税费和其他费用（增值税、住宿税、清洁费、城市） 税费等）。 直接支付给了媒体资源。

示例

本部分提供了“费率”消息的基本示例，该消息使用必需的和 可选元素。准备好文件后，您必须使用 将 POST 消息发送到以下端点： https://www.google.com/travel/hotels/uploads/property_data

如需详细了解如何推送/发布消息，请参阅推送消息。

对于 HotelCode，请使用您在系统中用于 来标识该媒体资源此值必须与使用 <listing> 元素中的 <id> 。对于 <PackageID> 和 <RoomID>，请使用 在您的系统中分别用于房价方案和客房类型。节奏稳定 这对确保 Google 正确显示 您的价格和数据

以下示例展示了如何使用 Delta 操作设置房价：

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                            EchoToken="12345678"
                            TimeStamp="2022-02-25T20:50:37-05:00"
                            Version="3.0"
                            NotifType="Delta">
  <POS><Source><RequestorID ID="partner_key" /></Source></POS>
  <RateAmountMessages HotelCode="HotelID">
    <RateAmountMessage>
      <StatusApplicationControl Start="2022-12-01"
                                End="2022-12-31"
                                InvTypeCode="RoomID"
                                RatePlanCode="PackageID" />
      <Rates>
        <Rate>
          <BaseByGuestAmts>
            <BaseByGuestAmt NumberOfGuests="1" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="2" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="3" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
            <BaseByGuestAmt NumberOfGuests="4" CurrencyCode="USD" AmountBeforeTax="XXX.XX" />
          </BaseByGuestAmts>
        </Rate>
      </Rates>
    </RateAmountMessage>
</OTA_HotelRateAmountNotifRQ>

方法指南

本部分针对您在发送信息时可能遇到的情景提供了解决方案。 为消息评分。

如需有关如何添加、移除和更新费率的示例，请参阅费率 示例。

场景 1：如何更改按入住人数定价

说明

每晚房价以前定义为双人间（也 适用于单人入住），但现在适用于单人入住的费率更低 入住人数

解决方案

使用默认的 Delta 范围更新发送新的入住人数 1 费率。这种新的 值不会影响“入住人数 2”费率。

场景 2：如何替换房源的单人入住费率

说明

您之前为入住 1 至 4 人定义了费率，但现在仅 入住人数 1 和 2 都有效。

解决方案

使用 NotifType="Overlay" 替换指定房源的所有入住费率， 客房类型、价格方案和日期。在这种情况下，Overlay 操作会 列出入住人数 1 和 2 的费率。

场景 3：如何为多人入住设置相同的房价

说明

特定入住人数对应的费率可销售给人数较少的群组。在本课中， 您可以只发送以下商品的费率更新，以简化您的邮件 适用入住人数上限。

解决方案

如果有多人入住的价格相同，请设置最高入住人数 该值，系统会自动 将该值用于入住人数较少的情况。也就是说，无需重复 入住 1-6 人入住的每晚价格（如果所有人数均相同）；只需将它设为 6 即可。