Hotel API の概要
注:
このベータ版のHotel Price Adsは、一部の参加者のみが利用できます。 ベータ リリース プログラムへの参加の詳細については、アカウント マネージャーに問い合わせるか、 こちらで登録してください。
API とドキュメントは変更される可能性があります。
Microsoft Advertising の資格情報はありますか?
Hotel API を使用するには、Microsoft Advertising アカウントと Microsoft アカウントが必要です。 Microsoft Advertising アカウントを取得するには、 に移動します https://ads.microsoft.com。 Microsoft アカウントを使用してサインインしていない場合は、Microsoft アカウントにサインインするか、Microsoft アカウントにサインアップするように求められます。 サインイン後、 新しい Microsoft Advertising アカウントにサインアップするオプションがあります。 サインアップ オプションを選択し、サインアップ プロセスを続行します。
他のBing広告 API とは異なり、Hotel API では開発者トークンは使用されません。 API を含める場合は無視されます。
ホテル料金広告のアカウントを有効にする
登録情報を受け取ったら、次の手順についてメールでお問い合わせください。
資格情報の認証
重要
2022 年 6 月 1 日より、Bing Ads API、Content API、および Hotel API を使用するサードパーティ アプリケーションを介してサインインするすべてのユーザーに多要素認証が必要になります。
新しいmsads.manageスコープを使用してユーザーの同意を得るには、アプリケーションを更新する必要があります。 すべてのアプリケーション開発者は、新しいスコープを使用するためにアクションを実行する必要があります。
詳細については、「 多要素認証要件 ガイド」を参照してください。
Hotel API では、OAuth 認証スキームが使用されます。 OAuth を使用した Microsoft アカウント資格情報の認証の詳細については、「OAuth による認証 (Microsoft ID プラットフォームを使用することをお勧めします)」を参照してください。
Bing Ads SDK for .NET、Java、または Python を使用して、Microsoft アカウントの資格情報を認証できます。 SDK を使用してアクセス トークンを取得する方法の詳細については、「 C# | Java | Python」を参照してください。 SDK for Microsoft Advertising キャンペーンを使用している場合にのみ、SDK を使用してアクセス トークンを取得できます。 そうしないと、SDK をインストールするオーバーヘッドの価値がない可能性があります。
Bing Ads SDK を使用してトークンを取得しないことを選択した場合は、 OAuth の実装例については、「OAuth C# の例 」を参照してください。
注:
サービスから API を使用する場合は、「サービス からの Hotel API の使用」を参照してください。
資格情報はどこで使用しますか?
ユーザーの OAuth アクセス トークンを取得したら、Authorization ヘッダーをそれに設定します。
var headers = new WebHeaderCollection();
headers.Add(HttpRequestHeader.Authorization, "Bearer " + tokens.AccessToken);
要求と応答に含まれる可能性がある Authorization ヘッダーとその他のヘッダーについては、「 ヘッダー」を参照してください。
注:
Hotel API では、標準の Authorization ヘッダーが使用されます。 Bing Ads SDK を使用して OAuth トークンを取得する場合は、SDK を使用してトークンを取得し、Authorization ヘッダーを設定します。
ホテルフィードを設定していますか?
Hotel API を使用する前に、ホテル フィードを設定しておく必要があります。 詳細については、以下を参照してください。