PyPI · #4805 most downloaded on PyPI

googleads

51.0.0860K downloads/mogoogleads/googleads-python-lib ↗New releases in your daily digest, changelog included.

Google Ads Python Client Library

Last release 24 days ago
24 Aug 2026
Ships on a steady schedule
a new release about every 3 months
Nearly every release is documented
notes for 58 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
110 releases · first in 2014

Release timeline

110 releases since 2014

2014201620182020

Releases

5.5.023 May 2017

Added more expressive python utility to build DFP PQL statements.

googleads Python Client Library v5.5.0 -- 5/23/17:

Added more expressive python utility to build DFP PQL statements.
Support building DFP SOAP entities with native python date/datetime objects.
Added support and examples for DFP v201705.
Removed support and examples for DFP v201605.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

5.4.025 Apr 2017

googleads Python Client Library v5.4.0 -- 4/25/17:

Resolved issues: Issue 200: https://github.com/googleads/googleads-python-lib/issues/200 Issue 196: https://github.com/googleads/googleads-python-lib/issues/196

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

5.3.020 Mar 2017

Removed support for AdWords v201605.

googleads Python Client Library v5.3.0 -- 3/20/17:

Removed support for AdWords v201605.
Removed examples for AdWords v201605.
Added support for the complete set of DFP report download options.
Resolved issues: Issue 169: https://github.com/googleads/googleads-python-lib/issues/169

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

5.2.01 Mar 2017

Added support for AdWords v201702.

googleads Python Client Library v5.2.0 -- 3/1/17:

Added support for AdWords v201702.
Resolved issues: Issue 110: https://github.com/googleads/googleads-python-lib/issues/110 Issue 180: https://github.com/googleads/googleads-python-lib/issues/180

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

5.1.014 Feb 2017

Removed examples for DFP v201605.

googleads Python Client Library v5.1.0 -- 2/13/17:

Added support for DFP v201702.
Removed examples for DFP v201605.
Removed support for DFP v201602.
Resolved issues: Issue 166: https://github.com/googleads/googleads-python-lib/issues/166 Issue 176: https://github.com/googleads/googleads-python-lib/issues/176 Issue 177: https://github.com/googleads/googleads-python-lib/issues/177

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

5.0.013 Jan 2017Breaking

BREAKING CHANGE: The underlying suds client now has cache enabled. By default, suds uses FileCache which requires access to local file system and will…

googleads Python Client Library v5.0.0 -- 1/13/17:

BREAKING CHANGE: The underlying suds client now has cache enabled. By default, suds uses FileCache which requires access to local file system and will break users using Google App Engine. For more details on how to configure or disable caching, see the README.
The library will now automatically apply a monkey patch to the suds-jurko dependency on initialization that will modify the suds.transport.http module. The patch modifies HttpTransport's send method such that it can detect and decompress a gzip encoded SOAP body.
Added new "enable_compression" optional keyword argument for AdWordsClient and DfpClient. If set True, the client will request gzip compression and automatically decompress the SOAP body for you. For more details on this feature, see: https://developers.google.com/adwords/api/docs/guides/bestpractices?hl=en#use_compression
Resolved issues: Issue 77: https://github.com/googleads/googleads-python-lib/issues/77 Issue 97: https://github.com/googleads/googleads-python-lib/issues/97
Resolved pull requests: PR 79: https://github.com/googleads/googleads-python-lib/pull/79 PR 81: https://github.com/googleads/googleads-python-lib/pull/81 PR 91: https://github.com/googleads/googleads-python-lib/pull/91 PR 99: https://github.com/googleads/googleads-python-lib/pull/99

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

4.8.07 Dec 2016

Removed support for DFP v201508 and v201511.

googleads Python Client Library v4.8.0 -- 11/29/16:

Added support for DFP v201611.
Removed support for DFP v201508 and v201511.
Removed examples for DFP v201602.
Resolved issues: Issue 138: https://github.com/googleads/googleads-python-lib/issues/138 Issue 147: https://github.com/googleads/googleads-python-lib/issues/147 Issue 152: https://github.com/googleads/googleads-python-lib/issues/152 Issue 158: https://github.com/googleads/googleads-python-lib/issues/158 Issue 162: https://github.com/googleads/googleads-python-lib/issues/162
Resolved Pull Requests: PR 163: https://github.com/googleads/googleads-python-lib/pull/163

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

4.7.025 Oct 2016

Removed support for AdWords v201603.

googleads Python Client Library v4.7.0 -- 10/25/16:

Removed support for AdWords v201603.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

4.6.13 Oct 2016

Added support for AdWords v201609.

googleads Python Client Library v4.6.1 -- 9/30/16:

Added support for AdWords v201609.
The library now automatically applies filters to log output to sanitize its contents of sensitive data. For more details on how to configure logging or disable log filtering, see the README.
The library will now log warnings if it detects that it is being run with Python versions below 2.7.9.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

4.5.131 Aug 2016

Resolved issue #148: https://github.com/googleads/googleads-python-lib/issues/148

googleads Python Client Library v4.5.1 -- 8/30/2016:

Resolved issue #148: https://github.com/googleads/googleads-python-lib/issues/148

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

4.5.026 Aug 2016

AdWordsClient's initializer no longer requires the user_agent field. This field is also now validated to ensure that it only contains ASCII characters

googleads Python Client Library v4.5.0 -- 8/26/2016

AdWordsClient's initializer no longer requires the user_agent field. This field is also now validated to ensure that it only contains ASCII characters.
Removed support and examples for AdWords v201601.
Removed upgrade_ad_url example for AdWords v201605 and v201607.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

4.4.023 Aug 2016

Removed support for DFP v201505.

googleads Python Client Library v4.4.0 -- 8/23/2016

Removed support for DFP v201505.
Added support for DFP v201608.
Removed examples for DFP v201508 and v201511.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

4.3.029 Jul 2016

Added support for AdWords v201607.

googleads Python Client Library v4.3.0 -- 7/29/2016

Added support for AdWords v201607.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

4.2.017 Jun 2016

Removed support and examples for AdWords v201509.

googleads Python Client Library v4.2.0 -- 6/13/2016

Removed support and examples for AdWords v201509.
The AdWords ReportDownloader now accepts a "client_customer_id" keyword argument that overrides the default client customer ID.
For utilities such as the ReportDownloader or BatchJobHelper, data points about usage are now sent in the user-agent of API requests by default. This can be disabled with the new include_utilities_in_user_agent configuration in the googleads.yaml file.
Added a new parallel_report_download.py example.
Resolved issues: Issue #122: https://github.com/googleads/googleads-python-lib/issues/122 Issue #123: https://github.com/googleads/googleads-python-lib/issues/123

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

4.1.027 May 2016

Added support for AdWords v201605.

googleads Python Client Library v4.1.0 -- 5/26/2016

Added support for AdWords v201605.
Added new use_raw_enum_values keyword argument to the AdWords ReportDownloader utility.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

4.0.017 May 2016Breaking

BREAKING CHANGE: The googleads.common.LoadFromStorage function has been updated to accommodate the current proxy support. This will break users with a…

googleads Python Client Library v4.0.0 -- 5/17/2016

Add support for DFP v201605.
Removed examples for DFP v201505.
Removed support for DFP v201502.
Improved proxy support.
BREAKING CHANGE: The googleads.common.LoadFromStorage function has been updated to accommodate the current proxy support. This will break users with a proxy configured. Check out the changes in our sample googleads.yaml file to see the new format.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

3.15.011 Apr 2016

Removed support for AdWords v201506.

googleads Python Client Library v3.15.0 -- 4/11/2016

Removed support for AdWords v201506.
Resolved issues: Issue #108: https://github.com/googleads/googleads-python-lib/issues/108 Issue #111: https://github.com/googleads/googleads-python-lib/issues/111

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

3.14.025 Mar 2016

Added support for AdWords v201603.

googleads Python Client Library v3.14.0 -- 3/25/2016

Added support for AdWords v201603.
Resolved Issues: Issue #105: https://github.com/googleads/googleads-python-lib/issues/105 Issue #106: https://github.com/googleads/googleads-python-lib/issues/106

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

3.13.023 Feb 2016

Removed support for DFP v201411.

googleads Python Client Library v3.13.0 -- 2/23/2016

Added support for DFP v201602.
Removed support for DFP v201411.
Removed examples for DFP v201502.
The library now applies a temporary patch to the suds-jurko dependency that resolves multiple issues. This patch will be removed when the suds-jurko library publicly exposes its 0.7 release. Thanks to GitHub user adiharush for suggesting the patch!
The LoadFromStorage function can now load credentials for either the installed application or service account (.p12 files only) OAuth 2.0 flows.
The googleads.yaml configuration file has been updated to reflect the changes to the LoadFromStorage function.
Resolved Issues: Issue #58: https://github.com/googleads/googleads-python-lib/issues/58 Issue #62: https://github.com/googleads/googleads-python-lib/issues/62 Issue #63: https://github.com/googleads/googleads-python-lib/issues/63 Issue #68: https://github.com/googleads/googleads-python-lib/issues/68 Issue #78: https://github.com/googleads/googleads-python-lib/issues/78

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

3.12.04 Feb 2016

Removed DoubleClick Ad Exchange content. This API has been sunset.

googleads Python Client Library v3.12.0 -- 02/01/2016

Removed DoubleClick Ad Exchange content. This API has been sunset.
Added support for AdWords v201601.
Updated the AdWords account_management get_account_hierarchy.py example to properly handle the case where ManagedCustomerService.get returns multiple pages of results.
Refactored AdWords upload_offline_conversions.py example, moved to remarketing.
Refactored AdWords add_complete_campaigns_using_batch_job.py example, moved to campaign_management.
The AdWords BatchJobHelper and IncrementalUploadHelper utilities now initialize URLs for v201601 and up.
The AdWords IncrementalUploadHelper is now serializable.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

3.11.024 Nov 2015

Removed support for AdWords v201502.

googleads Python Client Library v3.11.0 -- 11/24/2015

Removed support for AdWords v201502.
Added incremental upload support to BatchJobHelper.
Added the add_keywords_using_incremental_batch_job.py to advanced_operations examples.
Moved add_complete_campaigns_using_batch_job.py to advanced_operations.
The BatchJobHelper can now be used to parse the BatchJob response. Examples have been updated to demonstrate this.
The xmltodict library has been added as a new dependency.
Added option to set additional scopes in generate_refresh_token.py for AdWords and DFP.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

3.10.019 Nov 2015

Removed support for DFP v201405 and v201408.

googleads Python Client Library v3.10.0 - 11/17/2015

Removed support for DFP v201405 and v201408.
Removed examples for v201411.
Added support for DFP v201511.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

3.8.08 Oct 2015

Added support for AdWords v201509.

googleads Python Client Library v3.8.0 - 10/7/2015

Added support for AdWords v201509.
Replaced references to MCC accounts with AdWords manager accounts.
Added upload_media_bundle as a new misc example for AdWords v201509.
Added add_html5_ad as a new advanced_operations example for AdWords v201509.
Added add_crm_based_user_list as a new remarketing example for AdWords v201509.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

3.7.025 Aug 2015

Update ServiceAccount constructor to open p12 file in binary mode.

googleads Python Client Library v3.7.0 - 8/20/2015

Update ServiceAccount constructor to open p12 file in binary mode.
Added support for v201508 for the Doubleclick for Publishers Client Library.
Removed support for v201403 for the Doubleclick for Publishers Client Library.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

3.6.031 Jul 2015

Removed support for AdWords v201409.

googleads Python Client Library v3.6.0 - 7/31/2015

Removed support for AdWords v201409.
Removed examples for AdWords v201409.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

3.5.01 Jul 2015

Added support for v201506 of the AdWords Client Library.

googleads Python Client Library v3.5.0 - 6/26/2015

Added support for v201506 of the AdWords Client Library.
Reporting parameters in ReportDownloader utility now in **kwargs.
Added new "include_zero_impressions" reporting parameter as keyword argument for ReportDownloader utility methods.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

3.4.122 May 2015

| adwords_python2_examples | AdWords Examples for Python 2 |

googleads Python Client Library v3.4.1 - 5/22/2015

Fixed issue #55
Fixed issue #57

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

3.4.019 May 2015

| adwords_python2_examples | AdWords Examples for Python 2 |

googleads Python Client Library v3.4.0 - 5/19/2015

Added support for v201505.
Removed examples for v201405.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

3.3.027 Apr 2015

Removed support for AdWords v201406.

googleads Python Client Library v3.3.0 - 3/25/2015

Fixed issue #47.
Removed support for AdWords v201406.
Removed examples for AdWords v201406.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

3.2.013 Mar 2015

Added support for v201502 of the AdWords Client Library.

googleads Python Client Library v3.2.0 - 3/12/2015

Added support for v201502 of the AdWords Client Library.
Removed CampaignAdExtensionService (from v201502).
Added AccountLabelService (to v201502)
Added hard feed types examples, moved to new "extensions" examples.
Added example for shared sets.
Minor fixes to reporting examples.
Updated some existing samples for new API version.
DFP clients now require you to set an application name.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

3.1.12 Mar 2015

Added support for v201502 for the DoubleClick for Publishers Client Library.

googleads Python Client Library v3.1.0 - 2/17/2015

Added support for v201502 for the DoubleClick for Publishers Client Library.
Removing support for v201311, v201308, and v201306.
Removed examples for v201403.
Updated ForecastService examples.
Added PackageService, ProductPackageService, and ProductPackageItemService.
Fixed comments and settings for targetAll in add_ad_groups.py examples.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

3.1.019 Feb 2015

Added support for v201502 for the DoubleClick for Publishers Client Library.

googleads Python Client Library v3.1.0 - 2/17/2015

Added support for v201502 for the DoubleClick for Publishers Client Library.
Removing support for v201311, v201308, and v201306.
Removed examples for v201403.
Updated ForecastService examples.
Added PackageService, ProductPackageService, and ProductPackageItemService.
Fixed comments and settings for targetAll in add_ad_groups.py examples.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

3.0.121 Jan 2015

| adwords_python2_examples | AdWords Examples for Python 2 |

googleads Python Client Library v3.0.1 - 1/21/2015

Push with updated PyDocs.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

3.0.021 Jan 2015Breaking

BREAKING CHANGE: Python3 versions < 3.3 are no longer supported.

googleads Python Client Library v3.0.0 - 1/5/2015

Three new dependencies have been added: httplib2, oauth2client, and pysocks.
One dependency has been removed: oauthlib
BREAKING CHANGE: Python3 versions < 3.3 are no longer supported.
BREAKING CHANGE: The https_proxy argument for the GoogleRefreshTokenClient has been deprecated. It has been replaced by proxy_info, which is an optional argument taking an httplib2.ProxyInfo instance.
PYTHON2 ONLY: You may now authorize with Service Accounts using the new GoogleServiceAccountClient. As of this release, it will only work with Python2.
Added new Service Account authorization examples for AdWords, DFA, and DFP.
The googleads.yaml file has been refactored to reflect the changes to proxy support.
WARNING: As of this release, you must set disable_ssl_certificate_validation to False when using Python3.
Added new examples for DFP Sales Manager: PremiumRateService, BaseRateService, ExchangeRateService, RateCardService, WorkflowRequestService, ProductService, ProductTemplateService.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

2.3.05 Dec 2014

The return_money_in_micros argument has been removed from the AdWords ReportDownloader.

googleads Python Client Library v2.3.0 - 12/05/2014

Removed v201402 support.
The return_money_in_micros argument has been removed from the AdWords ReportDownloader.
Fixed issue #33: Bad output generated by get_keyword_ideas.py.33
Fixed issue #37: https_proxy wouldn't work for AdWords ReportDownloader.
Fixed issue #39: AdWords ReportDownloader couldn't download report via BytesIO.
Fixed issue #41: estimate_keyword_traffic couldn't handle case where clicksPerDay or impressionsPerDay were 0.
Accepted Pull Request #45: Added manual refresh option to GoogleRefreshTokenClient.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

2.2.011 Nov 2014

Added support for v201411 of the DoubleClick for Publishers Client Library.

googleads Python Client Library v2.2.0 - 11/11/2014

Added support for v201411 of the DoubleClick for Publishers Client Library.
Added SharedAdUnitService and AdExclusionRuleService.
Fixed issue for float support as 'not iterable' (Fixed issue #36).
Added App Engine AdWords example.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

2.1.014 Oct 2014

Added support for v201409 of the AdWords/DoubleClick Ad Exchange Client Library.

googleads Python Client Library v2.1.0 - 10/09/2014

Added support for v201409 of the AdWords/DoubleClick Ad Exchange Client Library.
Added convenience method for setting Client Customer Id to AdWordsClient.
Added ReportDownloader convenience methods.
Fixed upload_offline_conversions example. (Fixed issue #24)
Fixed issue creating complex types. (Fixed issue #18)

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

2.0.23 Sept 2014

Added Ad Customizer example for AdWords.

googleads Python Client Library v2.0.2 - 09/03/2014

Added Ad Customizer example for AdWords.
Extend timeout on SUDs to correspond to access token expiry.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

2.0.120 Aug 2014

Added support for v201408 for DFP client library.

googleads Python Client Library v2.0.1 - 08/20/2014

Added support for v201408 for DFP client library.
Removed RateCardCustomizationService and RateCardCustomizationGroupService, replaced with PremiumRateService.
Changed OAuth2 scope to https://www.googleapis.com/auth/dfp/
Changed DFP endpoint to https://ads.google.com/

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

2.0.022 Jul 2014

AdGroups/Campaigns no longer renamed on remove/delete in examples, obsolete.

googleads Python Client Library v2.0.0 - 07/22/2014

AdGroups/Campaigns no longer renamed on remove/delete in examples, obsolete.
GoogleAdsValueError now thrown when returnMoneyInMicros is sent with v201406.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

1.0.710 Jul 2014

Added support for v201406 of the AdWords/DoubleClick Ad Exchange Client Library.

googleads Python Client Library v1.0.7 - 07/7/2014

Added support for v201406 of the AdWords/DoubleClick Ad Exchange Client Library.
Added CampaignSharedSetService, LabelService, SharedCriterionService, and SharedSetService for AdWords.
Updated AdWords OAuth 2.0 scope. See: https://developers.google.com/adwords/api/docs/guides/authentication.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

1.0.612 Jun 2014

Add support for v201405 for DFP client library.

googleads Python Client Library v1.0.6 - 05/29/2014

Add support for v201405 for DFP client library.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

1.0.59 May 2014

Fixed an issue where PQL fields weren't encoding properly / not handling None responses correctly. This resolves issue #9.

googleads Python Client Library v1.0.5 - 05/07/2014

Fixed an issue where PQL fields weren't encoding properly / not handling None responses correctly. This resolves issue #9.
Fixed an issue where the AdWords ReportDownloader would fail when downloading gzipped reports. Now better documents the need to use binary files in this case. This resolves issue #6.
Fixed an artifact from issue #5, ReportDownloader now sets https_proxy before retrieving the WSDL.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

1.0.423 Apr 2014

Fixed a bug where https_proxy wasn't set for retrieving the API WSDL. This resolves issue #5.

googleads Python Client Library v1.0.4 - 04/22/2014

Fixed a bug where https_proxy wasn't set for retrieving the API WSDL. This resolves issue #5.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

1.0.32 Apr 2014

The common module's LoadFromStorage method now parses the yaml file with safe_load rather than load.

googleads Python Client Library v1.0.3 - 04/02/2014

The common module's LoadFromStorage method now parses the yaml file with safe_load rather than load.
Fixed a typo in examples/dfa/authentication/create_dfa_client_without_yaml.py (the service was 'CampaignService' instead of 'campaign'). This resolves issue #4.
Changed examples/dfa/authentication/create_dfa_client_without_yaml.py to run against the DFA test environment in order to match all other DFA examples.
Changed common._PackForSuds to force suds to serialize empty objects into XML. There are many use cases for this in Google's Ads APIs, such as passing empty search criteria into DFA search methods in order to select everything.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

1.0.220 Mar 2014

Fixed a typo in examples/dfp/auth/generate_refresh_token.py (there was a trailing comma after the scope).

googleads Python Client Library v1.0.2 - 03/20/2014

Fixed a typo in examples/dfp/auth/generate_refresh_token.py (there was a trailing comma after the scope).

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

1.0.113 Mar 2014

Fixed a bug with the AdWords ReportDownloader failing to decode unicode characters in reports. This resolves issue #1.

googleads Python Client Library v1.0.1 - 03/13/2014

Fixed a bug with the AdWords ReportDownloader failing to decode unicode characters in reports. This resolves issue #1.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →

1.0.013 Mar 2014

Initial version of the googleads Python library.

googleads Python Client Library v1.0.0 - 03/05/2014

Initial version of the googleads Python library.

Download	Description
adwords_python2_examples	AdWords Examples for Python 2
adwords_python3_examples	AdWords Examples for Python 3
adxbuyer_python2_examples	Ad Exchange Buyer Examples for Python 2
adxbuyer_python3_examples	Ad Exchange Buyer Examples for Python 3
dfa_python2_examples	DFA Examples for Python 2
dfa_python3_examples	DFA Examples for Python 3
dfp_python2_examples	DFP Examples for Python 2
dfp_python3_examples	DFP Examples for Python 3

Open source →