Author Archive

We are pleased to announce the release of the AdWords API Version 3.

Version 3 includes support for our new Content Bidding functionality. For background information on the Content Bidding feature, please see our earlier post entitled “Exposing Content Bidding via the API in January.”

In addition, the campaignNegativeKeywords field is deprecated. Please use setCampaignNegativeCriteria and getCampaignNegativeCriteria requests in CriterionService instead.

For technical details about v3 and Content Bidding, please review the Release Notes section of the Developer’s Guide.

Per our new versioning system, version 2 of the API will be supported until March 1, 2006, at which time it will be turned off. Therefore, please make sure that you upgrade your code to v3 before then.

And for more information about versioning, please see today’s post entitled “API Versioning is Live.”

-- Rohit Dhawan, Product Manager

I wanted to follow-up on the Feb 2nd roll-back of Versioning and Content Bidding.

We are wrapping up the bug fix for these two releases and will test them over the weekend. Therefore, we are planning to re-release sometime next week.

We apologize again for any inconveniences this may have caused.

-- Rohit Dhawan, Product Manager

Two days ago we started redeploying our “versioned” services on a few servers. We will make an announcement when the deployment is complete. Only then can you start taking advantage of version 3.

This redeployment should not disturb your software (which still uses version 2), However… there is one issue…

We now enforce strict namespace checks. Because we introduced versioning, and because the schemas for the payloads are different in the two versions, the URLs used to qualify the AdWords API namespace now matter.

For version 2 use => https://adwords.google.com/api/adwords/v2
For version 3 use => https://adwords.google.com/api/adwords/v3.

This should be of no consequence to developers who use a SOAP toolkit to generate their language bindings, since the toolkit will pick up the correct namespace URL from the WSDL. However, this could cause issues for some developers who handcraft their XML: we have seen requests coming in with namespaces such as https://adwords.google.com/api/adwords/v2/KeywordService. This worked before versioning was introduced, but it won't work anymore now.

This is explained in the Release Notes.

If you start getting errors like "The request namespace is invalid for the service URL," you should check that your software generates the correct namespace for your request payloads.

--Patrick Chanezon, AdWords API evangelist

We are happy to announce the re-release of API Versioning and the AdWords API Version 3 (V3).

And… since we had an extra two weeks of development time, we were able to include the AdWords Keyword Tool.

So to recap…

Version 3 includes support for our new Content Bidding functionality. For background information on the Content Bidding feature, please see our earlier post entitled “Exposing Content Bidding via the API in January”.

In addition, we have exposed the AdWords Keyword Tool via a new KeywordToolService.

Finally, the campaignNegativeKeywords field is deprecated. Please use setCampaignNegativeCriteria and getCampaignNegativeCriteria requests in CriterionService instead.

Per our earlier stated policy, V2 will be supported for one month from today, at which time it will be turned off. Therefore, please make sure that you upgrade your code to v3 before March 27, 2006.

For technical details about V3, please review the Release Notes section of the Developer’s Guide.

-- Rohit Dhawan, Product Manager

Thank you all for your feedback on our recent release of API Versioning.

Based on your feedback, we have increased our support period for older versions from 1 to 2 months. Therefore, when a new version of the AdWords API is released, we will continue to support the previous version for two full months before shutting it off.

For example, we recently released Version 3 on February 27. Therefore, we will continue to support Version 2 through Tuesday, May 2, 2006.

We hope you find this change helpful and thank you again for your support for the AdWords API.

-- Rohit Dhawan, Product Manager

Per my earlier post about our Version Support Policy, we will now support Version 2 of the AdWords API through Tuesday, May 2, 2006.

Please make sure you have upgraded to Version 3 by this date in order to ensure uninterrupted service.

-- Rohit Dhawan, Product Manager