交易（媒体资源数据）消息

概览

ARI 交易（房源数据）消息定义了有关每个房源的客房类型和套餐（或费率方案）的信息。每种客房类型数据都包含唯一标识符 (RoomID)、本地化名称、说明和房间照片的网址。每个软件包数据都包含唯一标识符 (PackageID)、本地化名称、说明、入住人数和附加价值。

您可以使用 Transaction 消息执行以下操作：

• 为一个或多个媒体资源定义数据。
• 为每个房源定义客房类型和套餐信息。
• 控制提供的产品。

此外，您还可以设置用于执行以下操作的操作：

• 为房源添加客房类型和套餐。
• 从房源中移除客房类型和套餐。

如需查看交易消息的示例，请参阅交易（房源数据）示例。

必需元素和可选元素

XML 参考提供了必需元素和可选元素的说明。如需详细了解属性和子元素，请参阅交易（房源数据）元素和属性。

语法和架构

创建交易消息时，可参考交易（房源数据）语法示例作为参考，以确保采用正确的格式。

在将 Feed 提交给 Google 之前，您可以使用第三方 XML 工具（如 xmllint）使用已发布的架构来验证这些 Feed。如需了解交易消息架构，请参阅酒店广告架构。

指南

对于交易消息，请遵循以下准则：

操作：

delta：用于添加或更新新的客房类型和套餐（费率方案）。

overlay：用于将房源的所有客房类型和套餐替换为新集合。必须包含您仍想销售的所有客房类型和费率方案的信息。

语言支持：

为“名称”“说明”和“图片说明”字段指定一到两种语言（英语，并根据需要为媒体资源指定当地语言）。如果需要，您可以添加两种以上的语言。

客房类型和套餐：

更新客房类型或套餐时，您必须发送该客房类型或套餐的所有相关信息。例如，添加照片时，您还必须添加名称和说明。

<AllowablePackageIDs> 和 <AllowableRoomIDs> 是可选的，如果未设置，则可以任意组合客房类型和费率方案。您仍然需要发送客房类型和费率方案 ID 的空房情况和房价信息。您可以利用这些元素控制商品，以及停用系统不再支持的组合。

每当客房类型或套餐发生变化，或者有关需要添加的客房类型或套餐的重要详细信息发生变化时，都会向 Google 发送交易消息更新。

注意 ：由于 Google 会存储与“匹配”媒体资源相关联的房源数据，因此只有在相应的房源在系统中与“匹配”匹配之后，Google 才能接受这些数据。发送列表 Feed 中的所有房源有助于防止以后出现错误或延迟。

示例

本部分提供了一个使用必需元素和可选元素的 ARI 交易消息的基本示例。如需添加或更新客房类型和套餐，您可以使用 delta 添加或更新客房类型和套餐，也可以使用 overlay 替换所有客房类型和套餐定义（删除旧条目）。

您需要为“名称”“说明”和“图片说明”字段指定一到两种语言（英语，并根据需要为媒体资源指定当地语言）。然后，添加房源数据信息，包括照片的链接。

对于 <PropertyID> 和 <RoomID>，请分别使用您在系统中用于费率方案和房间类型的 ID。与系统保持一致对于确保 Google 正确显示您的价格和数据至关重要。

注意 ：Google 使用“ID”作为客房类型和套餐（费率方案）的标识符，而 OTA XML 则使用“code”。您必须使用自己的 ID，因为 Google 不会生成这些 ID。对于房源数据，每个房源的客房类型和费率方案 ID 必须是唯一的。

准备好文件后，您必须通过 POST 消息将该文件发送到以下端点：https://www.google.com/travel/hotels/uploads/property_data

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

以下示例展示了如何使用 delta 操作设置事务消息：

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="202X-XX-XXT00:00:00-0X:00" id="12345678" partner="partner_key">
  <PropertyDataSet action="delta">
    <Property>PROPERTYID</Property>
      <RoomData>
        <RoomID>ROOMID</RoomID>
        <Name><Text text="ROOM NAME" language="en"/></Name>
        <Description>
          <Text text="ROOM DESCRIPTION TEXT" language="en"/>
        </Description>
        <Capacity>4</Capacity>
        <PhotoURL>
          <Caption><Text text="ROOM PHOTO CAPTION TEXT" language="en"/></Caption>
          <URL>https://LINK TO PHOTO</URL>
        </PhotoURL>
      </RoomData>
      <PackageData>
        <PackageID>BASE</PackageID>
        <Name><Text text="Internet Special" language="en"/></Name>
        <Description><Text text="Direct Booking through Hotel Website" language="en"/></Description>
        <Refundable available="true" refundable_until_days="2" refundable_until_time="12:00"/>
      </PackageData>
  </PropertyDataSet>
</Transaction>

如需查看更多示例，例如如何使用 overlay 操作、向现有房源数据添加客房类型和套餐以及移除现有客房类型和套餐，请参阅交易（房源数据）示例。

方法指南

本部分介绍了您在发送事务消息时可能遇到的场景的解决方案。

场景 1：如何移除客房类型数据

如何移除现有的客房类型和/或套餐数据？

说明

您为房源发送了多种房型，包括特大号房和大号房。在改造期间，所有大号客房类型均不可使用，目前仅提供特大号床房型。

解决方案

• 您无需为已移除或停用的客房类型和套餐 ID 更新每晚空房情况、房价或空房数量。
• 如果客房类型或套餐已被移除或停用，请发送一条包含 action="overlay" 的新交易消息，其中仅包含仍然有效的客房类型和套餐，并排除已移除的客房类型或套餐。

示例

以下 XML 代码段展示了如何使用 overlay 操作移除客房类型。

注意 ：尽管此示例涵盖了房间类型，但您也可以使用相同的操作移除软件包数据。

下面是最初的 delta 操作，其中包括特大号和大号房型：

  <PropertyDataSet action="delta">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
      </PackageData>
    <RoomData>
      <RoomID>Queen</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <Capacity>2</Capacity>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
  </PropertyDataSet>

然后，您可以设置 overlay 以移除大号房类型并保留特大号房类型：

  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>King</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Capacity>2</Capacity>
    </RoomData>
    <PackageData>
      <PackageID>Standard</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>

场景 2：如何使用 allowablePackageID 控制商品

按客房类型分组时，如何控制产品（房型和套餐组合）？

注意 ：如果您的客房类型是按套餐分组的，请参阅场景 3。

说明

您有一些套餐只面向特定客房类型提供。例如，如果您的房源有 4 种房间类型（包括总统套房）和 6 个不同的套餐，但只有少数套餐符合总统套房使用的条件，您可以指定资格条件。

解决方案

使用 <AllowablePackageIDs> 发送更新后的 Transaction 消息，指定软件包中包含哪些产品。

注意 ：请使用 <AllowablePackageIDs> 或 <AllowableRoomIDs>，但不能同时使用这两者，您使用的元素取决于您的系统是使用层次结构 Room>package 还是 package>room。如果交易消息中均未定义这两个元素，则客房类型可与任何套餐结合使用。

示例

此 XML 代码段展示了如何使用 <AllowablePackageIDs> 指定用于特定房间类型的套餐。在这里，顶层套房客房类型仅提供顶层全包房套餐或免费早餐套餐，而国王套房客房类型仅提供国王全包房套餐或宠物友好套餐。

<RoomData>
  <RoomID>penthouse_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>penthouse_all_inclusive</AllowablePackageID>
    <AllowablePackageID>free_breakfast</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<RoomData>
  <RoomID>king_suite</RoomID>
  <AllowablePackageIDs>
    <AllowablePackageID>king_all_inclusive</AllowablePackageID>
    <AllowablePackageID>pet_friendly</AllowablePackageID>
  </AllowablePackageIDs>
  <!-- Additional child elements omitted. -->
</RoomData>
<PackageData>
  <PackageID>penthouse_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>free_breakfast</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>king_all_inclusive</PackageID>
</PackageData>
<!-- Additional child elements omitted. -->
<PackageData>
  <PackageID>pet_friendly</PackageID>
</PackageData>

注意： 如果您使用 <AllowablePackageIDs> 或 <AllowableRoomIDs> 停用之前可能使用过但目前您的系统中已禁用的某个组合，您无需仅仅为了移除之前的数据就为所有日期重新发送 ARI。

场景 3：如何使用 allowableRoomID 控制产品

当客房类型按套餐分组时，如何控制产品（客房类型和套餐组合）？

注意 ：如果您的套餐是按客房类型分组的，请参阅场景 2。

说明

房间类型和套餐组合不再作为产品销售，或者您希望控制新套餐包含的内容。例如，您希望通过套餐仅指定某些房间类型，例如可欣赏海景的特大号床和大号双人房。

解决方案

使用 <AllowableRoomIDs> 元素发送更新后的 Transaction 消息，指定软件包包含的具体产品。

示例

以下 XML 代码段展示了如何使用 <AllowableRoomID> 在软件包中指定海景特大号床和大号双人房的客房类型。

<PackageID>RO</PackageID>
<AllowableRoomIDs>
  <AllowableRoomID>king_oceanview</AllowableRoomID>
  <AllowableRoomID>queen_oceanview</AllowableRoomID>
</AllowableRoomIDs>