Microsoft Advertising Java SDK 13.0.28 – Campaign Management SOAP to REST Migration

DWH 3QDigital 0 Reputation points
2026-07-23T23:19:54.8266667+00:00

Hi Team,

We are currently assessing our JavaETL Microsoft Advertising integration in preparation for the migration from SOAP APIs to REST APIs.

Our application currently uses: com.microsoft.bingads:microsoft.bingads:13.0.28

We specifically use the Campaign Management Service for Shared Entity / Shared Negative Keyword List functionality.

The following Campaign Management components and operations are currently used in our JavaETL implementation:

Component / Operation Usage
ServiceClient<ICampaignManagementService> Creates and manages the Campaign Management service client
-------- --------
ServiceClient<ICampaignManagementService> Creates and manages the Campaign Management service client
ICampaignManagementService Interface used to execute Campaign Management operations
GetSharedEntities Retrieves shared negative keyword lists
GetListItemsBySharedList Retrieves negative keywords contained within a shared list
GetSharedEntityAssociationsBySharedEntityIds Retrieves campaign associations for shared entities
SharedEntity / SharedList Represents shared entity/list data
NegativeKeywordList Represents shared negative keyword lists
NegativeKeyword Represents individual negative keywords
SharedEntityAssociation Represents associations between shared entities and campaigns

Questions

Could you please confirm the migration status of these Campaign Management components in Java SDK 13.0.28?

Are ServiceClient<ICampaignManagementService> and ICampaignManagementService currently SOAP-based or REST-backed in SDK 13.0.28?

Are the following operations currently available through REST?

GetSharedEntities

  `GetListItemsBySharedList`
  
     `GetSharedEntityAssociationsBySharedEntityIds`
     
     If these operations still use SOAP, will Microsoft provide REST equivalents before SOAP retirement?
     
     Will upgrading to a future Microsoft Advertising Java SDK automatically migrate these Campaign Management calls to REST while preserving the existing Java interfaces?
     
     Or should we plan application-level code changes to replace the existing `ServiceClient<ICampaignManagementService>` implementation with direct REST API calls?
     

Our goal is to determine whether the existing Campaign Management implementation can remain unchanged or whether JavaETL development work will be required as part of the SOAP-to-REST migration.

Any documentation or migration guidance specific to Campaign Management and Shared Entity operations would be appreciated.

Regards,

Jessie

Microsoft Advertising | Other
0 comments No comments

1 answer

Sort by: Most helpful
  1. MS Advertising - Len 0 Reputation points Microsoft External Staff Moderator
    2026-07-24T00:57:09.0666667+00:00

    Hi Jessie,

    Thank you for using our Microsoft Advertising Learn Q&A Platform!

    We understand that you are seeking clarification regarding the availability of the following Campaign Management operations during the SOAP-to-REST transition. 

    Starting from version 13.0.22 Bing Ads Java SDK has switched from the existing XML-based SOAP API to a new JSON-based REST API which includes a few implementation changes that might affect your application if it depends on any of these details:

    • HTTP client implementation
    • Service objects
    • Response objects

    Based on the current Microsoft Advertising API documentation, these operations are available through both SOAP and REST during the transition period.

    To confirm the migration status of the provided Campaign Management components in Java SDK 13.0.28, kindly reply to the private message I sent you for further review and assistance.

    Our support teams are pleased to engage in more in-depth discussions about your account through phone, chat, or email to offer review assistance, please see our support page to reach out!

    Kind regards,

    Len | Microsoft Advertising Support Specialist | 800-518-5689 

    Was this answer helpful?

    2 people found this answer helpful.
    0 comments No comments

Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.