Creates a Search ad group inside a campaign.

Ad groups default to ENABLED because the campaign itself is created PAUSED; nothing serves until the campaign is enabled with confirm=true.

Enables, pauses or removes an ad group. REMOVED needs confirm=true.

Changes an ad group's default max CPC (MANUAL_CPC campaigns). Needs confirm=true.

Adds keywords to an ad group.

Adds negative keywords to one ad group. For campaign-wide negatives use campaigns.add_campaign_targeting.

Pauses, enables or removes keywords (ad group criteria). REMOVED needs confirm=true.

Find criterion ids with search on ad_group_criterion (ad_group_criterion.criterion_id).

Creates a responsive search ad in an ad group.

Copy is checked locally against Google's limits before the API call: 3-15 headlines of max 30 chars, 2-4 descriptions of max 90 chars, display paths of max 15 chars, no duplicate lines, no all-caps, no '!' in headlines. Aim for 8-15 distinct headlines and 4 descriptions; Google rates ad strength on variety.

The ad defaults to ENABLED because the campaign is PAUSED until confirmed.

Replaces the copy of an existing responsive search ad.

Headlines and descriptions are replaced as whole sets (pass the full list you want to end up with). Editing an ad resets its performance history in the UI; for A/B tests prefer creating a second ad in the same ad group.

Enables, pauses or removes an ad. REMOVED needs confirm=true.

Creates sitelink assets and attaches them to a campaign. Add at least 4 for full effect.

Creates callout assets ("Free Quote", "24/7 Support") and attaches them to a campaign.

Creates a website conversion action (the thing bidding optimises for).

After creating it, fetch the tag with search on conversion_action selecting conversion_action.tag_snippets and install the event snippet on the site, or fire it through Google Tag Manager.

Creates a campaign budget. Do this before create_campaign.

Changes the daily amount of an existing budget. Needs confirm=true to apply.

Creates a Search campaign, always PAUSED. Enable it later with set_campaign_status.

Typical order: create_campaign_budget -> create_campaign -> add_campaign_targeting -> ad_groups.create_ad_group -> ad_groups.add_keywords -> ads.create_responsive_search_ad -> review -> set_campaign_status(ENABLED, confirm=true).

Enables, pauses or removes a campaign.

PAUSED applies immediately (it only stops spend). ENABLED starts spend and REMOVED is permanent, so both need confirm=true; without it you get a validated preview.

Renames a campaign, changes its dates, or points it at another budget.

Bidding strategy changes are deliberately not exposed here; create a new campaign instead so the learning history is not disturbed by accident.

Looks up geo target ids for place names. Use before add_campaign_targeting.

Adds locations, languages and campaign-level negative keywords to a campaign.

Removes campaign criteria (locations, languages, negatives) by criterion id. Needs confirm=true.

Find criterion ids with search on campaign_criterion (campaign_criterion.criterion_id).

Returns ids of customers directly accessible by the user authenticating the call.

Use this tool first to discover available customer IDs if the user hasn't provided one. Most other tools require a valid customer ID as input.

Returns: List[str]: A list of customer IDs.

Retrieves the selectable, filterable, and sortable fields for a specific Google Ads resource, including compatible metrics and segments.

Use this tool to find out which fields you can select, filter by, or sort by when querying a specific resource (e.g., 'campaign', 'ad_group'). This tool also returns metrics and segments that can be selected with the resource. Their names start with 'metrics.' and 'segments.' respectively.

Do not guess fields, you MUST use this tool to discover them before constructing a query for the search tool.

The responses of this tool should be cached, as they don't change frequently.

Fetches data from the Google Ads API using the search method