Reads
gads_get_search_terms
Top search terms by cost over N days — the raw queries that triggered ads.
Top search terms by cost over N days — the raw queries that triggered ads. Mine for negative keywords and new keyword ideas.
Scope: read token (or higher). Read-only.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
campaignId | string | No | |
adGroupId | string | No | |
days | integer | No | (default: 30) |
minClicks | integer | No | (default: 0) |
limit | integer | No | (default: 100) |
projectId | string | No | Target account (project id). Required with an org-scoped token for account-scoped tools — call gads_list_ad_accounts to enumerate accounts. Omit with a project-scoped token. |
gads_get_optimization_plan
The deterministic optimization plan for this account: the operator's targets (daily spend goal, ROAS floor, CPA band), current pacing vs the goal, and the ranked recommendation fee
gads_get_segment_performance
Warehoused segment performance for one dimension — device, geo (targeted locations), day_of_week, hour, age, gender, or income — per campaign, with labeled buckets, currency units,