google-ads-api

Query Google Ads campaign performance data using GAQL and the google-ads-api npm package.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ketzal88/ai-analyzer --skill google-ads-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-ads-api
Source: https://github.com/ketzal88/ai-analyzer/tree/main/.claude/skills/google-ads-api
Command: npx skills add https://github.com/ketzal88/ai-analyzer --skill google-ads-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines interactions with the Google Ads API, enabling efficient data retrieval, campaign management, and troubleshooting for Google Ads integrations.

Core Features & Use Cases

  • GAQL Query Construction: Build and execute complex queries to fetch specific campaign metrics and resource data.
  • API Integration: Facilitates programmatic access to Google Ads data using the google-ads-api npm package.
  • Troubleshooting: Provides guidance on handling API errors, rate limits, and authentication issues.
  • Use Case: Automatically pull daily performance metrics (impressions, clicks, cost) for all active campaigns in a Google Ads account and store them for historical analysis.

Quick Start

Use the google-ads-api skill to fetch campaign performance data for yesterday from customer ID 1234567890.

Frequently Asked Questions about google-ads-api

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

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

You can fetch campaign metrics by constructing a GAQL query to select specific fields like impressions, clicks, and cost, then executing it via the google-ads-api package for programmatic data extraction.

What is the best way to automate Google Ads reporting for an MCC account?

Automating MCC account reporting is supported through the google-ads-api package, allowing you to manage multiple client accounts, handle authentication, and extract campaign performance data programmatically.

How do I handle API rate limits and authentication errors in the Google Ads API?

Handling API rate limits and authentication issues requires specific troubleshooting techniques provided by the skill to manage errors and maintain stable Google Ads API integrations.

Can I use the google-ads-api npm package for programmatic campaign management?

Yes, the google-ads-api npm package facilitates programmatic access to Google Ads data, enabling efficient data retrieval, campaign management, and integration troubleshooting.

What is the resource hierarchy in the Google Ads API and when do I need it?

The resource hierarchy defines the structural relationship between campaigns, ad groups, and other entities in the Google Ads API, which is needed when constructing complex GAQL queries for data extraction.

Why does my GAQL query fail to return campaign data from a specific customer ID?

GAQL queries may fail due to incorrect resource hierarchy references, insufficient authentication permissions, or rate limit constraints when accessing specific customer accounts via the google-ads-api package.