Documentation / Tool Reference

Google Ads tools

69 secure tools for the Google Ads API: connection, reporting, campaign creation, keyword & bid management, extensions, and recommendations.

Connection & Account · 2

connect_google_adsfree

Generates a one-time authorization link to connect a Google Ads account.

list_accounts1 credits

Lists the Google Ads accounts accessible to the connected Google account.

Reporting & Audit · 9

performance_report2 credits

Performance report (cost, clicks, impressions, conversions).

customer_iddayslevelsegment
search_terms_report2 credits

Search terms report: terms that convert vs. terms that spend without converting (negative-keyword candidates).

customer_iddaysmin_waste
keyword_report2 credits

Keyword performance + Quality Score; flags low QS and zero-conversion spend.

customer_iddays
account_audit3 credits

Account hygiene audit: finds wasted-spend keywords and low Quality Score.

customer_iddays
list_entities1 credits

Lists account entities with their IDs.

customer_identity
get_change_history2 credits

Lists account changes over the last N days (who, what, when) (max 30 days).

customer_iddayslimit
keyword_planner3 credits

Generates keyword ideas + monthly search volume/competition (defaults to Turkey/Turkish).

customer_idseed_keywordslanguage_idgeo_id
list_recommendations2 credits

Lists Google's campaign recommendations and the account's optimization score (equivalent to the panel 'Recommendations' page).

customer_id
get_ad_details1 credits

Reads the FULL content of ads (RSA headlines/descriptions, URL, status) — to view existing text before update_rsa.

customer_idad_group_idad_id

Campaign · 9

pause_campaign5 credits

Pauses a campaign.

customer_idcampaign_id
set_campaign_budget5 credits

Sets a campaign's daily budget (safety-capped: increases >50% at once are blocked).

customer_idcampaign_iddaily_amount
update_campaign_status5 credits

Changes campaign status: 'ENABLED' or 'PAUSED'.

customer_idcampaign_idstatus
set_campaign_targeting5 credits

Adds geographic and language targeting to a campaign.

customer_idcampaign_idlocationsnegative_locationslanguages
create_search_campaign8 credits

Creates a new Search campaign (starts PAUSED for safety) + daily budget.

customer_idnamedaily_budgetlocationslanguages
create_pmax_campaign10 credits

Creates a Performance Max campaign (PAUSED): budget + campaign + asset group + text assets.

customer_idnamedaily_budgetfinal_urlbusiness_nameheadlineslong_headlinesdescriptions
create_demand_gen_campaign8 credits

Creates a Demand Gen campaign (PAUSED) + daily budget.

customer_idnamedaily_budget
create_app_campaign8 credits

Creates an App (UAC) campaign (PAUSED).

customer_idnamedaily_budgetapp_idapp_storetarget_cpa
get_campaign_targeting1 credits

Reads a campaign's current targeting: geo, radius/proximity, language, device and audience criteria.

customer_idcampaign_id

Ad group & Ad · 10

update_ad_status5 credits

Changes ad status: 'ENABLED' or 'PAUSED'.

customer_idad_group_idad_idstatus
create_ad_group5 credits

Adds a new ad group to a campaign.

customer_idcampaign_idnamecpc_bid
create_responsive_search_ad8 credits

Adds a Responsive Search Ad (RSA) to an ad group — starts PAUSED.

customer_idad_group_idfinal_urlheadlinesdescriptions
update_rsa5 credits

Updates the text of an existing responsive search ad (RSA).

customer_idad_idheadlinesdescriptionsfinal_urlpath1path2
upload_image_asset3 credits

Uploads an image to the Google Ads asset library → returns the asset resource_name.

customer_idimage_urlname
add_pmax_images5 credits

Attaches IMAGES to a Performance Max asset group (required for the campaign to go live).

customer_idasset_group_idmarketing_image_assetssquare_image_assetslogo_assets
update_pmax_assets5 credits

Adds text assets to an existing Performance Max asset group.

customer_idasset_group_idheadlineslong_headlinesdescriptions
list_assets2 credits

Lists the account's whole asset library (sitelinks, callouts, snippets, images, etc.) across all campaigns.

customer_idasset_typelimit
get_pmax_assets1 credits

Reads a Performance Max asset group's content (headlines/descriptions/images/videos) + each asset's performance label.

customer_idasset_group_id
rsa_asset_performance2 credits

Responsive Search Ad strength + asset performance: each ad's Ad Strength and which headlines/descriptions perform best.

customer_idcampaign_id

Keywords & Negatives · 10

add_negative_keyword5 credits

Adds a negative keyword to a campaign (to stop wasted spend).

customer_idcampaign_idtextmatch_type
add_keywords5 credits

Adds positive keywords to an ad group (bulk).

customer_idad_group_idkeywordsmatch_type
manage_keywords5 credits

Manages existing keywords.

customer_idad_group_idcriterion_idsactioncpc_bid
remove_negative_keyword5 credits

Removes a campaign-level negative keyword (undoes add_negative_keyword).

customer_idcampaign_idcriterion_id
keyword_opportunities2 credits

Keyword opportunities from your OWN search-term and keyword data — works with existing access, no Keyword Planner approval needed.

customer_iddaysmin_waste
smart_negative_keywords2 credits

Smart negative-keyword suggestions: search terms that spend but never convert, ranked by estimated monthly savings.

customer_iddaysmin_wastelimit
list_negative_keywords1 credits

Lists negative keywords at both the ad-group and campaign level.

customer_idcampaign_id
list_shared_negative_listsfree

Lists the account's shared negative-keyword lists (Shared Library).

customer_id
get_shared_negative_listfree

Reads the negative keywords inside a shared negative-keyword list.

customer_idshared_set_idlimit
manage_shared_negative_listfree

Creates/updates/deletes shared negative-keyword lists (Shared Library) and attaches them to campaigns.

customer_idactionshared_set_idnamekeywordscampaign_idconfirm

Optimization · 15

manage_conversion_actions5 credits

Creates a new WEBPAGE conversion action (category: LEAD, PURCHASE, SIGNUP...).

customer_idnamecategorydefault_value
get_conversion_tags1 credits

Reads the Conversion ID (AW-...) + label of conversion actions — the 'send_to' value for GTM/gtag setup.

customer_idconversion_action_ids
update_conversion_action5 credits

Sets a conversion action to PRIMARY or SECONDARY. Pausing/removing is not possible via the API (panel-only).

customer_idconversion_action_idrole
set_conversion_settings5 credits

Edits a conversion action's value/count settings (default_value, currency, always_use, counting_type, click/view lookback).

customer_idconversion_action_iddefault_valuedefault_currency_codealways_use_default_valuecounting_typeclick_lookback_daysview_lookback_days
dismiss_recommendations2 credits

Dismisses Google Ads recommendations; comma-separated resource_name list.

customer_idresource_names
manage_bidding_strategies5 credits

Changes a campaign's bidding strategy.

customer_idcampaign_idstrategytarget_cpatarget_roasmax_cpcimpression_share_locationimpression_share_percent
manage_extension_assets5 credits

Adds extension assets to a campaign.

customer_idcampaign_idcalloutssitelinksphone_numberphone_countrysnippet_headersnippet_values
list_extension_assets1 credits

Lists a campaign's current extension assets (sitelinks, callouts, call, structured snippets) with the resource_name needed to remove each.

customer_idcampaign_id
remove_extension_assets3 credits

Removes (unlinks) extension assets from a campaign — by resource_names or by field_type (SITELINK/CALLOUT/CALL/STRUCTURED_SNIPPET).

customer_idcampaign_idresource_namesfield_typeconfirm
apply_recommendation5 credits

Applies or dismisses Google recommendations.

customer_idresource_namesaction
set_ad_schedule5 credits

Adds an ad schedule (day/hour) to a campaign — e.g. 'run only during business hours'.

customer_idcampaign_idschedule
conversion_tracking_health2 credits

Conversion-tracking health check: flags conversion actions that are paused/removed or have had zero data for 30 days.

customer_id
get_conversion_settings1 credits

Reads conversion-action settings: category, counting type, click/view-through lookback windows, attribution model and default value.

customer_id
list_ad_extensions1 credits

Reads the extension assets linked to a campaign (sitelink / callout / structured snippet / call / promotion / price).

customer_idcampaign_id
get_ad_schedule1 credits

Reads a campaign's current ad schedule (day/hour blocks + bid modifiers).

customer_idcampaign_id

Account health & Alerts · 3

instant_audit3 credits

Instant audit: surfaces an account's most critical issues in one call — wasted spend, zero-conversion terms, broken conversion tracking.

customer_iddays
impression_share_analysis2 credits

Impression-share analysis for Search: your share + whether loss is driven by budget or rank (bid/quality), plus disapproved ads.

customer_iddays
budget_pacing_alerts2 credits

Budget pacing: projects month-end spend against the daily budget and flags campaigns set to over- or under-spend.

customer_idthreshold_pct

Audiences & Campaign settings · 6

list_audiences1 credits

Lists account audiences (remarketing/rule/customer-match/lookalike).

customer_idlimit
list_experiments1 credits

Lists campaign experiments (A/B tests).

customer_id
create_website_audience5 credits

Creates a rule-based remarketing audience from website visitors (based on URL content).

customer_idnameurl_containsmembership_dayslookback_daysstring_operator
create_customer_match_audience5 credits

Creates a Customer Match audience shell (member upload is a separate step).

customer_idnamemembership_daysupload_key_type
create_lookalike_audience5 credits

Creates a Lookalike audience from seed audiences.

customer_idnameseed_user_list_idscountry_codesexpansion_levelmembership_days
manage_campaign_settings3 credits

Campaign-level settings: location type (Presence/Interest), toggle Search Partners & Display expansion, tracking template (read/write).

customer_idcampaign_idgeo_target_typesearch_partnersdisplay_expansiontracking_url_template

Agency reports & Competitor analysis · 5

seo_audit2 credits

SEO, speed and measurement-tag audit of a web page.

urlstrategy
competitor_ads1 credits

Competitor ad intelligence: fetches a brand's or domain's live ads from public ad libraries.

queryplatformregionlimit
client_report3 credits

Agency client report (white-label): an account's period KPIs (cost/clicks/conversions/ROAS/CPA/CTR) in a client-ready format.

customer_iddaysbrand_name
client_report_link3 credits

Shareable white-label client report: freezes the report as a snapshot and returns a public, printable link.

customer_iddaysbrand_name
portfolio_report3 credits

Agency portfolio report: aggregates all connected/selected Google Ads accounts into one per-account report.

days