通过 Bing Ads API 开始使用 C#

项目
11/13/2024

若要开始使用 .NET 语言开发Bing Ads API 应用程序，可以从提供的示例开始，或按照 Web 或桌面应用程序的应用程序演练之一进行操作。这些示例是使用 Bing Ads .NET SDK 和 Visual Studio Community 开发的。自定义配置可能会有所不同。

你将需要具有在生产或沙盒中访问Microsoft广告的用户凭据。对于生产环境，需要生产开发人员令牌。所有沙盒客户端都可以使用通用沙盒开发人员令牌，即 BBD37VB98。有关详细信息，请参阅 Bing Ads API 和沙盒入门。

若要通过 OAuth 进行身份验证，还必须注册应用程序并获取相应的客户端标识符。如果要开发 Web 应用程序，还需要记下客户端密码和重定向 URI。有关在生产环境中注册应用程序和授权代码授予流的详细信息，请参阅使用 OAuth 进行身份验证和使用 SDK 进行身份验证。尽管在生产环境中必须使用自己的应用程序 ID (即客户端 ID) ，但所有Microsoft广告客户都可以使用沙盒中的公共“教程示例应用”客户端 ID，即 00001111-aaaa-2222-bbbb-3333cccc4444。有关详细信息，请参阅沙盒。

安装 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 Ads API 示例通过 2017 Visual Studio Community 开发，目标.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.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_ConsoleLoggerMinLevelVerbose：

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 Ads API Web 服务地址
 处理服务错误和异常
 沙盒

通过