Announcements

Wednesday, August 29, 2007

Enterprise Web Services Version 3.0.0 Coming Soon

In September 2007, Yahoo! Search Marketing is planning to launch a new version of the Enterprise Web Services (EWS) Marketing API. EWS Version 3.0.0 is a major version release and is backward-incompatible.

About this Release

EWS Version 3.0.0 will be released to the EWS sandbox and production in September 2007. (The new Blocked Domains feature will be available in the sandbox in September 2007, and released to production in October 2007.)

This release is backward-incompatible and requires you to re-compile your code against the V3 WSDLs. We suggest that you first experiment with this version 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.

EWS Version 2.0.0 will be available in production for 60 days after EWS Version 3.0.0 is released. EWS Version 2.0.0 will not be available after the 60-day transition period.

New Features

The new features in EWS Version 3.0.0 are summarized below:

1. Blocked Domains
Blocked domains will enable Yahoo! advertisers to control their participation in the Yahoo! Search Marketing distribution network via specific domain restrictions at the domain, sub-domain and directory levels. Blocked domains can be set at the account level only.

The following operations will be added to AcccountService:

• setBlockedDomainListForAccount sets the blocked domains for the account.
• getBlockedDomainListForAccount gets the blocked domains for the account.
• deleteBlockedDomainListForAccount deletes the blocked domains for the account.

Note: This feature will only be available for US markets in EWS Version 3.0.0.

2. VaultService and Vault Command Group

A new service, VaultService, combines operations that manage sensitive user and account information such as credit cards. Existing operations that will move to this service include:

• addNewCustomer
• addCreditCard
• updateCreditCard
• getPaymentMethods

The addNewCustomer operation will remain in the CustomerService command group. The addCreditCard, updateCreditCard, and getPaymentMethods operations will move to the new Vault Command Group.

3. Tax Codes for European Markets

We have added new elements to the Account data object:

• hasVatRegistrationNumber (for all European markets)
• hasFiscalCode
• FiscalCode (for Italy only)
• hasNifCif (for Spain only)
• NifCif

You can provide values for these elements when you create new accounts using the addAccount and addNewCustomer operations. While you cannot read or update these elements using the getAccount, getAccounts, or updateAccount operations, you can call Yahoo! Search Marketing customer service to get or update the value of these elements.

Questions?

For more information about our versioning process, please read our Versioning FAQs here.

If you have further questions, please email your Technical Account Management Team at ews-help@yahoo-inc.com.

Posted by William McNeal at 3:30 PM