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
| Parameter | Type | Description |
|---|---|---|
customer_id |
string |
Google Ads customer ID (the account to query). Accepts dashed (123-456-7890) or digits-only (1234567890) format. Required. |
login_customer_id |
string | undefined |
Manager (MCC) customer ID for the login-customer-id header. Required when querying an account accessed via an MCC. |
page_token |
string | undefined |
Pagination token from a previous response. Omit for the first page. |
resource_names |
string[] | undefined |
Optional campaign resource names to filter by. |
campaign_ids |
string[] | undefined |
Optional campaign IDs to filter by. |
names |
string[] | undefined |
Optional campaign names to filter by. |
statuses |
string[] | undefined |
Optional status filter: enum names like "ENABLED", "PAUSED", "REMOVED". When omitted, removed campaigns are excluded. |
serving_statuses |
string[] | undefined |
Optional campaign serving-status filter. |
advertising_channel_types |
string[] | undefined |
Optional advertising_channel_type filter (e.g., "SEARCH", "DISPLAY", "VIDEO", "PERFORMANCE_MAX"). |
advertising_channel_sub_types |
string[] | undefined |
Optional advertising_channel_sub_type filter. |
bidding_strategy_types |
string[] | undefined |
Optional bidding_strategy_type filter. |
budget_resource_names |
string[] | undefined |
Optional linked campaign budget resource names. |
budget_amount_micros |
number[] | undefined |
Optional exact-match budget amount filter (in micros: 1,000,000 micros = 1 unit of currency). |
budget_delivery_methods |
string[] | undefined |
Optional budget delivery method filter. |
optimization_scores |
number[] | undefined |
Optional exact-match optimization score filter. |
target_cpa_micros |
number[] | undefined |
Optional exact-match target CPA filter (in micros). |
target_roas |
number[] | undefined |
Optional exact-match target ROAS filter. |
limit |
number | undefined |
Optional upper bound on rows returned. Pass null/undefined to return all matches (subject to API paging). |
Example
Natural Language
Show me all enabled campaigns in customer 123-456-7890
List Search campaigns in customer 1234567890 paused in the last week
Direct Query
{
"tool": "list_campaigns",
"arguments": {
"customer_id": "123-456-7890",
"statuses": ["ENABLED"],
"advertising_channel_types": ["SEARCH"],
"limit": 50
}
}
Related
- list_ad_groups Drill into ad groups within these campaigns
- get_insights View campaign-level performance metrics