The DataService now provides the ability to retrieve bid simulator results and Google plan to expand it to include other functionality in future versions of the API.
“In addition to relocating the bid simulator feature to a new service, we updated it to support generic selectors. The returned objects haven’t changed however, so much of your application logic can remain the same. It’s also worth noting that while the BidLandscapeService had a single getBidLandscape() method which would return both criteria and ad group bid simulation results, DataService has now broken this functionality out into two methods: getAdGroupBidLandscape() and getCriterionBidLandscape(),” revealed Google.
Like with all generic selectors you must explicitly list all of the fields you wish to have returned, the names of which can be found in the documentation for CriterionBidLandscape (or AdGroupBidLandscape) and its sub-objects. Also notice that the functionality of the BidLandscapeIdFilter can be replicated by using a combination of predicates, which’re always ANDed together.
As a reminder, to get criteria bid simulation results using the v201008 BidLandscapeService you can use the following PHP code: