google-ads-api
Use when working with Google Ads API - campaign management, GAQL queries, reporting, bidding strategies, or ad group operations. Also use when setting up Google Ads API authentication or troubleshooting quota issues.
| Model | Source |
|---|---|
| sonnet | pack: google-apis |
Full Reference
┏━ 🔧 google-ads-api ━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ Use when working with Google Ads API - campaig… ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛
Google Ads API
Section titled “Google Ads API”Google Ads API (v23, Jan 2026) for programmatic campaign management, reporting, and optimization. Uses Google Ads Query Language (GAQL) for data retrieval.
Quick Reference
Section titled “Quick Reference”| Item | Value |
|---|---|
| Current Version | v23 (Jan 28, 2026) |
| Supported Versions | v20, v21, v22, v23 |
| Base URL | https://googleads.googleapis.com |
| Auth | OAuth 2.0 + Developer Token |
| Query Language | GAQL (Google Ads Query Language) |
| Python | pip install google-ads (Python 3.9+) |
| Node.js | npm install google-ads-api (v23.0.0) |
| Micros | All monetary values ÷ 1,000,000 = dollars |
| Mutate limit | 10,000 operations per request |
| Daily ops (Basic) | 15,000 / day |
| Daily ops (Standard) | Unlimited |
Reference Index
Section titled “Reference Index”| File | What’s inside |
|---|---|
reference/versions.md | Version table, release cadence, v21–v23 breaking changes, sunset schedule |
reference/auth.md | OAuth 2.0, service accounts, google-ads.yaml, Python + Node.js client setup, REST endpoints |
reference/gaql.md | GAQL syntax, operators, date literals, common query templates |
reference/campaigns.md | Create campaigns/ad groups/keywords (Python + Node.js), update budgets, negative keywords, pause/remove |
reference/reporting.md | Search vs SearchStream, pandas integration, change history API, recommendations API |
reference/bidding.md | Bidding strategy types, Python + Node.js examples, rate limits, quota table, exponential backoff |
reference/conversions.md | Create conversion actions, offline conversion upload, enhanced conversions, conversion GAQL |
reference/appendix.md | Resource name patterns, micros conversion helpers, official links |
Usage: Read the reference file matching your current task from the index above. Each file is self-contained with code examples and inline gotchas.