list_campaigns
Read-only · Idempotent
Example prompt
Show me the active Permutive-targeted campaigns across my workspaces, sorted by impressions.
Parameters
Restrict to campaigns whose targeting included this cohort (by short id). When set,
impressions and ctr become the cohort’s own targeted figures within each campaign rather than the campaign’s lifetime totals.Case-insensitive substring matched against each campaign’s name and campaign id. Omit to match all campaigns.
When true (the default), only campaigns that use Permutive targeting; when false, all campaigns in the workspace.
Field to order the listing by. Omit for the default order — active campaigns first, then soonest end date. one of:
name, start_date, end_date, impressions, ctr.Order direction. Defaults to ascending. Ignored when sort_by is omitted (the default order is fixed). one of:
asc, desc.Restrict to active or inactive campaigns. A campaign is active when its end date is in the future. Omit for both. one of:
active, inactive.Workspaces whose GAM campaigns (orders) are aggregated into a single flat list. min 1 item.
Returns
Pass as
page_token to fetch the next page. Absent on the last page. Valid for about 15 minutes from the first page, so other tool calls in between are fine.