pp-google-ads

Automate Google Ads API account discovery, GAQL reporting, and campaign management via authenticated requests.

Updated May 22, 2026
One-click install
npx skills add https://github.com/shekerkamma/peopletech-marketplace --skill pp-google-ads-shekerkamma
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: pp-google-ads
Source: https://github.com/shekerkamma/peopletech-marketplace/tree/main/plugins/integrations/skills/google-ads
Command: npx skills add https://github.com/shekerkamma/peopletech-marketplace --skill pp-google-ads-shekerkamma

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the complexity of manually navigating the Google Ads API to pull reports, manage campaigns, and analyze audience data, which typically requires writing custom scripts or using multiple disconnected tools.

Core Features & Use Cases

  • GAQL Reporting: Run custom Google Ads Query Language queries to extract campaign performance, keyword metrics, and billing data.
  • Campaign Management: Create, update, and pause campaigns, ad groups, and budgets programmatically.
  • Audience Insights: Generate audience composition reports, trending insights, and targeting suggestions.
  • Use Case: A marketing analyst needs to pull last week's search term performance for 50 campaigns and identify underperforming keywords to pause. Instead of exporting CSVs from the UI, they use this Skill to run a single GAQL query and get structured results instantly.

Quick Start

Use the pp-google-ads skill to run a GAQL query for campaign performance metrics from the past 7 days and return the results as a JSON table.

Frequently Asked Questions about pp-google-ads

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query Google Ads campaign performance metrics using GAQL?

You can query Google Ads campaign performance using GAQL by running custom Google Ads Query Language queries to extract campaign metrics, keyword performance, and billing data, returning structured results instantly without manual UI exports. This automates reporting across multiple accounts.

Can I manage Google Ads campaigns and budgets programmatically from the terminal?

Yes, you can manage Google Ads campaigns programmatically from the terminal by creating, updating, and pausing campaigns, ad groups, and budgets. This requires OAuth2 access tokens and developer tokens configured as environment variables to authenticate against the googleads.googleapis.com endpoint.

What do I need to authenticate against the Google Ads API for reporting?

To authenticate against the Google Ads API, you need OAuth2 access tokens and developer tokens configured as environment variables. These credentials allow your terminal commands to securely interact with the googleads.googleapis.com endpoint for account discovery and reporting.

Does this approach work for generating audience insights and targeting suggestions?

Yes, this approach works for generating audience insights by creating audience composition reports and trending insights. It also provides targeting suggestions to help marketing analysts identify underperforming keywords and optimize ad operations.

What is the best way to pull search term performance for multiple Google Ads campaigns?

The best way to pull search term performance for multiple campaigns is running a single GAQL query instead of exporting CSVs from the UI. This returns structured results instantly, allowing you to quickly identify and pause underperforming keywords across all accounts.

Are there limitations when using terminal commands for Google Ads campaign management?

Limitations include the requirement for OAuth2 and developer tokens as environment variables for authentication. Without these properly configured credentials, campaign mutations, conversion tracking, and billing operations against the googleads.googleapis.com endpoint will fail.