度假租賃的單位配置

2026 年 1 月：度假租賃單位配置方案更新

對於度假租賃，Content 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) - 。

架構變更範例

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

如果您對這些變更有任何疑問，或者它們將如何影響您的快速實施，請聯絡支援。