Enterprise Web Services Version 4.0.0 Sandbox Has Launched
In the first half of 2008, Yahoo! Search Marketing is planning to launch a new version of the Enterprise Web Services (EWS) Marketing API. EWS Version 4.0.0 is a major version release and includes features that are backward-incompatible.
We're pleased to announce that EWS Version 4.0.0 has been released to the EWS sandbox, and we encourage you to log in and get familiar with it.
What Do I Need to Do?
We suggest that you first experiment with Version 4.0.0 in the EWS sandbox, make any required changes to your client application, and test your implementation.Then, be ready to switch over to production when the product release is ready later this year.
About this Release
ï¿½ The Version4.0.0 production release will occur approximately 30 days after the sandbox
ï¿½ WhileEWS Version 3.0.0 will continue to be available in production for 90 days after EWS
Version 4.0.0 is released, we recommend that you switch to Version 4.0.0 assoon as
ï¿½ EWS Version 3.0.0 will not be available after the 90-day transition period ends.
ï¿½ Thisrelease is backward-incompatible. To take advantage of the new features, youwill need to
re-compile your code against Version 4.0.0 WSDLs.
The new features and changes in EWS Version 4.0.0 are summarized below.
Variable Minimum Bids
In the next several weeks, we plan to change our system so that minimum bids will no longer be fixed for all keywords; they may be higher or lower than $.10. Minimum bids may vary by keyword, ad group and advertiser. EWS Version 4.0.0 is configured to work with variable minimum bids.Thus, if you do not upgrade to EWS Version 4.0.0, you may not have full control over your ads and keywords.
New EWS Service Operations
New operations have been added to the following services with the release of EWS Version 4.0.0:
ï¿½ getContentMatchMinBidForAdGroupOptimizationGuidelines: Returns Content Match
min bid for ad group optimization guidelines by ad group ID.
ï¿½ getSponsoredSearchMinBidForAdGroup: Returns Sponsored Search min bid for an ad
group by adgroup ID.
ï¿½ getSponsoredSearchMinBidForAdGroupOptimizationGuidelines: Returns Sponsored
Search min bid for ad group optimization guidelines by ad group ID.
ï¿½ getSponsoredSearchMinBidForAdGroups: Returns Sponsored Search min bid for multiple
ad groups by multiple adgroup IDs.
ï¿½ getAdsByAdGroupByParticipatesInMarketplace: Returns ads by ad group by marketplace
ï¿½ getReasonsForAdNotParticipatingInMarketplace: Returns reasons for an ad not
participating in a marketplace.
ï¿½ getMinBidForCampaignOptimizationGuidelines: Returns minBid for
CampaignOptimization Guidelines by campaign ID.
ï¿½ getKeywordsByAdGroupByParticipatesInMarketplace: Returns keywords by ad group
by marketplace participation.
ï¿½ getKeywordsByAdGroupBySponsoredSearchBidStatus: Returns keywords by ad group
by Sponsored Search bid status.
ï¿½ getReasonsForKeywordNotParticipatingInMarketplace: Returns reasons for a keyword
not participating in a marketplace.
ï¿½ getSponsoredSearchMinBidForKeywordOptimizationGuidelines: Returns Sponsored
Search min bidfor keyword optimization guidelines.
ï¿½ getSponsoredSearchMinBidForKeywordString: Returns Sponsored Search min bid by
ï¿½ getSponsoredSearchMinBidForKeywordStrings: Returns Sponsored Search min bids for
ï¿½ getSponsoredSearchMinBidUpdatesByAdGroupId: Returns the updates to
SponsoredSearch min bids by ad group.
New EWS Data Objects
Thefollowing new data objects have been added with the release of EWS Version4.0.0:
New EWS Data Object Elements
New elements have been added to the following data objects withthe release of EWS Version 4.0.0:
ï¿½ Allresponse objects (AdGroupResponse, AdResponse, BasicResponse, and so on)
The Bid InformationServicegetMinBidForKeywordString operation hasbeen deprecated in EWS Version 4.0.0 (refer to the new KeywordService getSponsoredSearchMinBidForKeywordStringoperation).
For moreinformation about our versioning process, please read our Versioning FAQs here.
If you havefurther questions, please contact your Technical Account Manager or ews-help@....
YourPartners at Yahoo! Sea rch Marketing