Introducción al uso de C# con la API de Bing Ads

Para empezar a desarrollar aplicaciones de API de Bing Ads con un lenguaje .NET, puede empezar con los ejemplos proporcionados o seguir uno de los tutoriales de aplicación de una aplicación web o de escritorio . Los ejemplos se han desarrollado con el SDK de .NET de Bing Ads y Visual Studio Community. La configuración personalizada puede variar.

Necesitarás credenciales de usuario con acceso a Microsoft Advertising, ya sea en producción o en espacio aislado. Para el entorno de producción, necesitará un token de desarrollador de producción. Todos los clientes de espacio aislado pueden usar el token de desarrollador de espacio aislado universal, es decir, BBD37VB98. Para obtener más información, consulta Introducción a la API y elespacio aislado de Microsoft Advertising

Para autenticarse a través de OAuth, también debe registrar una aplicación y obtener el identificador de cliente correspondiente. También debe anotar el secreto de cliente y el URI de redireccionamiento si está desarrollando una aplicación web. Para obtener más información sobre el registro de una aplicación en producción y el flujo de concesión de código de autorización, consulte Autenticación con OAuth y Autenticación con los SDK. Aunque en producción debes usar tu propio id. de aplicación (también conocido como id. de cliente), todos los clientes de Microsoft Advertising pueden usar el id. de cliente público "Aplicación de ejemplo de tutorial" en el espacio aislado, es decir, 00001111-aaaa-2222-bbbb-3333cccc4444. Para obtener más información, consulte Espacio aislado.

Instalar el SDK

Instale el SDK de .NET para Bing Ads a través de NuGet, ya sea a través de la interfaz de usuario Administrar paquetes NuGet o a través de la Consola del administrador de paquetes. Para obtener información sobre cómo instalar NuGet, consulte https://docs.nuget.org.

Consola de administrador de paquetes NuGet

1. Haga clic en Herramientas ->NuGet Administrador de paquetes -Consola del administrador de> paquetes.
2. Elige el proyecto predeterminado en el que quieres instalar el SDK y, a continuación, dentro de la línea de comandos de la consola, escribe Install-Package Microsoft.BingAds.SDK.
3. Si aún no tiene referencias a System.ServiceModel.Primitives 4.4.1, System.ServiceModel.Http 4.4.1 y System.ServiceModel.ConfigurationManager 4.4.1, escriba Install-Package System.ServiceModel.Primitives -Version 4.4.1, Install-Package System.ServiceModel.Http -Version 4.4.1y Install-Package System.Configuration.ConfigurationManager -Version 4.4.1.

Tutoriales

Una vez instalado el SDK de .NET para Bing Ads, puede examinar los ejemplos de código de API de Bing Ads en C# o seguir uno de los tutoriales de aplicación de una aplicación web o de escritorio .

Personalización del cliente HTTP

Es posible que desee personalizar el cliente HTTP que usa el SDK de .NET de Bing Ads para cambiar algunos parámetros estándar, como el tiempo de espera de HTTP, la configuración de proxy u otras opciones.

Para ello, puede crear una clase personalizada heredada y HttpClientProvider establecida GlobalSettings.HttpClientProvider en una instancia de esa clase antes de realizar llamadas de servicio. Por ejemplo:

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

Llamadas al servicio de registro

A partir de Bing Ads .NET SDK 13.0.20, para habilitar el registro de mensajes de solicitud y respuesta, puede establecer la variable de BINGADS_ConsoleLoggerMinLevel entorno en Verbose:

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

También puede habilitar el mismo registro mediante la BingAdsEventListener clase:

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

También puede crear una nueva BingAdsEventListener instancia para proporcionar una implementación de registrador personalizada. Por ejemplo:

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

Consulta también

Bibliotecas cliente de la API de Bing Ads
Ejemplos de código de API de Bing Ads
Direcciones de servicios web de la API de Microsoft Advertising
Control de errores y excepciones de servicio
Espacio aislado