度假租屋的單位配置

2026 年 2 月即將推出：度假租屋單位配置架構的更新

針對度假租屋，Content API 會傳回一個名為unit_configurations 的物件，其中包含關於客房的資訊，以及每個旅宿的床位選項。使用此物件可讓您以視覺化方式顯示客房及 bed 選項。

我們將在未來幾個月內對 API 進行一些更新，因此，API 目前使用的某些屬性將會被標記為已廢棄。

重要注意事項

此更新適用於所有使用/properties/content 的度假租屋服務，包括透過核心 API 及 Vrbo 供應管道進行的預訂。**如果您目前使用的是此度假租屋單位配置來展示度假租屋資訊，則需要進行更新。**若您未採用此裝置設定，則無需採取任何行動。

請注意：此變更僅涉及資料呈現方式的調整。這並不構成破壞性架構變更。

單元配置更新

在新版本的架構中，unit_configurations 物件現在包含更詳細的說明：

在「multi-unit」情境下，您將獲得更精確的單位資訊。舉例來說，與其使用目前的物件金鑰1 或Other1，新方法會將客房這個識別碼附加在每個單元的金鑰前，如下所示：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 的度假租屋旅宿，由 3 間獨立單位組成，每間均設有 1 間臥室。

舊的資料結構

{
      "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"
                        }
                  ]
            }
      }
}

2 臥室 Vrbo 房源旅宿

此範例展示一間 Vrbo 旅宿，設有 2 間臥室。

舊的資料結構

{
      "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 部署所產生的影響有任何疑問，請與我們聯絡。

>> 聯絡支援團隊