execute_query
Run GAQL queries to retrieve Google Ads campaign, ad group, keyword, and performance metrics from your account.
Instructions
Execute a Google Ads Query Language (GAQL) query.
Use this for any read operation - campaigns, ad groups, keywords, ads, metrics, etc.
Common queries:
Campaigns: SELECT campaign.id, campaign.name FROM campaign
Ad groups: SELECT ad_group.id, ad_group.name FROM ad_group
Keywords: SELECT ad_group_criterion.keyword.text FROM ad_group_criterion
Metrics: SELECT campaign.name, metrics.clicks FROM campaign
Args: query: The GAQL query to execute customer_id: Target customer ID (optional if set in config). Use digits only, no dashes.
Returns: List of result rows as dictionaries
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| customer_id | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |