skills.rest
Maosixian
MaosixianCOMMUNITY
Explore all skills by this author →
GitHub

google-ads

Query and manage Google Ads campaigns, ad groups, keywords, and metrics using GAQL.

Updated Mar 12, 2026
Search Tags:#campaign management#keyword analysis#google ads#gaql#ad group management
One-click install
npx skills add https://github.com/Maosixian/selfused-xavier-lobsterop --skill google-ads-maosixian
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: google-ads
Source: https://github.com/Maosixian/selfused-xavier-lobsterop/tree/main/skills/google-ads-api
Command: npx skills add https://github.com/Maosixian/selfused-xavier-lobsterop --skill google-ads-maosixian

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines access to Google Ads data, enabling users to query campaigns, ad groups, keywords, and performance metrics using GAQL, reducing the time and effort required for campaign management.

Core Features & Use Cases

  • Campaign and Ad Group Management: Retrieve and manage details about campaigns and ad groups.
  • Keyword Analysis: Query keyword performance metrics and match types.
  • Performance Metrics: Access detailed performance data for campaigns, ad groups, and keywords.
  • Use Case: Suppose you want to analyze the performance of a specific ad group over the past month. Use this Skill to run a GAQL query and get insights into impressions, clicks, and cost.

Quick Start

To list accessible customers, use the following command:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/google-ads/v23/customers:listAccessibleCustomers')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Frequently Asked Questions about 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?▼

Query Google Ads campaign performance metrics by running GAQL requests through the Skill to retrieve impressions, clicks, and cost data. It automates fetching campaign metrics, reducing the manual effort required for performance analysis.

Can I retrieve ad group and keyword match type data from Google Ads?▼

Retrieve ad group and keyword match type data by sending GAQL queries to the Google Ads API. The Skill supports querying specific ad group details and keyword performance metrics to analyze match types over selected time periods.

Do I need a Maton API key to authenticate Google Ads API requests?▼

Authenticate Google Ads API requests by passing a Maton API key in the Authorization header. The Skill uses this OAuth mechanism to securely connect to the gateway and fetch accessible customer accounts.

What's the best way to automate Google Ads campaign management without manual API calls?▼

Automate Google Ads campaign management by executing GAQL queries directly within the Skill to retrieve and manage campaigns, ad groups, and keywords. This approach eliminates manual API setup and streamlines data extraction.

How do I list accessible customers in Google Ads before running a GAQL query?▼

List accessible customers by sending a request to the Google Ads gateway with your Maton API key. This retrieves all accessible customer accounts, allowing you to identify the correct customer ID for subsequent GAQL queries.

Why does my Google Ads query return empty performance metrics?▼

Google Ads queries may return empty metrics if the GAQL request targets the wrong customer ID or an inactive campaign. Verify accessible customers first and ensure the queried ad group has accumulated data within the specified date range.

Related Skills

Explore More Marketing & Sales Skills→
CraftOS-devCraftOS-dev
375

xero

Manage Xero financial data and generate reports via the Maton API gateway.

Community
Intermediate
itallstartedwithaideaitallstartedwithaidea
1

google-ads-analysis

Analyze Google Ads campaign performance using GAQL metrics and anomaly detection.

Community
Advanced
scumunnascumunna
1

google-ads-optimization-and-troubleshooting

Diagnose and optimize Google Ads campaigns using bid strategy and conversion tracking analysis.

Community
Advanced
juanpvhjuanpvh

google-ads-ratos

Manage Google Ads campaigns and metrics using GAQL queries.

Community
Advanced