Google Ads / API Reference
gads_list_ads_by_status
Google Ads tool (extended/low-level coverage). For common tasks prefer the RECOMMENDED google_ads_* actions; use these only for advanced operations those don't cover. List ads filtered by status (ENABLED/PAUSED/REMOVED). Optional campaign_id / ad_group_id filter.
This is a read-only tool: it lists ads by status from your Google Ads account. It changes nothing.
Ask Claude
You do not call this tool yourself. Ask for the outcome and the client picks the tool:
List ads by status in my Google Ads account for [status].
It takes 1 required and 4 optional parameters.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | Yes | Status |
campaign_id | string | No | Campaign Id |
ad_group_id | string | No | Ad Group Id |
limit | integer | No | Limit |
customer_id | string | No | Customer Id |
Related Google Ads tools
gads_list_ads_by_ad_strengthgads_list_ads_by_campaigngads_list_ads_by_date_rangegads_list_ads_by_final_urlgads_list_ads_by_labelgads_list_ads_by_policy_status
Before you can call it
This tool needs a connected Google Ads account. The Google Ads connect guide covers the OAuth flow and the permissions it asks for, and the quickstart gets a client talking to the server in about five minutes.
Workflows that use this
Rather than calling tools one at a time, these skills run a whole procedure against the same account: