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 広告のお客様は、サンドボックスで公開されている "チュートリアル サンプル アプリ" クライアント ID ( 000011111-aaaa-2222-bbbb-3333cccc4444 など) を使用できます。 詳細については、「 サンドボックス」を参照してください。

SDK のインストール

NuGet を使用する Bing Ads .NET SDK をインストールするには、 NuGet を使用するか、NuGet パッケージの管理ユーザー インターフェイスを使用するか、 パッケージ マネージャー コンソールを使用します。 NuGet のインストールの詳細については、「 https://docs.nuget.org」を参照してください。

注:

Bing Ads .NET SDK では、.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 Framework との関係については、.NET Standard に関するこの記事を参照してください。

NuGet パッケージ マネージャー コンソール

  1. [ツール] #>NuGet パッケージ マネージャー>パッケージ マネージャー コンソールをクリックします。
  2. SDK をインストールする既定のプロジェクトを選択し、コンソール コマンド ラインで「 Install-Package Microsoft.BingAds.SDK」と入力します。
  3. System.ServiceModel.Primitives 4.4.1、System.ServiceModel.Http 4.4.1、および System.ServiceModel.ConfigurationManager 4.4.1 への参照がまだない場合は、「Install-Package System.ServiceModel.Primitives -Version 4.4.1」、「Install-Package System.ServiceModel.Http -Version 4.4.1」、「Install-Package System.Configuration.ConfigurationManager -Version 4.4.1」と入力します。

チュートリアル

Bing Ads .NET SDK をインストールしたら、C# で Bing Ads API コード例 を参照するか、 Web または デスクトップ アプリケーションのアプリケーション チュートリアルのいずれかに従うことができます。

HTTP クライアントのカスタマイズ

Bing Ads .NET SDK で使用される 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();

サービス呼び出しのログ記録

Bing Ads .NET SDK 13.0.20 以降では、要求と応答メッセージのログを有効にするために、 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 広告 API クライアント ライブラリ
Bing 広告 API のコード例
Bing 広告 API Web サービス アドレス
サービス エラーと例外の処理
サンドボックス

  • 最終更新: