度假租赁单元配置

2026 年 1 月即将推出：度假租赁单元配置方案更新

对于度假租赁，内容 API 返回一个名为 unit_configurations的对象，其中包含有关每个房产的房间和床位选项的信息。使用此对象可以直观地显示房间和床铺选项。

我们将在未来几个月内对 API 进行一些更新，因此，API 目前使用的一些属性将被弃用。

重要提示

此更新适用于所有使用 /properties/content的度假租赁，包括通过核心 API 和 Vrbo 供应进行的租赁。**如果您使用此度假租赁单元配置来显示度假租赁信息，则需要进行更新。**如果您未使用此设备配置，则无需采取任何行动。

请注意：此更改涉及数据呈现方式的修改。这并不构成破坏性的架构变更。

单元配置更新

在新版本的架构中，unit_configurations 对象现在包含更详细的描述：

在 multi-unit 场景中，您将收到更精确的单位信息。例如，新方法不是使用当前的对象键 1或 Other1，而是将房间 ID 添加到每个单元的键前面，如下所示：231607625123_Bedroom1。
床型值正在从全大写字母变为更紧凑的结构。例如 TWIN_SINGLE_BED变为 TwinBed。
床位信息描述正在简化。例如，Twin/Single bed(s) - 现在将直接显示为 Twin Bed(s) - 。

映射旧式单元配置

`legacy_type`	`legacy_description`	`new_type`	`new_description`
`BUNK_BED`	`Bunk bed(s) -`	`BunkBed`	`Bunk Bed(s) -`
`CHILD_BED`	`Child bed(s) -`	`ChildBed`	`Child Bed(s) -`
`DOUBLE_BED`	`Double bed(s) -`	`FullBed`	`Double Bed(s) -`
`KING_BED`	`King bed(s) -`	`KingBed`	`King Bed(s) -`
`MURPHY_BED`	`Murphy bed(s) -`	`MurphyBed`	`Murphy Bed(s) -`
不适用	不适用	`Crib`	`Crib(s) -`
不适用	不适用	`CribFixed`	`Crib(s) -`
不适用	不适用	`DayBed`	`Day Bed(s) -`
不适用	不适用	`Futon`	`Futon(s) -`
不适用	不适用	`TwinXLBed`	`Large Twin Bed(s) -`
不适用	不适用	`SofaBedExtra`	`Sofa Bed(s) -`
不适用	不适用	`TrundleBed`	`Trundle Bed(s) -`
不适用	不适用	`WaterBed`	`Water Bed(s) -`
`QUEEN_BED`	`Queen bed(s) -`	`QueenBed`	`Queen Bed(s) -`
`SLEEP_SOFA_FUTON`	`Sleep sofa/futon(s) -`	`SofaBed`	`Sofa Bed(s) -`
`TWIN_SINGLE_BED`	`Twin/Single bed(s) -`	`TwinBed`	`Twin Bed(s) -`

架构变更示例

Multi-unit 度假租赁

此示例展示了一个 multi-unit 度假租赁房产，该房产由三个独立的单元组成，每个单元都有一间卧室。

旧方案

{
      "property_id": "49154578123",
      "vacation_rental": {
            "unit_configurations": {
                  "1": [
                        {
                              "quantity": 1,
                              "description": "King bed(s) - ",
                              "type": "KING_BED"
                        }
                  ],
                  "2": [
                        {
                              "quantity": 2,
                              "description": "Queen bed(s) - ",
                              "type": "QUEEN_BED"
                        },
                        {
                              "quantity": 1,
                              "description": "Sleep sofa/futon(s) - ",
                              "type": "SLEEP_SOFA_FUTON"
                        }
                  ],
                  "3": [
                        {
                              "quantity": 1,
                              "description": "Sleep sofa/futon(s) - ",
                              "type": "SLEEP_SOFA_FUTON"
                        }
                  ]
            }
      }
}

新方案

{
      "property_id": "491545781237",
      "vacation_rental": {
            "unit_configurations": {
                  "831607625124_Bedroom1": [
                        {
                              "quantity": 1,
                              "description": "King Bed(s) - ",
                              "type": "KingBed"
                        }
                  ],
                  "831607648123_Bedroom1": [
                        {
                              "quantity": 2,
                              "description": "Queen Bed(s) - ",
                              "type": "QueenBed"
                        },
                        {
                              "quantity": 1,
                              "description": "Futon(s) - ",
                              "type": "Futon"
                        }
                  ],
                  "231607641239123_Bedroom1": [
                        {
                              "quantity": 1,
                              "description": "Futon(s) - ",
                              "type": "Futon"
                        }
                  ]
            }
      }
}

Two-bedroom Vrbo 房产

这个例子展示了一套位于 Vrbo 上的两居室房源。

旧方案

{
      "property_id": "721545781234",
      "vacation_rental": {
            "unit_configurations": {
                  "1": [
                        {
                              "quantity": 1,
                              "description": "King bed(s) - ",
                              "type": "KING_BED"
                        }
                  ],
                  "2": [
                        {
                              "quantity": 2,
                              "description": "Queen bed(s) - ",
                              "type": "QUEEN_BED"
                        },
                        {
                              "quantity": 1,
                              "description": "Sleep sofa/futon(s) - ",
                              "type": "SLEEP_SOFA_FUTON"
                        }
                  ]
            }
      }
}

新方案

{
      "property_id": "721545781234",
      "vacation_rental": {
            "unit_configurations": {
                  "6516076251239_Bedroom1": [
                        {
                              "quantity": 1,
                              "description": "King Bed(s) - ",
                              "type": "KingBed"
                        }
                  ],
                  "6516076251239_Bedroom2": [
                        {
                              "quantity": 2,
                              "description": "Queen Bed(s) - ",
                              "type": "QueenBed"
                        },
                        {
                              "quantity": 1,
                              "description": "Futon(s) - ",
                              "type": "Futon"
                        }
                  ]
            }
      }
}

如果您对这些变更或其对您的 Rapid 实施的影响有任何疑问，请联系我们以获得支持。