Vrbo 與 Rapid 整合指南
為合作夥伴提供的 Vrbo 整合流程指南。
簡介
本文旨在介紹 Rapid 與 Vrbo 整合流程,包括整合方式、API 要求與回應範例、限制、錯誤處理和常見問題。
本指南主要針對我們推薦的 Vrbo 供應優惠。如需進階使用案例,請參閱下方的進階整合指南。
|
地理
須知事項
- 啟用 Vrbo 功能的 Rapid Geography API 合作夥伴,除傳統住宿物業外,亦可透過所有地理位置 API 存取 Vrbo 旅宿 ID。
關鍵主題:對應
- 請注意,在完成預訂前,我們無法公開旅宿的街道地址。詳情請參閱「住宿須知內容」整合指南。
- 合作夥伴應使用「內容 API」的經度/緯度來搭配自身的地理位置解決方案,以標示旅宿的所在地。
- 要求隱私權的旅宿應使用模糊處理的經緯度進行地圖顯示,但只要不向旅客顯示確切的旅宿位置,就可以使用精確的經緯度搜尋旅宿。
與其他住宿選擇的主要差異
- 合作夥伴可要求地理位置回應包含 Vrbo 與住宿資訊、僅 Vrbo 資訊 (於啟用設定檔中使用
supply_source=vrbo),或僅住宿資訊 (使用supply_source=expedia)。若未提供supply_source,Rapid Geography API 將預設僅提供住宿資訊。
地理常見問題
**問題:**我可以將地理 API 篩選為僅回傳 Vrbo 旅宿或僅回傳非 Vrbo 旅宿嗎?
**解答:**是的,合作夥伴可以使用 supply_source=vrbo 進行篩選。如果個人檔案不受允許存取 Vrbo 供應,則不會回傳任何結果。
內容
須知事項
- Vrbo 的內容是透過與其他住宿選項相同的 Rapid Content API 提供,方式是傳遞
supply_source=vrbo,但請注意以下架構的差異。 - 相較於其他快速住宿選項,Vrbo 內容由旅宿管理員進行更新的頻率更高。不正確的旅宿刊登內容資訊可能會導致旅客體驗不佳、增加支援電話及退款要求。我們強烈建議合作夥伴至少每週更新一次 Vrbo 內容,以確保旅客能看到準確的旅宿資訊、設施服務和規定。
- Vrbo 優質屋主計畫是一項邀請制福利,僅限那些透過 Vrbo 平台評估 (包括低屋主取消率、正面評價及良好的旅客服務體驗) 證明能提供優質旅客體驗的屋主參加。合作夥伴可透過 . 識別頂級主機物業
attribute_id=1073745445。此外,合作夥伴可在請求中加入attribute_id=1073745445以篩選結果,僅返回 Premier Host 物業。
與其他住宿選擇的主要差異
Vrbo 專屬欄位:
| API | 說明 |
|---|---|
| 內容檔案 | Vrbo 物業資訊存放於獨立內容檔案中,與其他 Rapid 住宿選項分開管理。 |
| 欄位 | 說明 |
|---|---|
vacation_rental_details:registry_number | 出租度假屋旅宿展示的必填欄位。如需更多詳情,請參閱啟動條件。 |
| 私人出租住宿 | 屬性 1073745102 '私人主機旅宿' 表示旅宿由私人主機管理。展示的必填欄位,以及附加的必要詳情。如需更多詳情,請參閱啟動條件。 |
| 專業主持人旅宿 | 屬性 1073745142「專業旅宿主機/管理員」表示該旅宿由專業主機/管理員負責管理。展示的必填欄位,以及附加的必要詳情。如需更多詳情,請參閱啟動條件。 |
| 優質屋主 | 屬性 1073745445「頂級合作夥伴」表示旅宿由頂級主機管理。可用於為房源標記「優質房東」標識,或篩選結果僅顯示優質房東房源。 |
statistics | 包括特定出租度假屋單位的資訊,包括入住人數上限、臥室數量、浴室數量、客房數量 (獨立單位出租度假屋為 1) 和住宿建築面積 (單位為平方公尺和英尺)。應用於在搜尋結果和旅宿詳情頁面頂端展示關鍵旅宿資訊的摘要。 |
| 浴室和臥室數量 | 屬性 1073743378「臥室數量」是指單位內的臥室數量。屬性 1073743379「浴室數量」是指單位內的浴室數量。 |
vacation_rental_details:property_manager | 包括旅宿管理者姓名、圖片和可聯絡時使用的語言。應用於將旅客介紹給管理該旅宿的屋主。預訂完成後將提供聯絡資訊,做為基本住宿內容的一部分。 |
vacation_rental_details:unit_configurations | 描述客房的床型以及客房內每種床型的數量。此資訊應用於向旅客展示旅宿佈局,以確保旅宿能夠容納旅客的旅遊團體。 |
vacation_rental_details:house_rules | 此欄位已不使用。請使用 vacation_rental_details:enhanced_house_rules 代替。 |
vacation_rental_details:enhanced_house_rules |