The DCM/DFA Reporting and Trafficking API v2.7 is deprecated and will be sunset on December 7th, 2017. All users must migrate to a newer API version by that date.

Migrate to a New Version

New versions of the DCM/DFA Reporting and Trafficking API are released regularly. As new versions are released, older versions are deprecated and eventually sunset. When a version is sunset, all requests against that version begin returning errors.

If a version of the API that you're using is deprecated, you'll need to migrate to a newer version before the scheduled sunset date. This guide provides details on how to determine if the API version you're using is deprecated and provides recommended migration steps.

Step 1: Determine which version you're using

If you maintain an application that you suspect may be using a deprecated version of the DCM/DFA Reporting and Trafficking API, you should first verify which specific version you're using. In most cases, you'll be accessing the API via one of our language-specific client libraries. Instructions for finding the API version in use by these client libraries can be found below:

C#

Version information for the Google API Client Library for .NET is exposed in the following places:

  1. Included in the nuget package name and service namespace.
    Google.Apis.Dfareporting.v3_0
  2. Exposed via a public property of DfareportingService.
    Console.WriteLine(DfareportingService.Version);

Java

Version information for the Google API Client Library for Java is exposed in the following places:

  1. Specified in the maven artifactId.
        <dependency>
          <groupId>com.google.apis</groupId>
          <artifactId>google-api-services-dfareporting</artifactId>
          <version>v3.0-rev1-1.21.0</version>
        </dependency>
  2. Included in the JAR filename.

    google-api-services-dfareporting-v3.0-rev1-1.21.0.jar

  3. Exposed via a public property of Dfareporting.

    System.out.println(Dfareporting.DEFAULT_SERVICE_PATH);

PHP

Version information for the Google API Client Library for PHP is exposed via a public property of Google_Client_Dfareporting:

$service = new Google_Client_Dfareporting($client)
print $service->version;

Python

The Google API Client Library for Python is not versioned. The API version to use is specified as an argument to the discovery builder:

discovery.build('dfareporting', 'v3.0', http=http)

Ruby

Google API Client Library for Ruby versions < 0.9 are not versioned. The API version to use is specified as an argument to the service constructor:

service = Google::APIClient::Service.new("dfareporting", "v3.0",
    {
      :application_name => "My application",
      :application_version => '1.0.0',
      :authorization => authorization
    }
)

For Google API Client Library for Ruby versions >= 0.9, version is exposed in the service namespace:

Google.Apis.DfareportingV3_0

Make note of the version you're using, as you'll need this information later on.

Step 2: Determine the status of your version

The Deprecation Schedule lists the status of every version that is currently supported. Find your version in this list and determine it's status as follows:

  1. If there are no dates listed in the Deprecation Date and Sunset Date columns, you're using a fully supported version.
  2. If dates are listed, the version you're using is currently deprecated and will be sunset on the date specified.
  3. If your version isn't listed, it's already been sunset and is no longer supported.

If you fall into #2 or #3 above, you'll need to migrate to a newer version to avoid an interruption in service. It's recommended that you migrate to the most recent version, which is listed at the top of the deprecation schedule table (excluding beta releases). This will afford you the maximum amount of time between upgrades.

Step 3: Upgrade client library versions

If you've determined that you need to migrate, the next step is to obtain an updated build of your preferred client library. While some client libraries may only provide a single build that works with any API version, others will have separate builds for each version. The list below provides general upgrade information for the most widely used client libraries.

C#

The Google API Client Library for .NET provides separate builds for each version of the DCM/DFA Reporting and Trafficking API, distributed via Nuget.

For detailed installation instructions or alternative download options, refer to the client library documentation.

Java

The Google API Client Library for Java provides separate builds for each version of the DCM/DFA Reporting and Trafficking API, distributed via Maven.

For detailed installation instructions or alternative download options, refer to the client library documentation.

PHP

The Google API Client Library for PHP provides separate builds for each version of the DCM/DFA Reporting and Trafficking API, distributed via Packagist.

For detailed installation instructions or alternative download options, refer to the client library documentation.

Python

Every build of the Google API Client Library for Python supports all versions of the DCM/DFA Reporting and Trafficking API. Simply update the version string being passed as an argument to the discovery builder:

discovery.build('dfareporting', 'v3.0', http=http)

For detailed installation instructions or alternative download options, refer to the client library documentation.

Ruby

The Google API Client Library for Ruby v0.8 and lower supports all versions of the DCM/DFA Reporting and Trafficking API. Simply update the version string being passed as an argument to the service constructor:

service = Google::APIClient::Service.new("dfareporting", "v3.0",
    {
      :application_name => "My application",
      :application_version => '1.0.0',
      :authorization => authorization
    }
)

The Google API Client Library for Ruby v0.9+ provides separate builds for each version of the DCM/DFA Reporting and Trafficking API, distributed via RubyGems.

For detailed installation instructions or alternative download options, refer to the client library documentation.

Step 4: Address version differences

We strive to make our new releases backwards compatible, which means that migrating between API versions will not necessitate changes to your code. When this isn't possible, we announce the changes that require action from developers (also known as breaking changes) in our release notes.

At this point, you should review our release notes, beginning with the version after the one you started from (which you made a note of in an earlier section) and continuing up to and including the version you're upgrading to. The sections of the release notes should be interpreted as follows:

  • New features - Newly added functionality.
  • Sunsets - Functionality that has been removed from the API. When available, replacement functionality will be covered in this section.
  • Known issues - Changes that aren't additions or removals. For example, this section may cover fields or methods that have been renamed, or validation logic that has changed.

The functionality in New features will not require code changes and can be ignored for now. Feel free to come back to this section later if you'd like to experiment with something we've added.

If you find changes in the Sunsets or Known issues sections, on the other hand, you may need to take action. You should search through your code to determine if any of the removed or modified functionality is used by your application. If so, you'll need to make updates to your code to address these changes

Stay informed

As mentioned previously, DCM/DFA Reporting and Trafficking API releases and sunsets occur regularly. Updates about new releases, deprecations, and sunsets are posted to the following channels:

It's recommended that you subscribe to one or more of these channels to stay up-to-date with the latest API news.

Send feedback about...

DoubleClick Campaign Manager
DoubleClick Campaign Manager