開始搭配 Bing 廣告 API 使用 C#

發行項
05/01/2024

若要開始使用 .NET 語言開發 Bing 廣告 API 應用程式，您可以從提供的範例開始，或遵循 Web 或桌面應用程式的其中一個應用程式逐步解說。這些範例是使用 Bing Ads .NET SDK 和 Visual Studio Community 所開發。您的自定義組態可能會有所不同。

您需要可在生產或沙箱中存取 Microsoft Advertising 的用戶認證。針對生產環境，您需要生產開發人員令牌。所有沙盒用戶端都可以使用通用沙盒開發人員令牌，也就是 BBD37VB98。如需詳細資訊，請參閱開始使用 Bing 廣告 API 和沙盒。

若要透過 OAuth 進行驗證，您也必須註冊應用程式並取得對應的用戶端識別碼。如果您要開發 Web 應用程式，也需要記下用戶端密碼和重新導向 URI。如需在生產環境中註冊應用程式和授權碼授與流程的詳細資訊，請參閱使用 OAuth 進行驗證和使用 SDK 進行驗證。雖然在生產環境中，您必須使用自己的應用程式標識碼 (也就是用戶端標識符) ，但所有 Microsoft Advertising 客戶都可以在沙盒中使用公用的「教學課程範例應用程式」用戶端標識符，也就是 4c0b021c-00c3-4508-838f-d3127e8167ff。如需詳細資訊，請參閱沙盒。

安裝 SDK

透過 NuGet、透過管理 NuGet 套件使用者介面，或透過套件管理員主控台安裝 Bing Ads .NET SDK。如需安裝 NuGet 的相關資訊，請參閱 https://docs.nuget.org。

注意事項

Bing Ads .NET SDK 支援 .NET Standard 2.0。您可以從各種平台中選擇，例如 .NET Core 或 .NET Framework 4.6.1。 Bing 廣告 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 套件管理員控制台

按兩下 [工具->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.Primitives -Version 4.4.1、 Install-Package System.ServiceModel.Http -Version 4.4.1和 Install-Package System.Configuration.ConfigurationManager -Version 4.4.1。

逐步解說

安裝 Bing 廣告 .NET SDK 之後，您可以流覽 C# 中的 Bing 廣告 API 程式代碼範例，或遵循 Web 或傳統型應用程式的其中一個應用程式逐步解說。

自訂 HTTP 用戶端

您可能想要自定義 Bing Ads .NET SDK 所使用的 HTTP 用戶端，以變更某些標準參數，例如 HTTP 逾時、Proxy 組態或其他設定。

若要這樣做，您可以建立繼承自 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 服務位址
 處理服務錯誤和例外狀況
 沙箱

共用方式為