Google Ads Query Parameters
Queries to the Google Ads API are built using the Google Ads Query Language (GAQL). Below are the main parameters and language constructs.
SELECT Parameters
Core Fields
sql
SELECT
campaign.id,
campaign.name,
campaign.status,
metrics.impressions,
metrics.clicks,
metrics.cost_microsAliases
sql
SELECT
campaign.id AS campaign_id,
campaign.name AS campaign_name,
metrics.cost_micros AS costAggregate Functions
sql
SELECT
campaign.id,
SUM(metrics.impressions) AS total_impressions,
AVG(metrics.ctr) AS avg_ctrFROM Parameters
The resource data is queried from:
| Resource | Description |
|---|---|
campaign | Campaigns |
ad_group | Ad groups |
ad_group_ad | Ads |
keyword_view | Keywords |
search_term_view | Search terms |
customer | Account |
WHERE Parameters
Filtering by Value
sql
WHERE campaign.status = 'ENABLED'
AND metrics.impressions > 100Filtering by Date (DURING)
sql
WHERE segments.date DURING LAST_30_DAYS
WHERE segments.date DURING LAST_7_DAYS
WHERE segments.date BETWEEN '2026-07-01' AND '2026-07-25'Operators
| Operator | Example |
|---|---|
= | status = 'ENABLED' |
!= | type != 'VIDEO' |
> | impressions > 100 |
< | cost_micros < 5000000 |
>= | clicks >= 10 |
<= | ctr <= 0.05 |
IN | status IN ('ENABLED', 'PAUSED') |
NOT IN | type NOT IN ('VIDEO', 'DISPLAY') |
LIKE | name LIKE '%brand%' |
NOT LIKE | name NOT LIKE '%test%' |
ORDER BY Parameters
sql
ORDER BY metrics.cost_micros DESC
ORDER BY campaign.name ASC, metrics.clicks DESCLIMIT Parameters
sql
LIMIT 100
LIMIT 1000Maximum limit: 10,000 rows per query.
Pagination Parameters
For queries with more than 10,000 rows, a page_token is used:
POST /customers/{customer_id}/googleAds:search
{
"query": "SELECT ...",
"page_token": "abc123",
"page_size": 10000
}Segmentation (Segments)
Segmentation lets you break down data by additional dimensions:
sql
SELECT
campaign.name,
segments.device,
segments.date,
metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYSCore Segments
| Segment | Description |
|---|---|
segments.date | By day |
segments.week | By week |
segments.month | By month |
segments.quarter | By quarter |
segments.device | By device (DESKTOP, MOBILE, TABLET) |
segments.network | By advertising network |
segments.day_of_week | By day of week |
segments.hour | By hour |