How to download only changed entity from API?

[Dongliang Yu]

Hi,

How can I download only changed entity from API?

Say I created 10 keyword 1 month ago, and changed 1 keyword's bid yesterday, and I only want to download keywords have change in recent 7 days so only 1 keyword will be downloaded, is this supported by AdWords API?

Thanks

[Sreelakshmi Sasidharan (AdWords API Team)]

Hi Dongliang, 

Yes, you can make use of the CustomerSyncService. It will return all the campaigns irrespective of whether it was changed or not. But the response will indicate if there was a change to the specific campaign or not. On the other hand the service will only return the AdGroups and its criterion which were changed. Please check here for details about the response of this service. If there were multiple updates performed on the same criterion, the service might not indicate each change. The results of this service will however contain that AdGroupCriterion indicating that there was some change to that object. You can check the sample for CustomerSyncService (Java). Samples in other languages can be found here. 

Please give it a try and let me know if you have any additional questions.

Thanks,
Sreelakshmi, AdWords API Team

[Dongliang Yu]

Thanks Sreelakshmi!

Do you know is there any entity not covered by this service? If just return id of changed entity it's ok, but I want to make sure every entity will be covered by this service.

[Sreelakshmi Sasidharan (AdWords API Team)]

Hi Dongliang, 

The CustomerSyncService will contain the changed entities of the Campaign within CampaignChangeData, changed entities of AdGroup within AdGroupChangeData and changed entities of customer within CustomerChangeData. The AdGroupCahngeData will have Ids of changedAds, changedCriteria, removedCriteria, changedFeeds, removedFeeds, changedAdGroupBidModifierCriteria and removedAdGroupBidModifierCriteria. The response will indicate the type of change which could be new, changed or not changed and will also contain the Ids of the respective entities. Also, the changes made in last 90 days will only be returned by this service. Please check the linked documents for each type of change data for better understanding.