Skill

google-ads

Google Ads API for account discovery, GAQL reporting, campaigns, budgets, assets, conversions, audiences, planning, and billing operations.

Verified: 2026-05-13 (printing-press-ingest-2026-05-13+enrich-capability-skill)

When to use google-ads

Choose if

You're running paid-search workflows from an agent loop and need full read+write coverage of Google Ads — campaigns, budgets, assets, conversions, audiences, keyword planning, batch jobs — with typed exit codes and GAQL search/search_stream for reporting. You already have a Google Ads developer token and accept that this CLI can mutate live ad accounts.

Avoid if

You don't have a Google Ads developer token (the upstream API is gated and bills against real ad spend). Also avoid when the agent doesn't have guard rails for destructive operations — campaign and budget mutations move real money. For read-only ad-spend telemetry, a reporting-only wrapper would be safer.

Risk Flags

  • HIGH scope This CLI can mutate live ad accounts — campaigns, budgets, assets, bidding strategies, conversion uploads, audiences. Destructive ops require --yes for confirmation but agent autonomy on a production Ads account can move real money if guard rails aren't set.
  • MEDIUM rate_limit Exit code 7 signals rate limiting; the README does not publish concrete thresholds. Google Ads API also gates user-list planning ("less than 10 days old, less than 10,000 or more than 700,000 users").
  • MEDIUM runtime Long-running operations (batch jobs, experiments) return operation IDs and require manual polling via GetOperation; ListExperimentAsyncErrors surfaces failures. Agents must handle async semantics, not just request/response.
  • MEDIUM auth Requires Google Ads developer token + OAuth credentials. Without the full credential triad (token + client + refresh) every endpoint exits code 4.

Cost

Type: Usage based · Free tier: The CLI binary is MIT-licensed and free. Google Ads API access requires a developer token (Standard or Basic access) and OAuth credentials — the README does not publish API pricing.

Hidden costs

  • Google Ads API requires a Google Ads developer token and an active Ads account; CLI itself is free, but the underlying ad spend is the real cost surface.

Install

Default

go install github.com/mvanhorn/printing-press-library/library/marketing/google-ads/cmd/google-ads-pp-cli@latest

Setup docs →

Estimated time to first success: ~20 min

Dependencies

Minimum runtime: Go (binary download; source build needs Go 1.26.3+)

Distribution

Repository
https://github.com/mvanhorn/printing-press-library
License
MIT