Upgrade to Bing Ads .NET SDK 13.0.20
Bing Ads .NET SDK 13.0.20 includes changes to switch from the existing XML-based SOAP API to a new JSON-based REST API for reducing service call latency and network traffic.
This release covers Campaign Management, Bulk, and Reporting services. Support for other services will be added in future versions.
If you run into any issue due to the new implementation, you can switch back to the old implementation by setting a corresponding environment variable or AppContext
switch for the affected service.
Using an environment variable:
// For CampaignManagement service
Environment.SetEnvironmentVariable($"BINGADS_ICampaignManagementService.DisableRestApi", "true");
// For Bulk service
Environment.SetEnvironmentVariable($"BINGADS_IBulkService.DisableRestApi", "true");
// For Reporting service
Environment.SetEnvironmentVariable($"BINGADS_IReportingService.DisableRestApi", "true");
Using AppContext switch:
// For CampaignManagement service
AppContext.SetSwitch("Switch.BingAds.ICampaignManagementService.DisableRestApi", true);
// For Bulk service
AppContext.SetSwitch("Switch.BingAds.IBulkService.DisableRestApi", true);
// For Reporting service
AppContext.SetSwitch("Switch.BingAds.IReportingService.DisableRestApi", true);
Please note that the new behavior includes a few implementation changes that might affect your application if it depends on any of these details:
- HTTP client implementation
Unlike previous SDK versions that used System.ServiceModel
API for calling SOAP services, the new SDK version uses HttpClient
directly to make API calls. By default, System.Extensions.Http
is used to create an HttpClient
from IHttpClientFactory
.
For more details on customizing the HTTP client behavior, changing how it gets created or setting additional client parameters, please see Customizing HTTP client.
For troubleshooting issues and logging request and response messages, please see Logging service calls.
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for