Campaign Tools
List Google Ads campaigns with filters by status, channel type, bidding strategy, and budget.
Campaign Tools
Tools for listing Google Ads campaigns under a customer (ad account).
list_campaigns
List Google Ads campaigns for a customer. Returns each campaign's ID, name, status, serving status, advertising channel type and subtype, bidding strategy, start/end date, optimization score, budget, and targets.
Filtering is exposed through optional list parameters that translate into WHERE … IN (…) clauses on the underlying GAQL query — pass any combination to narrow the result set.
Parameters
| Prop | Type | Default |
|---|---|---|
customer_id | string | - |
login_customer_id | string | undefined | - |
page_token | string | undefined | - |
resource_names | string[] | undefined | - |
campaign_ids | string[] | undefined | - |
names | string[] | undefined | - |
statuses | string[] | undefined | - |
serving_statuses | string[] | undefined | - |
advertising_channel_types | string[] | undefined | - |
advertising_channel_sub_types | string[] | undefined | - |
bidding_strategy_types | string[] | undefined | - |
budget_resource_names | string[] | undefined | - |
budget_amount_micros | number[] | undefined | - |
budget_delivery_methods | string[] | undefined | - |
optimization_scores | number[] | undefined | - |
target_cpa_micros | number[] | undefined | - |
target_roas | number[] | undefined | - |
limit | number | undefined | - |