google-ads

Google Ads API Client Library for Python

This project hosts the Python client library for the Google Ads API.

Build Status

|build-status|

Requirements

• Python 3.8+

Installation

.. code-block::

pip install google-ads

Features

• Distributed via PyPI.
• Easy management of credentials.
• Easy creation of Google Ads API service clients.

Documentation

Please refer to our Developer Site_ for documentation on how to install, configure, and use this client library.

Protobuf Messages

Version 14.0.0_ of this library introduced the required use_proto_plus configuration option that specifies which type of protobuf message to use. For information on why this flag is important and what the differences are between the two message types, see the Protobuf Messages_ guide.

Minimum Dependency Versions

Version 21.2.0_ of this library lowered the minimum version for some dependencies in order to improve compatibility with other applications and packages that rely on protobuf_ version 3.

Note that using protobuf 3 will cause performance degredations in this library, so you may experience slower response times. For optimal performance we recommend using protobuf versions 4.21.5 or higher.

Miscellaneous

• Issue tracker_
• API documentation_
• API Support_

Authors

• Mark Saniscalchi_
• David Wihl_
• Ben Karl_
• Andrew Burke_
• Laura Chevalier_
• Bob Hancock_

.. |build-status| image:: https://storage.googleapis.com/gaa-clientlibs/badges/google-ads-python/buildstatus_ubuntu.svg .. _Developer Site: https://developers.google.com/google-ads/api/docs/client-libs/python/ .. _Issue tracker: https://github.com/googleads/google-ads-python/issues .. _API documentation: https://developers.google.com/google-ads/api/ .. _API Support: https://developers.google.com/google-ads/api/support .. _Mark Saniscalchi: https://github.com/msaniscalchi .. _David Wihl: https://github.com/wihl .. _Ben Karl: https://github.com/BenRKarl .. _Andrew Burke: https://github.com/AndrewMBurke .. _Laura Chevalier: https://github.com/laurachevalier4 .. _Bob Hancock: https://github.com/bobhancock .. _14.0.0: https://pypi.org/project/google-ads/14.0.0/ .. _21.2.0: https://pypi.org/project/google-ads/21.2.0/ .. _Protobuf Messages: https://developers.google.com/google-ads/api/docs/client-libs/python/protobuf-messages .. _protobuf: https://pypi.org/project/protobuf/