Bing Ads API での C# の使用を開始する
.NET 言語Bing Ads API アプリケーションの開発を開始するには、 提供されている例 から始めるか、 Web または デスクトップ アプリケーションのアプリケーションチュートリアルのいずれかに従います。 この例は、Bing Ads .NET SDK とVisual Studio Communityを使用して開発されています。 カスタム構成は異なる場合があります。
運用環境またはサンドボックス内の Microsoft Advertising へのアクセス権を持つユーザー資格情報が必要です。 運用環境では、 運用開発者トークンが必要です。 すべてのサンドボックス クライアントは、ユニバーサル サンドボックス開発者トークン ( BBD37VB98) を使用できます。 詳細については、「Bing Ads API とサンドボックスの概要」を参照してください。
OAuth を使用して認証するには、アプリケーションを登録し、対応するクライアント識別子を取得する必要もあります。 また、Web アプリケーションを開発する場合は、クライアント シークレットとリダイレクト URI もメモする必要があります。 運用環境でのアプリケーションの登録と承認コード付与フローの詳細については、「 OAuth による認証 」と 「SDK による認証」を参照してください。 運用環境では独自のアプリケーション ID (クライアント ID) を使用する必要がありますが、すべての Microsoft Advertising のお客様は、サンドボックス内のパブリック "Tutorial Sample App" クライアント ID ( 00001111-aaaa-2222-bbbb-3333cccc4444) を使用できます。 詳細については、「 サンドボックス」を参照してください。
SDK のインストール
NuGet を使用してBing Ads .NET SDK をインストールします。 NuGet パッケージの管理ユーザー インターフェイスを使用するか、 パッケージ マネージャー コンソールを使用します。 NuGet のインストールの詳細については、「」を参照してください https://docs.nuget.org。
注:
.NET SDK Bing Adsでは、.NET Standard 2.0 がサポートされています。 .NET Core や .NET Framework 4.6.1 など、さまざまなプラットフォームから選択できます。 Bing Ads API の例は、Visual Studio Community 2017 とターゲット .NET Framework 4.7.1 を介して開発されています。 .NET Standard 2.0 および Bing Ads .NET SDK では、4.6.1 より小さいバージョン.NET Frameworkサポートされていません。 .NET Standard とその他の .NET フレームワークとの関係の詳細については、 .NET Standard に関する記事を参照してください。
NuGet パッケージ マネージャー コンソール
- [ツール] ->[NuGet パッケージ マネージャー] -[パッケージ マネージャー コンソール] の順>にクリックします。
- SDK をインストールする既定のプロジェクトを選択し、コンソール コマンド ライン内で「」と入力します
Install-Package Microsoft.BingAds.SDK
。 -
System.ServiceModel.Primitives 4.4.1、System.ServiceModel.Http 4.4.1、System.ServiceModel.ConfigurationManager 4.4.1 への参照がまだない場合は、「、
Install-Package System.ServiceModel.Http -Version 4.4.1
、、」とInstall-Package System.Configuration.ConfigurationManager -Version 4.4.1
入力Install-Package System.ServiceModel.Primitives -Version 4.4.1
します。
チュートリアル
Bing Ads .NET SDK をインストールしたら、C# の Bing Ads API Code Examples を参照するか、 Web または Desktop アプリケーションのアプリケーション チュートリアルのいずれかに従います。
HTTP クライアントのカスタマイズ
.NET SDK Bing Ads使用する HTTP クライアントをカスタマイズして、HTTP タイムアウト、プロキシ構成、その他の設定などの一部の標準パラメーターを変更できます。
これを行うには、サービス呼び出しを行う前に、 から HttpClientProvider
継承されたカスタム クラスを作成し、そのクラスのインスタンスに設定 GlobalSettings.HttpClientProvider
できます。 以下に例を示します。
class MyHttpClientProvider : HttpClientProvider
{
protected override void ConfigureHttpClient(HttpClient httpClient, Type serviceType, ApiEnvironment apiEnvironment)
{
// override default timeout
httpClient.Timeout = TimeSpan.FromMinutes(5);
}
}
GlobalSettings.HttpClientProvider = new MyHttpClientProvider();
サービス呼び出しのログ記録
.NET SDK 13.0.20 Bing Ads以降、ログ記録要求メッセージと応答メッセージを有効にするには、環境変数を BINGADS_ConsoleLoggerMinLevel
に Verbose
設定できます。
Environment.SetEnvironmentVariable("BINGADS_ConsoleLoggerMinLevel", "Verbose");
クラスを使用して、同じログ記録を BingAdsEventListener
有効にすることもできます。
BingAdsEventListener.CreateConsoleLogger(EventLevel.Verbose).KeepActive();
カスタム ロガーの実装を提供する新しい BingAdsEventListener
インスタンスを作成することもできます。 以下に例を示します。
new BingAdsEventListener(EventLevel.Verbose, bingAdsEvent => MyLogger.LogVerbose(bingAdsEvent.GetDescription())).KeepActive();
関連項目
Bing Ads API クライアント ライブラリ
BING ADS API コードの例
Bing 広告 API Web サービス アドレス
サービス エラーと例外の処理
サンドボックス