---
id: googleads
version: "50.0.0"
license: Apache License 2.0
license_treatment: permissive
maintenance: active
---

# googleads — Google Ads Python Client Library

License: permissive · Maintenance: active · Downloads: 933.1K/mo

## What it is and what it does

googleads is the official Python client library for Google Ad Manager API, providing a wrapper around SOAP/XML-based ad management operations. It handles OAuth2 authentication via google-auth and google-auth-oauthlib, serializes requests and responses using zeep and xmltodict, and manages configuration through PyYAML. The library abstracts away low-level protocol details so developers can focus on ad operations like creating line items, managing inventory, and retrieving reports.

The package carries high install friction because it bundles seven runtime dependencies for authentication, XML processing, and HTTP communication. It is actively maintained with recent releases and a stable repository, making it reliable for production use. The permissive Apache 2.0 license poses no restrictions for commercial deployment.

Use it for:

- Automate line item creation and management in Google Ad Manager without manual UI interaction.
- Build reporting pipelines that fetch ad performance metrics and inventory data programmatically.
- Integrate ad operations into larger media buying or publisher workflows that require API-driven control.
- Manage audience targeting, creative assignments, and trafficking at scale across multiple ad networks.
- Sync ad manager data with internal business intelligence or data warehouse systems.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Client library for interacting with Google Ad Manager API, handling authentication, requests, and response parsing for programmatic ad management.

Yes, if you need to programmatically manage Google Ad Manager. The library is actively maintained, carries no known vulnerabilities, and the Apache 2.0 license is permissive. High install friction (7 dependencies) is justified by the complexity of OAuth2 and SOAP protocol handling. Suitable for production use in ad operations, reporting, and trafficking automation.

## Install

pip install googleads
uv add googleads
poetry add googleads

## Installing googleads

Before you install: High install friction due to 7 runtime dependencies including authentication libraries (google-auth, google-auth-oauthlib), XML/SOAP handling (zeep, xmltodict), and configuration management (PyYAML). Active maintenance with recent release (92 days old) and steady repository activity.

License in practice: Apache License 2.0 is permissive, allowing commercial use, modification, and distribution with minimal restrictions—suitable for most production and proprietary projects.

Quickstart:

pip install googleads

from googleads import ad_manager

client = ad_manager.AdManagerClient.LoadFromStorage()

Requires valid Google Ads credentials file and OAuth2 setup; zeep depends on libxml2 system library on some platforms.

Verify before relying:

- Whether the library supports Google Ads API in addition to Ad Manager API, or only Ad Manager
- Current Python 3.7 classifier may not reflect actual minimum version support in version 50.0.0
- Whether zeep's SOAP implementation introduces latency or compatibility constraints for high-volume workflows

## Package facts

- License: Apache License 2.0 (permissive)
- Python support: unspecified
- Install friction: high
- Maintenance: active
- Downloads: 933.1K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

google ad manager api client, programmatic ad management python, google ads api library, ad manager automation, google ads python sdk, google-ads-api, ad-operations

[View on SkillFed](https://skillfed.io/packages/googleads) · [View on PyPI](https://pypi.org/project/googleads/)