Google DFP Connector Release Notes

The Anypoint Connector for Google DoubleClick for Publishers enables publishers and third-parties to consume the Google DFP API to help them grow, sell, schedule, deliver, and measure their digital ad inventory on Google DFP through Mule.

MuleSoft maintains the Premium version of the connector under the Certified support policy.

Google DFP 3.1.0 - March 2018

Version 3.1.0 Compatibility

Software	Version
Mule Runtime	3.6+
Google DFP API	v201711

Software

Version

Mule Runtime

3.6+

Google DFP API

v201711

Issues Fixed

Upgraded Google-DFP API version from v201702 to v201711.
Modified key separator for composed selectors in perform operations from || to @@ avoiding conflicts for Windows OS developers.

New Features

None

Upgrading from a Previous Version

The Google DFP 3.1.0 connector offers the same functionality as version 3.0.0.

Google DFP 3.0.0 - March 2017

Version 3.0.0 Compatibility

Software	Version
Mule Runtime	3.6+
Google DFP API	v201702

Software

Version

Mule Runtime

3.6+

Google DFP API

v201702

Issues Fixed

None

New Features

Summary

New operations introduced
Connector devised between Operations (Get, Update, Perform, Update) instead of service
Datasense support has been improved
Upgraded Support for the 2016-11 Google API
Removed operations which cannot be tested in an automated fashion (these might be included on request)
Added functionality to wait reports to be created before returning control
Added support for Google Service Account Authentication

Authentication Methods

OAuth Authentication
NEW Google Service Accounts (JSON file)

Supported Operations

Operations that are Currently Supported (ordered by Service):

Company Service:
- Create Companies
- Get Companies
- Update Companies
Contact Service:
- Create Contacts
- Get Contacts
- Update Contacts
Custom Field Service:
- Create Custom Field Options
- Create Custom Field
- Get Custom Field Option
- Perform Custom Field Action
- Update Custom Field Option
- Update Custom Fields
Custom Targeting Service:
- Create Custom Targeting Keys
- Create Custom Targeting Values
- Get Custom Targeting Keys
- Get Custom Targeting Values
- Perform Custom Targeting Keys
- Perform Custom Targeting Values
- Update Custom Targeting Keys
- Update Custom Targeting Values
Forecast Service:
- Get Availability Forecast
- Get Availability Forecast by ID
- Get Delivery Forecast
- Get Delivery Forecast by ID
Inventory Service (Ad Units):
- Create Ad Units
- Get Ad Units
- Get Ad Unit Sizes
- Perform Ad Units
- Update Ad Units
Line Item Service:
- Create Line Items
- Get Line Items
- Perform Line Items
- Update Line Items
Order Service:
- Create Orders
- Get Orders
- Perform Orders Action
- Update Orders
Placement Service:
- Create Placements
- Get Placements
- Perform Placements
- Update Placements
Publisher Query Language Service:
- Select PQL
Report Service:
- Create Report Asynchronously
- Create Report Synchronously
- Download Report
- Get Report Download Url With Options
- Get Report Status
- Get Saved Queries by Statement
User Service:
- Create Users
- Get All Roles
- Get Current User
- Get Users
- Perform Users
- Update Users
Publisher Query Language Service:
- Select PQL

Upgrading from a Previous Version

The Google DFP 3.0.0 is not backward compatible with V1.x of the connector. The table below describes how each operation performed with v1.x of the connector can be performed (if possible) with the new connector.

Old Operation Name	Current Version
Create Company	Operation: Create Service: Companies
Create Report	Operation: Create Report
Download Report	Operation: Download Report
Get advertiser by name	Operation: Get By Statement Service: Company Query String: type = :type AND name = :name Query Params: type = ADVERTISER, name = CompanyName
Get agency by name	Operation: Get By Statement Service: Company Query String: type = :type AND name = :name Query Params: type = AGENCY, name = CompanyName
Get all companies	Operation: Get by statement Service: Companies
Get company by ID	Operation: Get by statement Service: Companies
Get reconciliation report IDs by start date	Not Supported
Get reconciliation report rows	Not Supported
Update company	Operation: Update Service: Companies

Old Operation Name

Current Version

Create Company

Operation: Create
Service: Companies

Create Report

Operation: Create Report

Download Report

Operation: Download Report

Get advertiser by name

Operation: Get By Statement
Service: Company
Query String: type = :type AND name = :name
Query Params: type = ADVERTISER, name = CompanyName

Get agency by name

Operation: Get By Statement
Service: Company
Query String: type = :type AND name = :name
Query Params: type = AGENCY, name = CompanyName

Get all companies

Operation: Get by statement
Service: Companies

Get company by ID

Operation: Get by statement
Service: Companies

Get reconciliation report IDs by start date

Not Supported

Get reconciliation report rows

Not Supported

Update company

Operation: Update
Service: Companies

Google DFP 2.0.0 - July 2016

Version 2.0.0 Compatibility

The Google DFP connector is compatible with:

Application/Service	Version
Mule Runtime	3.6.1
Google DFP	v201605

Application/Service

Version

Mule Runtime

3.6.1

Google DFP

v201605

Issues Fixed

None

New Features

Company Service:
- Create Company
- Update Company
- Get All Companies
- Get Advertiser by Name
- Get Agency by Name
- Get Company by ID
- Get Companies by ID
- Get Company Comment by Name
- Create Companies
- Get Companies
- Update Companies
Report Service:
- Create Report
- Download Report
Reconciliation Report Service:
- Get Reconciliation Report IDs by Start Date
- Get Reconciliation Reports
- Update Reconciliation Reports
Reconciliation Report Row Service:
- Get Reconciliation Report Rows
- Get Reconciliation Report Rows
- Update Reconciliation Report Rows
Audience Segment Service:
- Get Audience Segments by Statement
Custom Field Service:
- Get Custom Field Option
- Get Custom Fields by ID
- Get Custom Fields by Statement
Line Item Service:
- Get Filtered Line Items by Statement
- Get Line Items by ID
- Get Line Items by Statement
- Create Line Items
- Get Line Items
- Perform Line Items
- Update Line Items
Order Service:
- Get Orders by ID
- Get Orders by Statement
- Create Orders
- Get Orders
- Perform Orders
- Update Orders
Custom Targeting Service:
- Get Custom Targeting Keys by Statement
- Get Custom Targeting Values by Statement
PQL Service:
- Get All Line Items PQL
- Get Proposal Retraction Reason PQL
Product Service:
- Get Products by ID
- Get Products by Statement
- Get Products
- Perform Products
- Update Products
Proposal Template Service:
- Get Product Templates by ID
- Get Product Templates by Statement
Proposal Line Item Service:
- Get Proposal Line Items by ID
- Get Proposal Line Items by Proposal ID
- Get Proposal Line Items by Statement
- Create Proposal Line Items
- Get Proposal Line Items
- Perform Proposal Line Items
- Update Proposal Line Items
Proposal Service:
- Get Proposals by ID
- Get Proposals by Statement
- Create Proposals
- Get Proposals
- Perform Proposals
- Update Proposals
Rate Card Service:
- Get Rate Cards by Last Modified Date
User Service:
- Get Users by ID
- Get Users by Statement
Contact Service:
- Get Contacts by Statement
- Get Contact by ID
- Get Contact by Name
- Create Contact
- Update Contact
Reconciliation Line Item Report Service:
- Get Reconciliation Line Item Reports
- Update Reconciliation Line Item Reports
Reconciliation Order Report Service:
- Get Reconciliation Order Reports
- Perform Reconciliation Order Reports
- Update Reconciliation Order Reports

Upgrading from a Previous Version

The Google DFP 1.1.0 is backward compatible with V1.X of the connector

Google DFP 1.1.0 - August 2015

Version 1.1.0 Compatibility

The Google DFP connector is compatible with:

Application/Service	Version
Mule Runtime	3.6.1
Google DFP	v201505

Application/Service

Version

Mule Runtime

3.6.1

Google DFP

v201505

Issues Fixed

None

New Features

Company Service:
- Create Company
- Update Company
- Get All Companies
- Get Advertiser by Name
- Get Agency by Name
- Get Company by ID
Report Service:
- Create Report
- Download Report
Reconciliation Report Service:
- Create Reconciliation Report Service
- Get Reconciliation Report IDs by Start Date
Reconciliation Report Row Service:
- Get Reconciliation Report Rows

Upgrading from a Previous Version

The Google DFP 1.0.0 is backward compatible with V1.0.0 of the connector

Google DFP 1.0.0 - May 2015

Version 1.0.0 Compatibility

The Google DFP connector is compatible with:

Application/Service	Version
Mule Runtime	3.6.1
Google DFP	v201411

Application/Service

Version

Mule Runtime

3.6.1

Google DFP

v201411

Issues Fixed

None

Features

Company Service:
- Create Company
- Update Company
- Get All Companies
- Get Advertiser by Name
- Get Agency by Name
- Get Company by ID
Report Service:
- Create Report
- Download Report
Reconciliation Report Service:
- Create Reconciliation Report Service
- Get Reconciliation Report IDs by Start Date
Reconciliation Report Row Service:
- Get Reconciliation Report Rows

Upgrading from a Previous Version

There are no versions prior to this.

Resources

Visit the DFP (Premium) Connector User Manual page for the user manual of the connector.
Visit the DFP (Premium) Connector API Reference page for the technical documentation of the connector.
Visit DFP API release notes page for information on DFP v201711 API.
Learn how to Install and Configure Anypoint™ Connectors in Anypoint™ Studio here.
Access MuleSoft’s forum to pose questions and get help from Mule’s broad community of users.
To access MuleSoft’s expert support team, subscribe to Mule ESB Enterprise and log in to MuleSoft’s Customer Portal.
Contact the connector developers at Ricston.