google-ads

Client library for the Google Ads API

google-ads Permissive license Apache-2.0 Active ★ 737 v31.3.0 released 2026-08-13

Install

google-ads on PyPI

pip

pip install google-ads

uv

uv add google-ads

poetry

poetry add google-ads

Package facts

License	Apache-2.0 (permissive)
Python support	supports the current Python release (<3.15,>=3.9)
Install friction	low — pure-Python wheel
Runtime dependencies	8 — google-auth-oauthlib, google-api-core, googleapis-common-protos, grpcio, grpcio-status, proto-plus, PyYAML, protobuf
Maintenance	actively maintained — 0 days since the last release
Last repo commit	2026-08-13
First released	2018-08-03
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: google_ads-31.3.0-py3-none-any.whl

Intended Audience :: DevelopersProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.9

About google-ads

from the package's own PyPI description — quoted content, verbatim

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.9+

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.

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:...

Read as markdown · JSON record · Source repository

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Official Python client library for the Google Ads API, enabling programmatic access to Google Ads accounts for campaign management, reporting, and automation.

Low friction installation with a pure-wheel distribution. Active maintenance with a release on 2026-08-13 and continuous repository activity. Eight runtime dependencies are all established Google client libraries (google-auth-oauthlib, google-api-core, grpcio, protobuf, etc.), suggesting stable, well-maintained upstream.

Licensed under Apache-2.0 (permissive), allowing commercial use, modification, and distribution with minimal restrictions—suitable for proprietary projects.

Usage

pip install google-ads

from google.ads.googleads.client import GoogleAdsClient

client = GoogleAdsClient.load_from_storage('google-ads.yaml')

Requires Python 3.9–3.14 and valid Google Ads API credentials configured in a credentials file (typically google-ads.yaml).

Verdict: A well-maintained, actively developed official Google client library with no known vulnerabilities, permissive licensing, and low installation friction. Suitable for production use in Google Ads integrations, though credential setup and API access are prerequisites.

Needs verification

Whether the eight runtime dependencies introduce any transitive security concerns beyond what OSV reports for google-ads itself.
Whether credential management complexity or API quota limits present practical barriers for typical use cases.

google ads api python clientgoogle ads campaign managementgoogle ads api libraryprogrammatic google adsgoogle ads automation pythongoogle ads reporting apigoogle ads account access