Loading ...
Sorry, an error occurred while loading the content.

Enterprise Web Services Version 4.0.0 Sandbox Has Launched

Expand Messages
  • mcnealysm
    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
    Message 1 of 1 , Feb 22, 2008
    • 0 Attachment

      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
                   release.

      �                    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
                   possible.

      �                    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.

      New Features

      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:

      AdGroupService

      �                    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.

      AdService

      �                    getAdsByAdGroupByParticipatesInMarketplace: Returns ads by ad group by marketplace
                   participation.

      �                    getReasonsForAdNotParticipatingInMarketplace: Returns reasons for an ad not
                   participating in a marketplace.

      CampaignService

      �                    getMinBidForCampaignOptimizationGuidelines: Returns minBid for
                   CampaignOptimization Guidelines by campaign ID.

      KeywordService

      �                    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
                   keyword.

      �                    getSponsoredSearchMinBidForKeywordStrings: Returns Sponsored Search min bids for
                   multiple keywords.

      �                    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:

      �                    BidStatus

      �                    BidUpdateInfo

      �                    NotParticipatingInMarketplaceReason

      �                    SponsoredSearchMinBidRequest

      �                    Warning

      New EWS Data Object Elements

      New elements have been added to the following data objects withthe release of EWS Version 4.0.0:

      �                    Ad

      �                    AdGroup

      �                    Keyword

      �                    Allresponse objects (AdGroupResponse, AdResponse, BasicResponse, and so on)

      Deprecated Features

      The Bid InformationServicegetMinBidForKeywordString operation hasbeen deprecated in EWS Version 4.0.0 (refer to the new KeywordService getSponsoredSearchMinBidForKeywordStringoperation).

      Questions?

      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@....

      Sincerely,

      YourPartners at Yahoo! Sea rch Marketing

    Your message has been successfully submitted and would be delivered to recipients shortly.