googleads

googleads Python Client Library v49.0.0 -- 02/23/2026

• Added support for v202602.
• Removed support for v202502.
• Removed examples for v202505.

googleads Python Client Library v48.0.0 -- 11/18/2025

• Added support for v202511.
• Removed support for v202411.
• Removed examples for v202502.

googleads Python Client Library v47.0.0 -- 08/12/2025

• Added support for v202508.
• Removed support for v202408.
• Removed examples for v202411.

googleads Python Client Library v46.0.0 -- 05/13/2025

• Added support for v202505.
• Removed support for v202405.
• Removed examples for v202408.

googleads Python Client Library v45.0.0 -- 02/18/2025

• Added support for v202502.
• Removed support for v202402.
• Removed examples for v202405.
• Added support for custom polling intervals in WaitForReport.

googleads Python Client Library v44.0.0 -- 11/13/2024

• Added support for v202411.
• Removed support for v202311.
• Removed examples for v202402.

googleads Python Client Library v43.0.0 -- 08/12/2024

• Added support for v202408.
• Removed support for v202308.
• Removed examples for v202311.

googleads Python Client Library v42.0.0 -- 05/07/2024

• Added support for v202405.
• Removed support for v202305.
• Removed examples for v202308.

googleads Python Client Library v41.0.0 -- 02/06/2024

• Added support for v202402.
• Removed support for v202302.
• Removed examples for v202305.

googleads Python Client Library v40.0.0 -- 11/03/2023

• Added support for v202311.
• Removed support for v202211.
• Removed examples for v202302.

googleads Python Client Library v39.0.0 -- 08/14/2023

• Added support for v202308.
• Removed support for v202208.
• Removed examples for v202211.
• Updated setup.py to support the latest 1.x.x google-auth-oauthlib version.

googleads Python Client Library v38.0.0 -- 05/10/2023

• Added support for v202305.
• Removed support for v202205.
• Removed examples for v202208.

googleads Python Client Library v37.0.0 -- 02/16/2023

• Added support for v202302.
• Removed support for v202202.
• Removed examples for v202205.

googleads Python Client Library v36.0.0 -- 12/08/2022

• Removed support for AdWords API.

googleads Python Client Library v35.0.0 -- 10/28/2022

• Added support for Ad Manager v202211.
• Removed support for Ad Manager v202111.
• Updated setup.py to support the latest 2.x google-auth version.
• Removed examples for Ad Manager v202202.

googleads Python Client Library v34.0.0 -- 10/17/2022

• Updated setup.py to support the latest 6.x PyYaml version.

googleads Python Client Library v33.0.0 -- 08/16/2022

• Added support for Ad Manager v202208.
• Removed support for Ad Manager v202108.
• Removed examples for Ad Manager v202111.

googleads Python Client Library v32.0.0 -- 05/17/2022

• Added support for Ad Manager v202205.
• Removed support for Ad Manager v202105.
• Removed examples for Ad Manager v202108.

googleads Python Client Library v31.0.0 -- 02/16/2022

• The minimum supported version of Python is now 3.7.0.
• Added support for Ad Manager v202202.
• Removed support for Ad Manager v202102.
• Removed examples for Ad Manager v202105.

googleads Python Client Library v30.0.0 -- 11/16/2021

• Added support for Ad Manager v202111.
• Removed support for Ad Manager v202011.
• Removed examples for Ad Manager v202102.

googleads Python Client Library v29.0.0 -- 08/16/2021

• Added support for Ad Manager v202108.
• Removed support for Ad Manager v202008.
• Removed examples for Ad Manager v202011.

googleads Python Client Library v28.0.0 -- 05/11/2021

• Added support for Ad Manager v202105.
• Removed support for Ad Manager v202005.
• Removed examples for Ad Manager v202008.

googleads Python Client Library v27.0.0 -- 02/17/2021

• Added support for Ad Manager v202102.
• Removed support for Ad Manager v202002.
• Removed examples for Ad Manager v202005.

googleads Python Client Library v26.0.0 -- 11/10/2020

• Added support for Ad Manager v202011.
• Removed support for Ad Manager v201911.
• Removed examples for Ad Manager v202002.

googleads Python Client Library v25.0.0 -- 08/18/2020

• Added support for Ad Manager v202008.
• Removed support for Ad Manager v201908.
• Removed examples for Ad Manager v201911.

googleads Python Client Library v24.1.0 -- 07/13/2020

• Added 'GoogleCredentialsClient' class to re-use an OAuth2 credentials object

googleads Python Client Library v24.0.0 -- 05/12/2020

• Added support for Ad Manager v202005.
• Removed support for Ad Manager v201905.
• Removed examples for Ad Manager v201908.

googleads Python Client Library v23.0.1 -- 02/20/2020

• Fixed name of 'CreativeReviewService'.

googleads Python Client Library v23.0.0 -- 02/11/2020

• Added support for Ad Manager v202002.
• Removed support for Ad Manager v201902.
• Removed examples for Ad Manager v201905.

googleads Python Client Library v22.0.0 -- 11/05/2019

• Added support for Ad Manager v201911.
• Removed support for Ad Manager v201811.
• Removed examples for Ad Manager v201902.

googleads Python Client Library v21.0.0 -- 08/14/2019

• Added support for Ad Manager v201908
• Removed support for Ad Manager v201808
• Removed examples for Ad Manager v201811
• Updated all Ad Manager examples to reflect Sales Manager sunset

googleads Python Client Library v20.0.0 -- 06/11/2019

• Updated examples to be Python 3 compatible
• Removed suds dependency leaving zeep as the only supported SOAP client

googleads Python Client Library v19.0.1 -- 05/22/2019

• Really removed examples for Ad Manager v201808

googleads Python Client Library v19.0.0 -- 05/09/2019

• Added support for Ad Manager v201905
• Removed support for Ad Manager v201805
• Removed examples for Ad Manager v201808

googleads Python Client Library v18.1.0 -- 04/03/2018

• Upgrade PyYAML to 5.1 >= 6.0
• Update comment in get_all_images_and_videos examples

googleads Python Client Library v18.0.0 -- 03/28/2019

• Removed support for AdWords v201806

googleads Python Client Library v17.0.0 -- 02/12/2019

• Added support for Ad Manager v201902.
• Removed support for Ad Manager v201802.
• Removed examples for Ad Manager v201805.

googleads Python Client Library v16.0.0 -- 01/29/2019

• Removed support for AdWords v201802

googleads Python Client Library v15.0.2 -- 01/08/2019

• Updated PyYAML dependencies to >=4.2b1 for https://nvd.nist.gov/vuln/detail/CVE-2017-18342

googleads Python Client Library v15.0.1 -- 11/16/2018

• Added Smart Shopping ad example (v201809)

googleads Python Client Library v15.0.0 -- 11/14/2018

• Added support for v201811.
• Removed support for v201711.
• Removed examples for v201802.
• Remove ContentMetadataKeyHierarchyService
• Added version parameter to PQL utilities to account for statement differences among API versions. This parameter defaults to the most recent API version. If you update your Python client library but don't plan on migrating to the newest API version, you might need to explicitly declare the version for the PQL utility to use.

googleads Python Client Library v14.1.0 -- 09/21/18

• Added support and examples for AdWords v201809.
• Resolved issues: Issue 281: https://github.com/googleads/googleads-python-lib/issues/281

googleads Python Client Library v14.0.0 -- 08/21/18

DFP rebranded to Google Ad Manager. Google Ad Manager v201808 release. Removed support for DFP v201708. Removed examples for DFP v201711.

googleads Python Client Library v13.0.0 -- 07/25/18

Removed support for AdWords v201710.

googleads Python Client Library v12.2.0 -- 06/18/18

Fixed some DFP examples that would loop forever with Zeep.

googleads Python Client Library v12.1.0 -- 06/06/18

• Added support and examples for AdWords v201806.
• Resolved issues: Issue 282: https://github.com/googleads/googleads-python-lib/issues/282 Issue 288: https://github.com/googleads/googleads-python-lib/issues/288

googleads Python Client Library v12.0.0 -- 05/15/18

• Added support and examples for DFP v201805.
• Removed support for DFP v201705.
• Removed examples for DFP v201708.
• Using the wrong cache type will now raise GoogleAdsValueError instead of ValueError.
• Added support for setting custom HTTP headers.
• Resolved issues: Issue 246: https://github.com/googleads/googleads-python-lib/issues/246 Issue 262: https://github.com/googleads/googleads-python-lib/issues/262 Issue 273: https://github.com/googleads/googleads-python-lib/issues/273 Issue 250: https://github.com/googleads/googleads-python-lib/issues/250

googleads Python Client Library v11.0.1 -- 04/06/18

• Fixed bug related to creating types from services that contain multiple schemas.
• Fixed bug in README.md related to zeep caching.

googleads Python Client Library v11.0.0 -- 03/21/18

• Removed support and examples for AdWords v201705, and v201708.
• The default SOAP backend is now zeep. If you encounter any issues, please report them and use your googleads.yaml file to revert back to suds. Zeep logs to the googleads.soap channel. When using zeep (the default), you no longer need to encode your image assets to base64, this will be done automatically.
• Sunset oauth2client, replaced with google-auth. https://google-auth.readthedocs.io/en/latest/ Updated googleads.yaml to remove service_account_email configurations that are no longer necessary. Removed httplib2 dependency. Added google-auth, google-auth-oauthlib, and requests as dependencies. AdWords and DFP auth examples have been updated to use new OAuth 2.0 dependencies.
• Fixed a bug in IncrementalUploadHelper where the specified server would be lost in serialization/deserialization.
• Breaking changes:
• Connection faults are now raised as GoogleAdsSoapTransportError instances instead of suds errors. Soap faults are now raised as GoogleAdsServerFault instances instead of suds errors. GoogleServiceAccountClient no longer supports P12 key files. GoogleServiceAccountClient's initializer arguments have been refactored; key_file is now a required positional argument, client_email and private_key_password have been removed. Removed Proxy from common.py. When creating a ProxyConfig, you must now provide the full URI for http_proxy and https_proxy rather than a Proxy instance. For an example of what these would look like, see: http://docs.python-requests.org/en/master/user/advanced/#proxies The proxy_config used in googleads.yaml has been updated to better resemble proxy configuration for the underlying HTTP library. The http_proxy and https_proxy configurations have been removed, and replaced with http and https. These take the full proxy URI as their value. Removed proxy_info attribute from ProxyConfig. Refactored proxy_option attribute in ProxyConfig, renamed to proxies.
• Resolved issues: Issue 251: https://github.com/googleads/googleads-python-lib/issues/251 Issue 254: https://github.com/googleads/googleads-python-lib/issues/254

googleads Python Client Library v10.1.0 -- 03/01/18

• Added support and examples for AdWords v201802.
• Added new BuildOpener utility method to ProxyConfig, which returns an OpenerDirector instance configured for the ProxyConfig settings.

googleads Python Client Library v10.0.0 -- 02/13/18

• Added support and examples for DFP v201802.
• Removed support and examples for AdWords v201702.
• Resolved issues: Issue 229: https://github.com/googleads/googleads-python-lib/issues/229 Issue 236: https://github.com/googleads/googleads-python-lib/issues/236

googleads Python Client Library v9.0.0 -- 11/14/17

• Added support and examples for DFP v201711
• Removed support and examples for DFP v201611
• DFP PQL queries can now accept simple python dicts for variable substitution.
• Resolved issues: Issue 230: https://github.com/googleads/googleads-python-lib/issues/230

googleads Python Client Library v8.1.0 -- 10/11/17

• Added support for AdWords v201710.
• Resolved issues: Issue 224: https://github.com/googleads/googleads-python-lib/issues/224 Issue 228: https://github.com/googleads/googleads-python-lib/issues/228

googleads Python Client Library v8.0.0 -- 8/22/17

• Removed support and examples for AdWords v201609.
• Resolved issues: Issue 219: https://github.com/googleads/googleads-python-lib/issues/219 Issue 220: https://github.com/googleads/googleads-python-lib/issues/220

googleads Python Client Library v7.0.0 -- 8/15/17

• Added support and examples for DFP v201708.
• Removed support and examples for DFP v201608.

googleads Python Client Library v6.1.0 -- 8/9/17:

• Added support for AdWords v201708.

googleads Python Client Library v6.0.0 -- 6/27/17:

• Removed support for AdWords v201607.
• Improved logging support. Can now specify logging configuration from the configuration file.
• Added new GoogleAccessTokenClient, a non-refreshable client that only requires the access token.
• Resolved issues: Issue 84: https://github.com/googleads/googleads-python-lib/issues/84 Issue 171: https://github.com/googleads/googleads-python-lib/issues/171

googleads Python Client Library v5.6.0 -- 06/01/17:

• Added support for AdWords v201705.