旅館 API

注意事項

此 Beta 版的旅館價格廣告僅供選取參與者使用。如需參與 Beta 發行計劃的相關信息，請連絡您的帳戶管理員或在這裡註冊。

API 和檔可能會變更。

旅館 API 可讓您管理旅館廣告營銷活動和營銷活動。

基本概念...

當您取得旅館價格廣告的存取權時，服務會設定預設的子帳戶和旅館群組，其中包含您旅館摘要中的旅館。子帳戶提供您旅館價格廣告的最上層邏輯組織。您可以將它視為先前旅館活動) (的記錄活動。您可能有多個子帳戶。

子帳戶會指定營銷活動的每日預算、允許的報價上限，以及未指定報價或乘數之廣告的預設中標和報價乘數。

旅館群組提供另一個層級，讓您以邏輯方式將旅館價格廣告分組。旅館群組屬於單一子帳戶。服務為您建立的預設旅館群組名為 Ungrouped。其中包含初始旅館摘要中的所有旅館，以及未來所有新旅館。

旅館群組會針對未指定報價或乘數的廣告，指定預設的報價和報價乘數。如果您未指定中標和乘數，群組會從子帳戶繼承它們。

設定您的子帳戶和旅館群組之後，您可以開始匯入旅館摘要數據。如需詳細資訊，請參閱您是否已設定旅館摘要？

旅館屬於單一旅館群組。旅館會指定要用於旅館廣告的中標和報價乘數。如果您未指定報價和乘數，則旅館會依該順序從旅館群組或子帳戶繼承它們。

如需將旅館移至不同旅館群組的相關信息，請參閱建立旅館與旅館群組的關聯。

您將需要認證並設定旅館摘要。如需詳細資訊，請參閱使用者入門。

您的帳戶管理員也需要讓您的帳戶在生產和沙盒環境中使用旅館價格廣告。

下列各節示範如何管理您的子帳戶、旅館群組和旅館。如需端點、標頭、查詢參數和資源的相關信息，請參閱旅館 API 參考。

主題	描述
使用子帳戶	提供列出子帳戶、取得單一子帳戶，以及更新子帳戶的相關信息。
使用旅館群組	提供列出子帳戶的旅館群組、取得單一旅館群組、新增旅館群組，以及更新旅館群組的相關信息。
使用旅館	提供列出子帳戶中所有旅館、列出旅館群組中的旅館、從旅館群組取得單一旅館，以及更新旅館的相關信息。
建立旅館與旅館群組的關聯	提供如何將旅館與旅館群組建立關聯的相關信息。

如需程式代碼範例，請參閱範例。