API Reference

Google Ads / API Reference

gads_get_ad_group_keyword_suggestions

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. Get keyword theme suggestions for an ad group (Smart Campaign keyword themes).

This is a read-only tool: it retrieves ad group keyword suggestions 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:

Get ad group keyword suggestions in my Google Ads account for [ad group id].

It takes 1 required and 1 optional parameter.

Parameters

ParameterTypeRequiredDescription
ad_group_idstringYesAd Group Id
customer_idstringNoCustomer Id

Related Google Ads tools

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:

Start using MCP Ads