Today we are launching v201302 of the DFP API. This version includes many of the most requested features, such as managing contacts, running sell-through reports (if enabled on your network), and improved partner management integration. We've also added the new ad rule service, activity/activity group services, content bundle service, as well as many other features, which can all be found on our release notes page.

Keeping in touch

Starting with v201302, you will be able to manage all of your DFP contacts in one place. We believe this is a powerful feature for the API since quite a few publishers have large databases of contacts that can now be easily synced. Once your contacts are in DFP, you can add them to companies and orders. You can also fetch all contacts that haven’t been invited to view their partner orders yet and use that list to invite contacts in the UI.

We've also improved partner management in the API. You can now set up ad units for affiliate/distribution partners using the partnerId field. Once your partner ad units are set up, you can then report on them using partner revenue dimensions and columns.


We've added over 60 new columns and dimensions in this version to more closely match what exists in the UI today. In addition to reporting on your partners as discussed above, you’ll now be able to run sell-through reports (if enabled on your network) on your inventory and reach reports on the lifetime (i.e. the last 6 months) of your orders.

As well as adding new columns, we've also changed a few existing ones. To provide more flexible revenue reporting, existing revenue columns have been renamed to indicate that they do not include cost-per-day (CPD) revenue. New WITH_CPD columns have been added to include CPD revenue in your reports.

Finally, we've made some changes to entity dimensions. Since including a dimension like Dimension.LINE_ITEM added both the name and the ID as columns in the report, the exact behavior of including a dimension wasn't always clear. Ambiguous dimensions have now been replaced by NAME and ID counterparts. To replicate the old behavior, include both of these dimensions in your report.

Housekeeping and deprecation

Starting in v201302, we are shifting many of the disjointed creative asset properties to a single manageable object - CreativeAsset. The first type of creatives to get this treatment is image creative. The 4 fields that previously represented the image asset have been replaced by a single primaryImageAsset field. With the new field, you’ll always know where to find the URL to preview the asset, instead of having to programmatically determine the name of the property.

Last but not least, to make room for all the new features, versions v201203, v201204, and v201206 are now deprecated. On June 1st, we’ll be removing them from our online documentation and client libraries. If you are using one of these deprecated versions, now would be great time to update to take advantage of all the new features.

Be sure to also follow us on our Ads Developer Google+ page. We'll be publishing some great tips on using the API there soon. If you have any suggestions or questions about the new version, but sure to visit our forum.

 - , DFP API Team