開始使用旅館 API

注意事項

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

API 和檔可能會變更。

您有 Microsoft Advertising 認證嗎?

若要使用旅館 API,您必須擁有 Microsoft Advertising 帳戶和 Microsoft 帳戶。 若要取得 Microsoft Advertising 帳戶,請移至 https://ads.microsoft.com。 如果您未使用 Microsoft 帳戶登入,系統會要求您登入您的 Microsoft 帳戶或註冊 Microsoft 帳戶。 登入之後,您可以選擇 註冊新的 Microsoft Advertising 帳戶。 選取註冊選項,然後繼續進行註冊程式。

不同於其他 Bing 廣告 API,旅館 API 不會使用開發人員令牌。 如果您包含 API,則會忽略它。

啟用您的旅館價格廣告帳戶

一旦我們收到您的註冊資訊,我們將透過電子郵件與您連絡,以瞭解後續步驟。

驗證您的認證

重要事項

從 2022 年 6 月 1 日開始,所有透過使用 Bing 廣告 API、內容 API 和旅館 API 的第三方應用程式登入的使用者,都必須進行多重要素驗證。

您必須更新應用程式,才能使用新msads.manage範圍取得使用者同意。 所有應用程式開發人員都必須採取動作,才能使用新的範圍。

如需詳細資訊,請參閱 Multi-Factor Authentication 需求 指南。

Hotel API 會使用 OAuth 驗證配置。 如需使用 OAuth 驗證 Microsoft 帳戶認證的詳細資訊,請參閱建議) 使用 Microsoft 身分識別平台 向 OAuth (進行驗證。

您可以使用適用於 .NET、Java 或 Python 的 Bing Ads SDK 來驗證 Microsoft 帳戶認證。 如需使用 SDK 取得存取令牌的詳細資訊,請參閱 C# | Java | Python。 如果您也使用適用於 Microsoft Advertising 的 SDK 行銷活動,您可能只想要使用 SDK 來取得存取令牌。 否則,安裝 SDK 可能不值得額外負荷。

如果您選擇不使用 Bing 廣告 SDK 來取得令牌,請參閱 OAuth C# 範例 以取得 OAuth 實作範例。

注意事項

如果您從服務使用 API,請參閱 從服務使用旅館 API

您要在哪裡使用認證?

取得使用者的 OAuth 存取令牌之後,請將 [授權] 標頭設定為它。

var headers = new WebHeaderCollection();
headers.Add(HttpRequestHeader.Authorization, "Bearer " + tokens.AccessToken);

如需授權標頭以及要求和回應可能包含的其他標頭的相關信息,請參閱 標頭

注意事項

Hotel API 會使用標準授權標頭。 如果您使用 Bing Ads SDK 來取得 OAuth 令牌,您將使用 SDK 來取得令牌,然後設定授權標頭。

您是否已設定旅館摘要?

使用旅館 API 之前,您應該先設定旅館摘要。 如需詳細資訊,請參閱: