Menu
Performs a dry-run validation of a GAQL query using the Google Ads API validate_only parameter.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Explains Google Ads API concepts, code snippets, or queries in plain English using real-world analogies.
Extracts the version from agent.json and makes it available during the session.
Retrieves a list of all child customer account IDs (CIDs) under a given Manager Account (MCC).
Inspects any Google Ads API Protobuf resource, nested message or Enum structure.
Configures Asset Group URL expansion filters (listing group webpage exclusions) for Performance Max campaigns.
Presents a response as a step-by-step process for the user to follow.
| name | validate-gaql |
| description | Performs a dry-run validation of a GAQL query using the Google Ads API validate_only parameter. |
This skill validates a GAQL query by performing a dry-run execution against the Google Ads API.
GoogleAdsFieldService.search_google_ads_fields to verify field existence, selectability, and filterability.selectable_with attribute. Verify all selected fields are compatible.WHERE fields MUST be in SELECT (unless core date segments).OR is forbidden. Use IN or multiple queries.FROM clause in metadata queries.GoogleAdsFieldService.search_google_ads_fields, field names MUST NOT be prefixed with the resource name (e.g., use name, not google_ads_field.name). Do NOT use GoogleAdsService to query google_ads_field. Failure results in UNRECOGNIZED_FIELD../.venv/bin/python3 .agents/skills/validate_gaql/scripts/validate_gaql.py --customer_id <customer_id> --api_version <api_version> << 'EOF'
SELECT campaign.id, campaign.name FROM campaign
EOF