Tools for listing Google Ads ads under a customer.
list_ads
List Google Ads ads for a customer. Returns each ad's ID, resource name, ad type, status, policy review and approval status, final URLs, display URL, and parent ad group ID.
Filters compose through optional list parameters. Combine them to narrow the result set.
Parameters
| Parameter | Type | Description |
|---|---|---|
customer_id |
string |
Google Ads customer ID. 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. |
page_token |
string | undefined |
Pagination token from a previous response. |
resource_names |
string[] | undefined |
Optional ad_group_ad resource names to filter by. |
campaign_ids |
string[] | undefined |
Optional parent campaign IDs to filter by. |
ad_group_ids |
string[] | undefined |
Optional parent ad group IDs to filter by. |
ad_group_resource_names |
string[] | undefined |
Optional parent ad group resource names to filter by. |
ad_ids |
string[] | undefined |
Optional ad IDs to filter by. |
names |
string[] | undefined |
Optional ad names to filter by. |
statuses |
string[] | undefined |
Optional ad_group_ad.status filter: "ENABLED", "PAUSED", "REMOVED". Defaults to excluding removed ads. |
types |
string[] | undefined |
Optional ad type filter (e.g., "RESPONSIVE_SEARCH_AD", "EXPANDED_TEXT_AD", "VIDEO_AD"). |
display_urls |
string[] | undefined |
Optional display URL filter. |
final_urls |
string[] | undefined |
Optional final-URL filter: matches when the ad contains any of the provided URLs. |
review_statuses |
string[] | undefined |
Optional policy review status filter. |
approval_statuses |
string[] | undefined |
Optional policy approval status filter (e.g., "APPROVED", "DISAPPROVED", "APPROVED_LIMITED"). |
limit |
number | undefined |
Optional upper bound on rows returned. |
Example
Natural Language
List all responsive search ads in ad group 778899 in customer 123-456-7890
Show me disapproved ads in customer 1234567890
Direct Query
{
"tool": "list_ads",
"arguments": {
"customer_id": "123-456-7890",
"ad_group_ids": ["778899"],
"types": ["RESPONSIVE_SEARCH_AD"],
"statuses": ["ENABLED"]
}
}
Related
- list_ad_groups List ad groups containing these ads
- get_insights View ad-level performance metrics