google_ads_recommendations_list
Retrieve Google Ads automated recommendations with type, impact metrics, and campaign context. Filter by campaign or recommendation type to focus results.
Instructions
List Google's current automated recommendations for the account. Returns [{resource_name, type (RecommendationType enum string, e.g. 'KEYWORD', 'TEXT_AD', 'TARGET_CPA_OPT_IN', 'MAXIMIZE_CONVERSIONS_OPT_IN'), impact:{base_metrics:{impressions, clicks, cost_micros}}, campaign_id (resource path when scoped to a campaign)}]. Read-only. Filter by campaign_id to scope to one campaign, or by recommendation_type to scope to one kind. To apply a recommendation use google_ads_recommendations_apply with resource_name from this list.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| customer_id | No | Google Ads customer ID as a 10-digit string without dashes (e.g. '1234567890'). Optional — falls back to GOOGLE_ADS_CUSTOMER_ID / GOOGLE_ADS_LOGIN_CUSTOMER_ID from the configured credentials when omitted. | |
| campaign_id | No | Optional campaign ID as a numeric string. Omit to list account-wide recommendations. | |
| recommendation_type | No | Optional RecommendationType enum string (e.g. 'KEYWORD', 'TEXT_AD', 'TARGET_CPA_OPT_IN'). Validated against the client's allow-list before GAQL embedding. |