Announcing the Java Client Library and Updated Resources

We've added a third client library for use by DFA developers, this time in Java! The library is an early release that takes advantage of a new framework for client libraries supporting our ads APIs.

Some features of the DFA library and the new framework include:

• Distributed via Maven


• Requests and SOAP messages are logged using the SLF4J logging facade, allowing you to plug in the logging framework of your choice


• Automatic handling of SOAP headers


• Easy management of credentials, authentication, and session information

You can read more about the Java client library and download an example project utilizing it on its Google Code site.

In addition to launching this new client library, we have also updated our existing developer resources. The Python and .NET client libraries now support v1.15. The Ruby and PHP standalone examples have been updated for v1.15 and both now have ten additional examples. The standalone Java examples have been retired in favor of the Java client library and will no longer be updated with each release.

Your concerns and questions are always welcome on our forum. We are especially interested in hearing any feedback you have about the new client library.

– Joseph DiLallo, the DFA API Team

DFA Developer Resources Updated for v1.14

Whether you are an existing DFA API developer or building your first application, you can now take advantage of updates to our resources. The v1.14 release of our API did not modify any of the objects in our services, so these examples mainly showcase how to migrate applications from one version of the API to another. You can find the new Java, Ruby, and PHP examples on their project site, while the Python client library and .NET client library updates are located on their own pages.

New Reference Sidebar

We realize that our resources are spread out across multiple sites and it may not always be easy to find what you are looking for. While there is a need for our content to be set up this way, we’ve been trying to make it easier to bring all of this content together. Thus was born a new reference sidebar:

This sidebar appears on the service-level pages of the DFA code site and links to content in our examples and client libraries, as well as to related posts on this blog. A special thanks goes out to Eric Koleda, who originally developed this tool for AdWords developers and has now made it possible for DFA developers to benefit from this work as well.

As always, your feedback is important to us. Please bring any questions or comments to our forum.

- Joseph DiLallo, the DFA API Team

Announcing the DFA Python Client Library

Python aficionados rejoice: It’s your time in the client library spotlight. Access to the DoubleClick for Advertisers (DFA) API is now easier than ever with the release of our second open source client library. This library aims to assist you in writing Python DFA clients, and lists among its features:

• The ability to hide the SOAP layer from end users.
• On demand logging of all SOAP messages.
• Support for API calls against the production and test environments.
• Automatic data type conversion for all API call parameters.

Additional information can be found at the DFA API code site’s client libraries page. Bugs and feature requests can be filed at the Ads APIs Python Client Libraries' issues page.

As always, please bring your questions or feedback to our forum.

- Joseph DiLallo, the DFA API Team

New and Updated Resources for DFA Developers

Continuing our efforts to aid developers using the DoubleClick for Advertisers (DFA) API, we have updated our Java examples and the .NET client library with support for v1.13. These updates include coverage for the new report web service complete with examples. In addition, there are now PHP examples located on our examples site.

RCReport Translated to the Web Services

Many of you have been taking advantage of command line tools known as RCRunner to download reports from Report Central. One of the new examples of the report web service is a fully functional migration of RCRunner’s RCReport program from the Java DART API to the DFA API. It is currently available in Java and C#. Mimicking the functionality of the RCQueryRunner program is not possible with the web services.

We hope you will find these new resources useful. We are currently planning to create a Java client library next, though it will not be ready for release for some time to come. If there is anything that you’d like to see next or something you think would be especially useful, let us know! Feedback is always welcome on our forum.

- Joseph DiLallo, the DFA API Team

New DFA .NET Client Library

We are happy to announce the release of our new DoubleClick for Advertisers .NET client library.

The DoubleClick for Advertisers API .NET Client Library makes it easier to write .NET clients which access the DFA platform. Main features include:

• Support for .NET SDK 2.0 and above.
• Outgoing and incoming SOAP messages are monitored and logged.
• Support for API calls to test, beta or production environments.
• As opposed to autogenerated stubs from wsdl.exe, you don't have to specify xxxSpecified = true for each nullable property.
• Support for specific DFA exceptions instead of generic SoapExceptions.

Additional information can be found at the DFA API code site’s client libraries page.

Bugs and feature requests can be filed at https://code.google.com/p/google-api-dfa-dotnet/issues/list.

Questions or feedback are always welcome at the DFA API Forum.

– Joseph DiLallo, The DFA API Team