Começar a usar C# com a API Bing Ads

Para começar a desenvolver aplicativos da API do Bing Ads com uma linguagem .NET, você pode começar com os exemplos fornecidos ou seguir um dos passo a passo do aplicativo para um aplicativo Web ou de Desktop . Os exemplos foram desenvolvidos com o SDK do Bing Ads .NET e o Visual Studio Community. A sua 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, você precisará de um token de desenvolvedor de produção. Todos os clientes de sandbox podem usar o token de desenvolvedor de sandbox universal, ou seja, BBD37VB98. Para obter mais informações, consulte Introdução à API e àSandbox do Bing Ads.

Para autenticar via OAuth, você também deve registrar um aplicativo e obter o identificador de cliente correspondente. Você também precisa tomar nota do segredo do cliente e redirecionar o URI se estiver desenvolvendo um aplicativo Web. Para obter mais detalhes sobre como registrar um aplicativo em produção e o fluxo de concessão de código de autorização, consulte Autenticação com OAuth e Autenticação com SDKs. Embora em produção você deva usar seu próprio ID de aplicativo (também conhecido como ID de cliente), todos os clientes do Microsoft Advertising podem usar o ID de cliente público "Aplicativo de amostra tutorial" em sandbox, ou seja, 00001111-aaaa-2222-bbbb-3333cccc4444. Para obter mais informações, consulte Sandbox.

Instalar o SDK

Instale o SDK do .NET do Bing Ads por meio do NuGet, da interface do usuário Gerenciar Pacotes NuGet ou do Console do Gerenciador de Pacotes. Para obter informações sobre como instalar o NuGet, consulte https://docs.nuget.org.

Consola do Gestor de Pacotes NuGet

1. Clique em Ferramentas ->Gerenciador de Pacotes NuGet ->Console do Gerenciador de Pacotes.
2. Escolha o projeto padrão onde deseja instalar o SDK e, em seguida, na linha de comando do console, digite Install-Package Microsoft.BingAds.SDK.
3. Se você 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, digite Install-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

Depois de instalar o SDK do .NET do Bing Ads, navegue pelos Exemplos de Código da API do Bing Ads em C# ou siga um dos passo a passo do aplicativo para um aplicativo Web ou de Desktop .

Personalizando o cliente HTTP

É recomendável personalizar o cliente HTTP usado pelo SDK do .NET do Bing Ads para alterar alguns parâmetros padrão, como tempo limite de HTTP, configuração de proxy ou outras configurações.

Para fazer isso, você pode criar uma classe personalizada herdada e HttpClientProvider definida GlobalSettings.HttpClientProvider como uma instância dessa classe antes de fazer 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(); 

Registar chamadas de serviço

A partir do Bing Ads .NET SDK 13.0.20, para habilitar mensagens de solicitação e resposta de log, você pode definir a BINGADS_ConsoleLoggerMinLevel variável de ambiente como Verbose:

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

Você também pode habilitar o mesmo registro usando a BingAdsEventListener classe:

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

Você 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 Bing Ads
Endereços de serviço Web da API Bing Ads
Lidando com erros e exceções de serviço
Área restrita