Reads

gads_list_campaigns

List campaigns with performance over N days.

List campaigns with performance over N days. Filter by status. Returns budget, bidding strategy, and the impression-share family — rank-lost IS is the signal-quality/bid lever, budget-lost IS the budget lever. aiMax is the AI Max for Search opt-in (Search campaigns only; null elsewhere). Non-SEARCH channels (PERFORMANCE_MAX, DEMAND_GEN, …) sync campaign-level only — propose only budget/status/target changes for them; structure tools (ad groups/keywords/ads) are Search-only.

Type: read-only. Never changes the account.

Parameters

ParameterTypeRequiredDescription
daysintegerNo(default: 30)
status"ENABLED" | "PAUSED" | "REMOVED"No
limitintegerNo(default: 100)
projectIdstringNoTarget account (project id) — required on account-scoped tools. Call gads_list_ad_accounts to enumerate accounts.

On this page