Ad Tools
List Google Ads ads with filters by campaign, ad group, status, type, and policy.
Ad Tools
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
| Prop | Type | Default |
|---|---|---|
customer_id | string | - |
login_customer_id | string | undefined | - |
page_token | string | undefined | - |
resource_names | string[] | undefined | - |
campaign_ids | string[] | undefined | - |
ad_group_ids | string[] | undefined | - |
ad_group_resource_names | string[] | undefined | - |
ad_ids | string[] | undefined | - |
names | string[] | undefined | - |
statuses | string[] | undefined | - |
types | string[] | undefined | - |
display_urls | string[] | undefined | - |
final_urls | string[] | undefined | - |
review_statuses | string[] | undefined | - |
approval_statuses | string[] | undefined | - |
limit | number | undefined | - |