Introdução à Utilização de C# com Bing Ads API

Para começar a desenvolver Bing Ads aplicações API com uma linguagem .NET, pode começar com os exemplos fornecidos ou seguir uma das instruções da aplicação para uma aplicação Web ou de Ambiente de Trabalho . Os exemplos foram desenvolvidos com o SDK e Visual Studio Community .NET Bing Ads. A configuração personalizada pode variar.

Precisará de credenciais de utilizador com acesso ao Microsoft Advertising em produção ou sandbox. Para o ambiente de produção, precisará de um token de programador de produção. Todos os clientes do sandbox podem utilizar o token de programador de sandbox universal, ou seja, BBD37VB98. Para obter mais informações, veja Introdução à API Bing Ads e ao Sandbox.

Para autenticar através do OAuth, também tem de registar uma aplicação e obter o identificador de cliente correspondente. Também tem de tomar nota do segredo do cliente e redirecionar o URI se estiver a desenvolver uma aplicação Web. Para obter mais detalhes sobre como registar uma aplicação na produção e o fluxo de concessão de código de autorização, veja Authentication with OAuth and Authentication With the SDKs (Autenticação com OAuth e Autenticação com os SDKs). Apesar de, em produção, ter de utilizar o seu próprio ID de aplicação (também conhecido como ID de cliente), todos os clientes do Microsoft Advertising podem utilizar o ID de cliente público "Tutorial Sample App" no sandbox, ou seja, 00001111-aaaa-2222-bbbb-3333cccc4444. Para obter mais informações, consulte Sandbox.

Instalar o SDK

Instale o Bing Ads SDK .NET através do NuGet, através da interface de utilizador Gerir Pacotes NuGet ou através da Consola do Gestor de Pacotes. Para obter informações sobre como instalar o NuGet, consulte https://docs.nuget.org.

Nota

O SDK .NET Bing Ads suporta o .NET Standard 2.0. Pode escolher entre várias plataformas, por exemplo, .NET Core ou .NET Framework 4.6.1. Os exemplos da API de Bing Ads são desenvolvidos através do Visual Studio Community 2017 e .NET Framework de destino 4.7.1. O SDK .NET Standard 2.0 e Bing Ads .NET não suporta .NET Framework versões inferiores à 4.6.1. Para obter mais informações sobre o .NET Standard e como se relaciona com outras arquiteturas .NET, veja este artigo sobre .NET Standard.

Consola do Gestor de Pacotes NuGet

1. Clique em Ferramentas ->Gestor de Pacotes NuGet ->Consola do Gestor de Pacotes.
2. Escolha o projeto predefinido onde pretende instalar o SDK e, em seguida, na linha de comandos da consola, escreva Install-Package Microsoft.BingAds.SDK.
3. Se ainda não tiver referências a System.ServiceModel.Primitives 4.4.1, System.ServiceModel.Http 4.4.1 e System.ServiceModel.ConfigurationManager 4.4.1, escrevaInstall-Package System.ServiceModel.Primitives -Version 4.4.1 , Install-Package System.ServiceModel.Http -Version 4.4.1e Install-Package System.Configuration.ConfigurationManager -Version 4.4.1.

Instruções

Assim que tiver o Bing Ads SDK .NET instalado, pode navegar no Bing Ads Exemplos de Código da API em C# ou seguir uma das instruções da aplicação para uma aplicação Web ou de Ambiente de Trabalho .

Personalizar o cliente HTTP

Poderá querer personalizar o cliente HTTP utilizado pelo Bing Ads SDK .NET para alterar alguns parâmetros padrão, como o tempo limite de HTTP, a configuração de proxy ou outras definições.

Para tal, pode criar uma classe personalizada herdada de HttpClientProvider e definida GlobalSettings.HttpClientProvider para uma instância dessa classe antes de efetuar chamadas de serviço. Por exemplo:

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(); 

Chamadas do serviço de registo

A partir do Bing Ads SDK .NET 13.0.20, para ativar o pedido de registo e as mensagens de resposta, pode definir a variável de BINGADS_ConsoleLoggerMinLevel ambiente como Verbose:

Environment.SetEnvironmentVariable("BINGADS_ConsoleLoggerMinLevel", "Verbose"); 

Também pode ativar o mesmo registo com a BingAdsEventListener classe :

BingAdsEventListener.CreateConsoleLogger(EventLevel.Verbose).KeepActive();

Também pode criar uma nova BingAdsEventListener instância para fornecer uma implementação de logger personalizada. Por exemplo:

new BingAdsEventListener(EventLevel.Verbose, bingAdsEvent => MyLogger.LogVerbose(bingAdsEvent.GetDescription())).KeepActive();

See Also

Bibliotecas de Cliente da API Bing Ads
Exemplos de Código da API do Bing Ads
Endereços do Serviço Web da API Bing Ads
Processamento de Erros e Exceções do Serviço
Sandbox