דילוג לתוכן
Tecrübetecrube.com
Assistant tools · Setup and campaigns

Google Ads tools

Search and Performance Max campaigns, keywords, ad copy, conversions, bid strategies and recommendations.

Tool names and descriptions are generated straight from the server code; the descriptions are the original English text the assistant sees.

Read tools43 tools

list_google_ads_accounts

קריאה1 credits

Google Ads accounts the connected Google user can access, including client accounts under MCC/manager accounts (id, name, currency, time zone, manager, login_customer_id) and which one is selected. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

This tool takes no parameters.

google_device_report

קריאה2 credits

Google Ads performance split by device (mobile, desktop, tablet, connected TV) with CPA and ROAS per device. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
daysOptionalinteger (1–365)—
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
compare_previousOptionalboolean—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_ads_recommendations

קריאה1 credits

Google's own optimization recommendations (type, campaign, estimated impact) and the account optimization score. Apply chosen ones with apply_google_ads_recommendation. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
typesOptionalarray<string>recommendation types, e.g. KEYWORD, CAMPAIGN_BUDGET, SITELINK_ASSET
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
include_dismissedOptionalboolean—
limitOptionalinteger (1–10000)—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

google_keyword_planner

קריאה2 credits

Google Ads Keyword Planner ideas: real average monthly searches, competition and top-of-page bid range for seed keywords or a URL. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
seed_keywordsOptionalarray<string>—
urlOptionalstring—
locationOptionalstringcity/region names, comma separated
countryOptionalstringISO code, default TR
languageOptionalstringtr, en, de, fr, es, ar, ru
limitOptionalinteger (10–500)—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_ip_exclusions

קריאה1 credits

IP exclusions on Google Ads campaigns. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_ad_groups

קריאה1 credits

Ad groups (id, name, status, default CPC) of the Google Ads account or one campaign. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_shared_negative_lists

קריאה1 credits

Shared negative keyword lists in the Google Ads account with keyword counts and attached campaigns. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
list_idOptionalstringalso return this list's keywords
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_ads

קריאה1 credits

Responsive search ads with every headline/description and Google's performance label (LOW/GOOD/BEST), ad strength and final URL. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
ad_group_idOptionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_conversion_actions

קריאה1 credits

Conversion actions of the Google Ads account: type, category, status, primary/secondary, counting, value settings, click-through and view-through windows, attribution model, call length; with days, conversions recorded per action. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
daysOptionalinteger (1–365)also return conversions recorded per action in this window
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_asset_groups

קריאה1 credits

Performance Max asset groups with ad strength, final URLs, their text/image assets per field type and (signals=true) audience signals and search themes. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
asset_group_idOptionalstring—
signalsOptionalbooleanalso return audience signals and search themes
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_demand_gen_campaigns

קריאה1 credits

Demand Gen campaigns of the Google Ads account with status, bidding, daily budget and period performance (spend, clicks, impressions, conversions, revenue, CTR, CPC, CPA, ROAS). Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
daysOptionalinteger (1–365)—
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_app_campaigns

קריאה1 credits

App campaigns of the Google Ads account with app id, store, bidding goal, status, daily budget and period performance. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
daysOptionalinteger (1–365)—
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

google_invalid_clicks_report

קריאה2 credits

Invalid-click (click fraud) report per campaign and day from Google's own metrics (metrics.invalid_clicks, metrics.invalid_click_rate, clicks, cost) for the last N days (default 14); flags campaigns whose invalid rate exceeds the threshold (default 10%) or whose last day spiked (3x the prior average), plus zero-conversion high-click cities for suspicious campaigns. Honest limits: Google only reports the invalid clicks it already filtered and never exposes clicker IPs — a warning signal, not IP-level proof. Invalid clicks are not charged. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
daysOptionalinteger (1–365)—
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
threshold_rateOptionalnumbersuspicious invalid-click rate as a fraction, default 0.10
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_merchant_accounts

קריאה1 credits

Google Merchant Center accounts reachable with the connected Google token (Merchant API accounts v1beta): id, name, language, time zone, test flag. Uses the connected Google consent; returns error=scope_missing when it lacks the Merchant Center scope (auth/content) — the user must re-authorise Google.

This tool takes no parameters.

list_merchant_products

קריאה1 credits

Merchant Center products (Merchant API products v1beta) with title, offer id, price, availability, per-destination approval status and item-level issues; filter to disapproved / pending / products with issues. Uses the connected Google consent; returns error=scope_missing when it lacks the Merchant Center scope (auth/content) — the user must re-authorise Google.

ParameterTypeDescription
account_idOptionalstringMerchant Center account id; optional when the user has a single account or one is selected
statusOptionalall | disapproved | pending | approved | issuesissues = any item-level issue or disapproved country
queryOptionalstringsubstring of title or offer id
limitOptionalinteger (1–1000)—

get_merchant_product_issues

קריאה1 credits

Item-level issues of one Merchant Center product (code, severity, resolution, description, affected countries) plus its destination statuses; marks which issues the merchant can fix via product data. Uses the connected Google consent; returns error=scope_missing when it lacks the Merchant Center scope (auth/content) — the user must re-authorise Google.

ParameterTypeDescription
account_idOptionalstringMerchant Center account id; optional when the user has a single account or one is selected
product_idOptionalstringe.g. online~tr~TR~SKU123 (from list_merchant_products)
offer_idOptionalstring—

merchant_feed_status

קריאה1 credits

Merchant Center data sources (feeds): type, input method (API/FILE/UI/AUTOFEED), feed label, language and for file feeds the latest upload's processing state, item counts and issues. Uses the connected Google consent; returns error=scope_missing when it lacks the Merchant Center scope (auth/content) — the user must re-authorise Google.

ParameterTypeDescription
account_idOptionalstringMerchant Center account id; optional when the user has a single account or one is selected

get_ad_details

קריאה1 credits

Full content of Google Ads ads (type, every RSA headline/description with pins, URLs, tracking template, status) plus ad strength, Google's improvement action items and policy approval. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
ad_group_idOptionalstringGoogle Ads ad group id (list_google_ad_groups)
ad_idOptionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

get_campaign_targeting

קריאה1 credits

Current targeting of a Google Ads campaign (or ad group): locations with names, excluded locations, radius targets (lat/lng, radius, units), languages, device bid modifiers, audiences, and the presence/interest location setting. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
ad_group_idOptionalstringGoogle Ads ad group id (list_google_ad_groups)
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_assets

קריאה2 credits

The whole Google Ads asset library across the account (text, images with size, YouTube videos, sitelinks, callouts, snippets, calls, promotions, prices, lead forms, WhatsApp), optionally with where each is used and its approval. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
asset_typeOptionalTEXT | IMAGE | YOUTUBE_VIDEO | SITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | LEAD_FORM | BUSINESS_MESSAGE | MOBILE_APP | CALL_TO_ACTION | LOCATION | PAGE_FEED—
limitOptionalinteger (1–1000)—
include_usageOptionalbooleanalso list which campaigns/ad groups use each asset
include_approvalOptionalbooleanadd policy approval/review status
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

rsa_asset_performance

קריאה2 credits

Per-headline and per-description results of responsive search ads (impressions, clicks, cost, conversions, value, CPA, CTR, conversion rate) with Google's LOW/GOOD/BEST label, pin and the ad's strength. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
daysOptionalinteger (1–365)—
limitOptionalinteger (1–1000)—
min_impressionsOptionalinteger (0–…)—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

keyword_historical_metrics

קריאה2 credits

Keyword Planner historical metrics for keywords you already know: average and month-by-month searches, competition, top-of-page bid range and average CPC. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
keywordsRequiredarray<string>—
language_idOptionalstringGoogle language constant id, default 1037 (Turkish)
languageOptionalstringlanguage code alternative (tr, en…)
geo_idsOptionalarray<string>geo target constant ids (geo_target_search), default 2792 (Turkey)
start_monthOptionalstringYYYY-MM
end_monthOptionalstringYYYY-MM
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

keyword_quality_report

קריאה2 credits

Day-by-day historical Quality Score per keyword with its three components, flagging the dates it dropped and which component changed. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
ad_group_idOptionalstringGoogle Ads ad group id (list_google_ad_groups)
daysOptionalinteger (1–90)—
limitOptionalinteger (1–500)—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_negative_keywords

קריאה1 credits

Every negative keyword that applies: campaign-level, ad-group-level and the shared negative lists attached to campaigns (with their keywords). Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

smart_negative_keywords

קריאה2 credits

Negative keyword suggestions: search terms that spent money with zero conversions and aren't already negatives anywhere, ranked by spend (estimated savings). Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
daysOptionalinteger (1–90)—
min_wasteOptionalnumberminimum spend per term
limitOptionalinteger (1–500)—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

conversion_tracking_health

קריאה2 credits

Conversion tracking check-up: actions that are hidden/removed, primary actions that recorded nothing in the window, and a missing primary action. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
daysOptionalinteger (1–90)—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

extension_asset_performance

קריאה2 credits

How campaign extensions perform (sitelinks, callouts, call, snippets, promotions, prices, WhatsApp, images, business name/logo): impressions, clicks, cost, conversions per asset. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
daysOptionalinteger (1–365)—
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
field_typeOptionalSITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | BUSINESS_MESSAGE | MOBILE_APP | HOTEL_CALLOUT | LEAD_FORM | BUSINESS_NAME | BUSINESS_LOGO | AD_IMAGE—
limitOptionalinteger (1–1000)—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

get_ad_schedule

קריאה1 credits

A campaign's current ad schedule: day, start/end time, bid adjustment and criterion id per slot. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
campaign_idRequiredstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

get_conversion_tags

קריאה1 credits

Tag details of conversion actions: Conversion ID (AW-…), label and the send_to value for Tag Manager / gtag, plus the raw snippets. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
conversion_action_idsOptionalarray<string>—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_extension_assets

קריאה1 credits

Extension assets linked to a campaign or ad group (sitelinks, callouts, call, snippets, promotions, prices, WhatsApp, lead form, app, business name/logo) with the link resource name used for removal. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
ad_group_idOptionalstringGoogle Ads ad group id (list_google_ad_groups)
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_conversion_goals

קריאה1 credits

Account conversion goals (category × origin) and whether each is primary/biddable; with campaign_id also that campaign's goal overrides. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_custom_conversion_goals

קריאה1 credits

Custom conversion goals: name, the conversion actions inside, status and the campaigns optimising for each. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

budget_pacing_alerts

קריאה2 credits

Month-to-date spend vs. daily budget for enabled campaigns, projected to month end; flags campaigns heading over or under budget. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
threshold_pctOptionalnumber (1–100)deviation that triggers an alert, default 10
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

impression_share_analysis

קריאה2 credits

Search impression share, top / absolute-top share, exact-match share and how much was lost to budget vs. rank, plus disapproved ads per campaign. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
daysOptionalinteger (1–365)—
levelOptionalcampaign | ad_group—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_audiences

קריאה1 credits

Audience lists (remarketing, rule-based website, Customer Match, lookalike): id, type, status, membership days, Search/Display size and eligibility. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
limitOptionalinteger (1–1000)—
definitionOptionalbooleaninclude the list's rule / seed definition
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_experiments

קריאה1 credits

List campaign experiments (A/B tests) with id, status and dates. Read only; end or promote one with manage_experiment. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
actionOptionallistonly list; use manage_experiment to end or promote
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_ad_policy_issues

קריאה2 credits

Ads that Google disapproved or limited, with the policy topics and evidence text behind each decision. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
only_problemsOptionalbooleandefault true: only disapproved / limited ads
limitOptionalinteger (1–1000)—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_lead_form_submissions

קריאה2 credits

Leads submitted through Google Ads lead forms (name, email, phone and custom answers, campaign, time). Personal data — handle with care. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
daysOptionalinteger (1–90)—
asset_idOptionalstringlead form asset id
limitOptionalinteger (1–1000)—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tools66 tools

select_google_ads_account

כתיבה1 credits

Switch the Google Ads client account all further reads and writes use (agency/MCC: the right login-customer-id is set automatically). Local setting; nothing changes on Google.

ParameterTypeDescription
customer_idRequiredstringclient customer id from list_google_ads_accounts

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

apply_google_ads_recommendation

כתיבה2 credits

Apply (or with action=dismiss, dismiss) selected Google Ads recommendations (up to 100). Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
recommendationsRequiredarray<string>resource names from list_google_ads_recommendations
actionOptionalapply | dismissdefault apply
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_google_search_campaign

כתיבה2 credits

Create a Google Search campaign in one flow: budget, campaign, location + language targeting, bidding strategy, ad group, keywords and responsive search ad (copy defaults to the brand profile). Created PAUSED. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
nameRequiredstring—
daily_budgetRequirednumberaccount currency
locationsOptionalarray<string>city/region/country names; default: brand profile city
location_idsOptionalarray<string>Google geo target constant ids
countryOptionalstring—
languagesOptionalarray<string>language codes (tr, en…) or Google language ids; default Turkish
bid_strategyOptionalmaximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks—
target_cpaOptionalnumber—
target_roasOptionalnumber—
max_cpcOptionalnumber—
cpc_bidOptionalnumberad group default CPC
keywordsOptionalarray<any>—
headlinesOptionalarray<any>—
descriptionsOptionalarray<any>—
final_urlOptionalstring—
ad_group_nameOptionalstring—
search_partnersOptionalboolean—
end_dateOptionalstringYYYY-MM-DD
goalOptionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_google_pmax_campaign

כתיבה2 credits

Create a Performance Max campaign: budget + campaign + asset group + text assets + images (downloaded from the given URLs and uploaded) in one atomic request, created PAUSED. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
nameRequiredstring—
daily_budgetRequirednumber—
final_urlRequiredstring—
business_nameRequiredstring≤25 chars
headlinesRequiredarray<string>3-15, ≤30 chars
long_headlinesRequiredarray<string>1-5, ≤90 chars
descriptionsRequiredarray<string>2-5, ≤90 chars
marketing_imagesRequiredarray<string>1.91:1 landscape, at least 1
square_marketing_imagesRequiredarray<string>1:1, at least 1
logo_imagesRequiredarray<string>1:1 logo, at least 1
portrait_marketing_imagesOptionalarray<string>image URLs (https) or Studio /medya files
landscape_logo_imagesOptionalarray<string>image URLs (https) or Studio /medya files
bid_strategyOptionalmaximize_conversions | maximize_conversion_value—
target_cpaOptionalnumber—
target_roasOptionalnumber—
locationsOptionalarray<string>—
countryOptionalstring—
languagesOptionalarray<string>—
asset_group_nameOptionalstring—
end_dateOptionalstring—
goalOptionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_google_campaign

כתיבה2 credits

Rename, pause/enable or set/clear the end date of a Google Ads campaign; the preview shows current → new. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
campaign_idRequiredstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
nameOptionalstring—
statusOptionalpause | enable—
end_dateOptionalstring | nullYYYY-MM-DD, or null to run indefinitely
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

rename_google_campaigns

כתיבה2 credits

Bulk-rename Google Ads campaigns (explicit list, a naming pattern, or find/replace). The preview is an old → new table; names must stay unique. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
renamesOptionalarray<object>—
campaign_idsOptionalarray<string>—
patternOptionalstringnaming pattern with {name}, {channel}, {id}, e.g. 'Brand | {channel} | {name}'
findOptionalstring—
replaceOptionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

remove_google_campaign

כתיבהIrreversible2 credits

PERMANENTLY remove a Google Ads campaign (cannot be undone or re-enabled; history stays in reports). Only call it when the user explicitly asked for it; it is applied at once and cannot be undone. Prefer update_google_campaign(status=pause) when unsure. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
campaign_idRequiredstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

set_google_bid_strategy

כתיבה2 credits

Switch a Google Ads campaign's bidding: maximize conversions (optional target CPA), maximize conversion value (optional target ROAS), target CPA, target ROAS, manual CPC, maximize clicks, target impression share (location + percent). Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
campaign_idRequiredstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
strategyRequiredmaximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks | target_impression_share—
target_cpaOptionalnumberaccount currency
target_roasOptionalnumberratio, 4.0 = 400%
max_cpcOptionalnumberCPC ceiling for maximize_clicks / target_impression_share
impression_share_locationOptionalANYWHERE_ON_PAGE | TOP_OF_PAGE | ABSOLUTE_TOP_OF_PAGE—
impression_share_percentOptionalnumber (1–100)—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

set_google_ad_schedule

כתיבה2 credits

Set a Google Ads campaign ad schedule (day/time slots with optional bid adjustment); ads don't serve outside the slots. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
campaign_idRequiredstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
replaceOptionalbooleanremove the existing schedule first
scheduleRequiredarray<object>—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

set_google_location_targets

כתיבה2 credits

Target or exclude locations (and set language targeting) on a Google Ads campaign; names are resolved with Google's geo target suggestions and shown in the preview. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
campaign_idRequiredstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
locationsOptionalarray<string>names, e.g. İstanbul, Ankara
location_idsOptionalarray<string>—
countryOptionalstringISO code hint, default TR
excludeOptionalboolean—
replaceOptionalbooleanremove existing targeted locations (and languages, if given) first
bid_adjustmentOptionalnumberpercent
languagesOptionalarray<string>language codes (tr, en…) or Google language ids to target
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

merge_google_campaigns

כתיבה2 credits

Safe campaign merge: pause the source campaigns and move their daily budget to the target (Google can't move ad groups between campaigns). Subject to the budget guardrail (max +50% per change); never auto-applied. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
target_campaign_idRequiredstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
source_campaign_idsRequiredarray<string>—
move_budgetOptionalbooleanadd the sources' daily budgets to the target (default true)
new_daily_budgetOptionalnumberexplicit target daily budget instead of the sum
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

exclude_google_ips

כתיבה2 credits

Exclude IP addresses (click-fraud protection) from a Google Ads campaign (campaign-level negative IP block, max 500). Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
campaign_idRequiredstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
ipsRequiredarray<string>IPv4/IPv6 addresses or CIDR blocks
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

unblock_ip_addresses

כתיבה2 credits

Remove IP exclusions from a Google Ads campaign (the undo of exclude_google_ips); only IPs actually excluded on the campaign are removed. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
campaign_idRequiredstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
ipsRequiredarray<string>IPv4/IPv6 addresses or CIDR blocks to stop excluding
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_google_ad_group

כתיבה2 credits

Add a search ad group to a Google Ads campaign, optionally with keywords and a responsive search ad. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
campaign_idRequiredstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
nameRequiredstring—
cpc_bidOptionalnumber—
keywordsOptionalarray<any>—
headlinesOptionalarray<any>—
descriptionsOptionalarray<any>—
final_urlOptionalstring—
path1Optionalstring—
path2Optionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

set_google_ad_group_status

כתיבה2 credits

Pause or enable Google Ads ad groups. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
ad_group_idsOptionalarray<string>—
ad_group_idOptionalstring—
statusRequiredpause | enable—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

pause_google_ad_groups

כתיבה2 credits

Pause several Google Ads ad groups at once (e.g. zero-conversion groups from google_ads_report breakdown=ad_group). Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
ad_group_idsRequiredarray<string>—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

add_google_keywords

כתיבה2 credits

Add keywords (text, BROAD|PHRASE|EXACT, optional CPC bid) to a Google Ads ad group. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
ad_group_idRequiredstring—
keywordsRequiredarray<any>—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_google_keyword

כתיבה2 credits

Pause/enable a Google Ads keyword, change its CPC bid, or change its match type (Google requires remove + re-add; done in one atomic request). Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
ad_group_idRequiredstring—
keyword_idRequiredstring—
statusOptionalpause | enable—
bidOptionalnumber—
match_typeOptionalBROAD | PHRASE | EXACT—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

remove_google_negative_keywords

כתיבהIrreversible2 credits

Remove negative keywords (matched by text, optionally match type) from a Google Ads campaign or a shared negative list — the undo for a wrong negative. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
shared_list_idOptionalstring—
keywordsOptionalarray<string>—
criterion_idsOptionalarray<string>negative criterion ids (list_negative_keywords) instead of / in addition to text
match_typeOptionalBROAD | PHRASE | EXACT—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

add_to_google_shared_negative_list

כתיבה2 credits

Add negatives (each with its own match type) to an account-wide shared negative list — or create one — and attach it to campaigns. Existing terms are skipped. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
list_idOptionalstring—
list_nameOptionalstringcreates a new list when list_id is not given
keywordsRequiredarray<any>—
attach_campaign_idsOptionalarray<string>—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_google_rsa

כתיבה2 credits

Create a responsive search ad (3-15 headlines ≤30, 2-4 descriptions ≤90, optional pinning) in a Google Ads ad group. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
ad_group_idRequiredstring—
headlinesRequiredarray<any>—
descriptionsRequiredarray<any>—
final_urlRequiredstring—
path1Optionalstring—
path2Optionalstring—
final_mobile_urlOptionalstring—
tracking_url_templateOptionalstring—
statusOptionalenable | pause—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_google_rsa_assets

כתיבה2 credits

Refresh weak RSA headlines/descriptions: Google doesn't allow editing RSA text, so a new ad is created with the new set and the old one paused, in one request. Preview shows old → new copy. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
ad_group_idRequiredstring—
ad_idRequiredstring—
replace_low_performingOptionalboolean—
remove_headlinesOptionalarray<string>—
add_headlinesOptionalarray<any>—
remove_descriptionsOptionalarray<string>—
add_descriptionsOptionalarray<any>—
headlinesOptionalarray<any>—
descriptionsOptionalarray<any>—
final_urlOptionalstring—
path1Optionalstring—
path2Optionalstring—
pause_oldOptionalbooleandefault true
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

add_google_callouts

כתיבה2 credits

Add callout assets (≤25 chars) to a Google Ads campaign. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
campaign_idRequiredstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
calloutsRequiredarray<string>≤25 chars each
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_google_conversion_action

כתיבה2 credits

Create a website conversion action; the result carries the tag snippet to install (e.g. with the Tag Manager tools). Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
nameRequiredstring—
categoryOptionalDEFAULT | PAGE_VIEW | PURCHASE | SIGNUP | DOWNLOAD | ADD_TO_CART | BEGIN_CHECKOUT | SUBSCRIBE_PAID | PHONE_CALL_LEAD | IMPORTED_LEAD | SUBMIT_LEAD_FORM | BOOK_APPOINTMENT | REQUEST_QUOTE | GET_DIRECTIONS | OUTBOUND_CLICK | CONTACT | ENGAGEMENT | QUALIFIED_LEAD | CONVERTED_LEAD—
counting_typeOptionalone | many—
primary_for_goalOptionalboolean—
default_valueOptionalnumber—
currencyOptionalstring—
always_use_default_valueOptionalboolean—
click_through_window_daysOptionalinteger (1–90)—
view_through_window_daysOptionalinteger (1–30)—
phone_call_duration_secondsOptionalinteger (0–10800)—
typeOptionalWEBPAGE | UPLOAD_CLICKS | UPLOAD_CALLS | AD_CALL | WEBSITE_CALL | CLICK_TO_CALLdefault WEBPAGE; UPLOAD_CLICKS for offline conversion upload
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_google_conversion_action

כתיבה2 credits

Change a Google Ads conversion action: primary vs secondary (primary_for_goal), status, category, counting, value settings, click-through window. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
conversion_action_idRequiredstring—
nameOptionalstring—
statusOptionalenable | hide | remove—
categoryOptionalDEFAULT | PAGE_VIEW | PURCHASE | SIGNUP | DOWNLOAD | ADD_TO_CART | BEGIN_CHECKOUT | SUBSCRIBE_PAID | PHONE_CALL_LEAD | IMPORTED_LEAD | SUBMIT_LEAD_FORM | BOOK_APPOINTMENT | REQUEST_QUOTE | GET_DIRECTIONS | OUTBOUND_CLICK | CONTACT | ENGAGEMENT | QUALIFIED_LEAD | CONVERTED_LEAD—
counting_typeOptionalone | many—
primary_for_goalOptionalboolean—
default_valueOptionalnumber—
currencyOptionalstring—
always_use_default_valueOptionalboolean—
click_through_window_daysOptionalinteger (1–90)—
view_through_window_daysOptionalinteger (1–30)—
phone_call_duration_secondsOptionalinteger (0–10800)—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

add_google_asset_group_assets

כתיבה2 credits

Add headlines, long headlines, descriptions and images (URLs are downloaded and uploaded; existing image asset ids are linked directly) to a Performance Max asset group in one atomic request. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
asset_group_idRequiredstring—
headlinesOptionalarray<string>—
long_headlinesOptionalarray<string>—
descriptionsOptionalarray<string>—
business_nameOptionalstring—
marketing_imagesOptionalarray<string>image URLs (https) or Studio /medya files
square_marketing_imagesOptionalarray<string>image URLs (https) or Studio /medya files
logo_imagesOptionalarray<string>image URLs (https) or Studio /medya files
portrait_marketing_imagesOptionalarray<string>image URLs (https) or Studio /medya files
landscape_logo_imagesOptionalarray<string>image URLs (https) or Studio /medya files
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

upload_google_image_asset

כתיבה2 credits

Upload images to the Google Ads asset library (assets:mutate, imageAsset); the result returns asset resource names reusable in create_google_demand_gen_campaign / create_google_app_campaign. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
imagesRequiredarray<any>https URLs or Studio /medya files (JPEG/PNG/GIF, ≤5120 KB), up to 20
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_google_demand_gen_campaign

כתיבה2 credits

Create a Google Demand Gen campaign (YouTube, Discover, Gmail): budget + campaign (advertising_channel_type DEMAND_GEN) + ad group + multi-asset ad (DemandGenMultiAssetAdInfo: headlines, descriptions, business name, logo, landscape/square/portrait images uploaded from URLs or linked by asset id), optional audience, location and language targeting, maximize conversions / tCPA / tROAS bidding. Created PAUSED. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
nameRequiredstring—
daily_budgetRequirednumberaccount currency
final_urlRequiredstring—
business_nameRequiredstring≤25 chars
headlinesRequiredarray<string>1-5, ≤40 chars
descriptionsRequiredarray<string>1-5, ≤90 chars
marketing_imagesOptionalarray<string>1.91:1 landscape — URLs to upload or existing asset ids
square_marketing_imagesOptionalarray<string>1:1 — URLs or asset ids
portrait_marketing_imagesOptionalarray<string>4:5 — URLs or asset ids
logo_imagesRequiredarray<string>1:1 logo, at least 1 — URLs or asset ids
call_to_actionOptionalstringe.g. Learn more, Shop now (≤15 chars)
bid_strategyOptionalmaximize_conversions | maximize_conversion_value | target_cpa | target_roas | maximize_clicks—
target_cpaOptionalnumber—
target_roasOptionalnumber—
max_cpcOptionalnumber—
audience_idsOptionalarray<string>Google Ads Audience ids (Audience Manager) to target on the ad group; empty = broad
locationsOptionalarray<string>—
location_idsOptionalarray<string>—
countryOptionalstring—
languagesOptionalarray<string>—
ad_group_nameOptionalstring—
end_dateOptionalstringYYYY-MM-DD
goalOptionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_google_app_campaign

כתיבה2 credits

Create a Google App campaign (advertising_channel_type MULTI_CHANNEL, sub type APP_CAMPAIGN, app_campaign_setting with app id, store and bidding goal): budget + campaign + ad group + app ad (text assets, optional images/videos), target CPI/CPA or ROAS bidding, location/language targeting. Created PAUSED; the app must be linked to the account. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
nameRequiredstring—
daily_budgetRequirednumberaccount currency
app_idRequiredstringApple numeric app id (e.g. 284815942) or Android package name (e.g. com.example.app)
app_storeRequiredapple | google—
goalOptionalinstalls | installs_no_target | in_app_actions | in_app_actions_cpa | value | pre_registrationinstalls = target cost per install (default); in_app_actions = installs likely to act in-app (tCPI); in_app_actions_cpa = target cost per in-app action; value = target ROAS; installs_no_target / pre_registration = maximize
target_cpaOptionalnumbertarget cost per install / in-app action
target_roasOptionalnumber—
conversion_action_idsOptionalarray<string>in-app conversion actions for in_app / value goals (list_google_conversion_actions)
headlinesRequiredarray<string>2-5, ≤30 chars
descriptionsRequiredarray<string>1-5, ≤90 chars
imagesOptionalarray<string>optional image URLs to upload or existing asset ids
video_asset_idsOptionalarray<string>existing YouTube video asset ids
locationsOptionalarray<string>—
location_idsOptionalarray<string>—
countryOptionalstring—
languagesOptionalarray<string>—
ad_group_nameOptionalstring—
end_dateOptionalstringYYYY-MM-DD
goal_noteOptionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

google_click_fraud_guard

כתיבה2 credits

Click-fraud guard: finds campaigns with suspicious invalid-click rates (or takes campaign_ids) and excludes the given IP addresses on each of them (campaign-level negative IP block). Without ips it only reports the suspicious campaigns and geo anomalies — the Google Ads API never reveals clicker IPs, so exclusions need addresses you obtained yourself. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
daysOptionalinteger (1–365)—
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
threshold_rateOptionalnumber—
campaign_idsOptionalarray<string>explicit campaigns; default: campaigns flagged by the invalid-click report
ipsOptionalarray<string>IPv4/IPv6 addresses or CIDR blocks from your own server/analytics logs
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

upsert_merchant_product

כתיבה2 credits

Add or update a Merchant Center product input (products v1beta productInputs:insert — replaces an existing input with the same offer id, language, feed label and data source). Applied directly when the user asks (the result shows the preview); sent to Google only with a connected Google account. Uses the connected Google consent; returns error=scope_missing when it lacks the Merchant Center scope (auth/content) — the user must re-authorise Google.

ParameterTypeDescription
offer_idRequiredstring—
content_languageOptionalstringdefault tr
feed_labelOptionalstringdefault TR
account_idOptionalstringMerchant Center account id; optional when the user has a single account or one is selected
data_sourceOptionalstringdata source id; default: the account's API/primary product data source
titleOptionalstring—
descriptionOptionalstring—
linkOptionalstring—
image_linkOptionalstring—
priceOptionalnumber—
sale_priceOptionalnumber—
currencyOptionalstringISO, default TRY
availabilityOptionalin stock | out of stock | preorder | backorder—
conditionOptionalnew | refurbished | used—
brandOptionalstring—
gtinOptionalstring—
googleProductCategoryOptionalstring—
imageLinkOptionalstringAlias of image_link
channelOptionalONLINE | LOCALdefault ONLINE
attributesOptionalobjectother Merchant API product attributes (camelCase), e.g. color, sizes, itemGroupId, customLabel0

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

manage_experiment

כתיבהIrreversible2 credits

End a campaign experiment (A/B test) or promote its trial changes to the base campaign. Irreversible; only call it when the user explicitly asked for it. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

ParameterTypeDescription
experiment_idRequiredstring—
actionRequiredend | promote—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_demand_gen_ad

כתיבה2 credits

Add a YouTube video ad (DemandGenVideoResponsiveAd) to a Demand Gen ad group — the creative that lets a Demand Gen video campaign serve. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
ad_group_idRequiredstringGoogle Ads ad group id (list_google_ad_groups)
youtube_videoRequiredstringYouTube URL or 11-char id, or an existing video asset id
headlinesRequiredarray<string>1-5, ≤40
long_headlinesRequiredarray<string>1-5, ≤90
descriptionsRequiredarray<string>1-5, ≤90
business_nameRequiredstring—
final_urlRequiredstring—
logo_asset_idRequiredstring1:1 logo asset id or image URL
call_to_actionOptionalLEARN_MORE | GET_QUOTE | APPLY_NOW | SIGN_UP | CONTACT_US | SUBSCRIBE | DOWNLOAD | BOOK_NOW | SHOP_NOW | BUY_NOW | ORDER_NOW | SEE_MORE | START_NOW | VISIT_SITE | WATCH_NOW—
ad_nameOptionalstring—
statusOptionalenable | pause—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

copy_ad_group

כתיבה2 credits

Duplicate ad groups with their keywords, negatives, responsive search ads, ad-group assets and audiences into another (or the same) campaign in one atomic request; copies start paused by default. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
ad_group_idsRequiredarray<string>—
target_campaign_idRequiredstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
new_nameOptionalstring—
name_suffixOptionalstring—
statusOptionalpause | enabledefault pause
cpc_bidOptionalnumber—
include_keywordsOptionalboolean—
include_negativesOptionalboolean—
include_adsOptionalboolean—
include_assetsOptionalboolean—
include_audiencesOptionalboolean—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

set_ad_group_targeting

כתיבה2 credits

Location and language targeting on an ad group (where Demand Gen keeps them): add or replace targeted / excluded places and languages. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
ad_group_idRequiredstringGoogle Ads ad group id (list_google_ad_groups)
locationsOptionalarray<string>—
location_idsOptionalarray<string>—
negative_locationsOptionalarray<string>—
negative_location_idsOptionalarray<string>—
languagesOptionalarray<string>—
countryOptionalstring—
modeOptionaladd | replace—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_ad_group

כתיבה2 credits

Rename a Google Ads ad group, change its default max CPC and/or pause/enable it. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
ad_group_idRequiredstringGoogle Ads ad group id (list_google_ad_groups)
nameOptionalstring—
cpc_bidOptionalnumber—
statusOptionalpause | enable—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_ad_status

כתיבהIrreversible2 credits

Enable, pause or permanently remove one Google Ads ad. REMOVED cannot be undone; use it only when the user explicitly asked for it. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
ad_group_idRequiredstringGoogle Ads ad group id (list_google_ad_groups)
ad_idRequiredstring—
statusRequiredENABLED | PAUSED | REMOVED—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_pmax_assets

כתיבה2 credits

Add and remove text assets of a Performance Max asset group in one request (images: add_google_asset_group_assets). Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
asset_group_idRequiredstring—
headlinesOptionalarray<string>—
long_headlinesOptionalarray<string>—
descriptionsOptionalarray<string>—
remove_resource_namesOptionalarray<string>asset group asset links from list_google_asset_groups
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_rsa

כתיבה2 credits

Edit a responsive search ad in place (same ad id, history kept): replace the full set or add/remove single headlines/descriptions, change pins, final URL and paths. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
ad_idRequiredstring—
headlinesOptionalarray<any>—
descriptionsOptionalarray<any>—
add_headlinesOptionalarray<any>—
remove_headlinesOptionalarray<string>—
add_descriptionsOptionalarray<any>—
remove_descriptionsOptionalarray<string>—
headline_pinsOptionalobject{text: pin field} — empty string unpins
description_pinsOptionalobject{text: pin field} — empty string unpins
final_urlOptionalstring—
path1Optionalstring—
path2Optionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

add_negative_keyword

כתיבה2 credits

Add one or many negative keywords at campaign or ad-group level (each with its own match type); existing ones are skipped. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
ad_group_idOptionalstringGoogle Ads ad group id (list_google_ad_groups)
textOptionalstring—
keywordsOptionalarray<any>—
match_typeOptionalBROAD | PHRASE | EXACT—
skip_existingOptionalbooleandefault true
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

manage_keywords

כתיבהIrreversible2 credits

Bulk pause / enable / permanently remove existing keywords, or set their max CPC or keyword-level final URLs. remove only when the user explicitly asked. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
ad_group_idRequiredstringGoogle Ads ad group id (list_google_ad_groups)
criterion_idsRequiredarray<string>—
actionRequiredpause | enable | remove | set_bid | set_url—
cpc_bidOptionalnumber—
final_urlOptionalstring—
final_mobile_urlOptionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

manage_shared_negative_list

כתיבהIrreversible2 credits

Manage account-level shared negative keyword lists: create, add/remove keywords, attach to or detach from campaigns, rename, delete (delete only when the user explicitly asked). Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
actionRequiredcreate | add_keywords | remove_keywords | attach | detach | rename | delete—
shared_set_idOptionalstring—
nameOptionalstring—
keywordsOptionalarray<any>—
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
campaign_idsOptionalarray<string>—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

dismiss_recommendations

כתיבה2 credits

Dismiss Google Ads recommendations you don't want. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
resource_namesRequiredarray<string>from list_google_ads_recommendations
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

manage_extension_assets

כתיבה2 credits

Add extension assets to a campaign (or one ad group) in one atomic request: sitelinks, callouts, structured snippet, call, WhatsApp message, promotions and a price list. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
ad_group_idOptionalstringGoogle Ads ad group id (list_google_ad_groups)
sitelinksOptionalarray<object>—
calloutsOptionalarray<string>—
snippet_headerOptionalstringe.g. Services, Brands, Types, Destinations
snippet_valuesOptionalarray<string>—
phone_numberOptionalstring—
phone_countryOptionalstring—
whatsapp_numberOptionalstring—
whatsapp_countryOptionalstring—
whatsapp_greetingOptionalstring—
whatsapp_ctaOptionalAPPLY_NOW | BOOK_NOW | CONTACT_US | GET_INFO | GET_OFFER | GET_QUOTE | GET_STARTED | LEARN_MORE—
whatsapp_cta_textOptionalstring—
promotionsOptionalarray<object>—
pricesOptionalobject—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

remove_extension_assets

כתיבהIrreversible2 credits

Unlink extension assets from a campaign or ad group (the assets stay in the library and can be re-linked). Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
resource_namesOptionalarray<string>link resource names from list_extension_assets
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
field_typeOptionalSITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | BUSINESS_MESSAGE | MOBILE_APP | HOTEL_CALLOUT | LEAD_FORM | BUSINESS_NAME | BUSINESS_LOGO | AD_IMAGEwith campaign_id: remove every link of this type
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

manage_portfolio_bidding_strategy

כתיבה2 credits

Portfolio (shared) bid strategies: list them, create one, change its targets, or attach a campaign to it. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
actionOptionallist | create | update | assign—
nameOptionalstring—
strategyOptionaltarget_cpa | target_roas | maximize_clicks | maximize_conversions | maximize_conversion_value | target_impression_share—
target_cpaOptionalnumber—
target_roasOptionalnumber—
max_cpcOptionalnumber—
min_cpcOptionalnumber—
impression_share_locationOptionalANYWHERE_ON_PAGE | TOP_OF_PAGE | ABSOLUTE_TOP_OF_PAGE—
impression_share_percentOptionalnumber (1–100)—
bidding_strategy_idOptionalstring—
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

manage_recommendation_auto_apply

כתיבה2 credits

See and switch Google's auto-apply recommendations per type. Turn it on only when the user explicitly asked, because Google then changes the account by itself. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
actionOptionallist | enable | disable—
typesOptionalarray<string>—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_conversion_goal

כתיבה2 credits

Make a conversion goal (category × origin) primary or secondary for the account or one campaign — what Smart Bidding optimises for. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
categoryRequiredDEFAULT | PAGE_VIEW | PURCHASE | SIGNUP | DOWNLOAD | ADD_TO_CART | BEGIN_CHECKOUT | SUBSCRIBE_PAID | PHONE_CALL_LEAD | IMPORTED_LEAD | SUBMIT_LEAD_FORM | BOOK_APPOINTMENT | REQUEST_QUOTE | GET_DIRECTIONS | OUTBOUND_CLICK | CONTACT | ENGAGEMENT | QUALIFIED_LEAD | CONVERTED_LEAD—
originOptionalWEBSITE | GOOGLE_HOSTED | APP | CALL_FROM_ADS | STORE | YOUTUBE_HOSTED | LOCAL_SERVICES_ADS—
roleRequiredprimary | secondary—
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_custom_conversion_goal

כתיבהIrreversible2 credits

Create, edit (actions inside, name) or delete a custom conversion goal; delete only when the user explicitly asked. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
goal_idOptionalstringomit to create a new goal
conversion_actionsOptionalarray<string>—
nameOptionalstring—
removeOptionalboolean—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

upload_offline_conversions

כתיבה2 credits

Upload offline (CRM) conversions by click id (gclid/gbraid/wbraid) or hashed email/phone (enhanced conversions for leads); emails/phones are SHA-256 hashed before anything is stored. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
conversion_actionRequiredstringid of an UPLOAD_CLICKS conversion action
currency_codeOptionalstring—
conversionsRequiredarray<object>—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

upload_conversion_adjustments

כתיבה2 credits

Retract (refund/cancel) or restate the value of conversions already reported, by order id or gclid + time. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
conversion_actionRequiredstring—
currency_codeOptionalstring—
adjustmentsRequiredarray<object>—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_customer_match_audience

כתיבה2 credits

Create an empty Customer Match list (first-party data). Members are added through Google's own upload paths; this tool never uploads personal data. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
nameRequiredstring—
membership_daysOptionalinteger (1–540)—
upload_key_typeOptionalCONTACT_INFO | CRM_ID | MOBILE_ADVERTISING_ID—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_lookalike_audience

כתיבה2 credits

Create a lookalike audience (Demand Gen) from seed lists for given countries and reach level. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
nameRequiredstring—
seed_user_list_idsRequiredarray<string>—
country_codesRequiredarray<string>—
expansion_levelOptionalNARROW | BALANCED | BROAD—
membership_daysOptionalinteger (1–540)—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_website_audience

כתיבה2 credits

Create a rule-based remarketing list of website visitors whose page URL matches (needs the Google tag on the site); past visitors are pre-filled. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
nameRequiredstring—
url_containsRequiredany—
string_operatorOptionalCONTAINS | EQUALS | STARTS_WITH | ENDS_WITH—
membership_daysOptionalinteger (1–540)—
lookback_daysOptionalinteger (1–540)—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

manage_audience_targeting

כתיבה2 credits

Attach an audience list to a campaign or ad group (or remove it), optionally setting observation vs. targeting and a bid modifier. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
audienceRequiredstringuser list id (list_audiences)
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
ad_group_idOptionalstringGoogle Ads ad group id (list_google_ad_groups)
actionOptionaladd | remove—
modeOptionalobservation | targeting—
bid_modifierOptionalnumbermultiplier, 1.2 = +20%
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

manage_campaign_settings

כתיבה2 credits

Read (no other argument) or change campaign settings: presence vs. interest location option, search partners, Display expansion, tracking template, EU political ads declaration, AI Max for Search. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
campaign_idRequiredstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
geo_target_typeOptionalPRESENCE | PRESENCE_OR_INTEREST—
search_partnersOptionalboolean—
display_expansionOptionalboolean—
tracking_url_templateOptionalstring—
eu_political_adsOptionalboolean—
ai_maxOptionalbooleanAI Max for Search
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_google_ads_account

כתיבהIrreversible2 credits

Open a new client account under a manager (MCC) account the connected user manages. Only call it when the user explicitly asked for it; currency and time zone are permanent. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
manager_customer_idRequiredstring—
nameRequiredstring—
currency_codeRequiredstring—
time_zoneRequiredstring—
tracking_url_templateOptionalstring—

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

create_lead_form

כתיבה2 credits

Create a lead form asset (the form inside the ad) with standard fields, custom questions, thank-you screen and optional webhook delivery, and attach it to a campaign or ad group. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
business_nameRequiredstring—
headlineRequiredstring—
descriptionRequiredstring—
privacy_policy_urlRequiredstring—
final_urlRequiredstring—
ctaOptionalLEARN_MORE | GET_QUOTE | APPLY_NOW | SIGN_UP | CONTACT_US | SUBSCRIBE | DOWNLOAD | BOOK_NOW | GET_OFFER | REGISTER | GET_INFO | REQUEST_DEMO | JOIN_NOW | GET_STARTED—
cta_descriptionOptionalstring—
fieldsOptionalarray<FULL_NAME | FIRST_NAME | LAST_NAME | EMAIL | PHONE_NUMBER | POSTAL_CODE | STREET_ADDRESS | CITY | REGION | COUNTRY | WORK_EMAIL | COMPANY_NAME | WORK_PHONE | JOB_TITLE>—
questionsOptionalarray<any>—
post_submit_headlineOptionalstring—
post_submit_descriptionOptionalstring—
post_submit_ctaOptionalVISIT_SITE | DOWNLOAD | LEARN_MORE | SHOP_NOW—
webhook_urlOptionalstring—
webhook_keyOptionalstring—
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
ad_group_idOptionalstringGoogle Ads ad group id (list_google_ad_groups)
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

manage_business_name

כתיבה2 credits

Set or correct the business name shown in a campaign's ads. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
campaign_idRequiredstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
textRequiredstring≤25 chars
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

manage_campaign_proximity

כתיבה2 credits

List, add or remove radius (lat/lng circle) targets on a campaign. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
campaign_idRequiredstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
actionOptionallist | add | remove—
latOptionalnumber—
lngOptionalnumber—
radiusOptionalnumber—
unitsOptionalKILOMETERS | MILES—
pointsOptionalarray<object>—
criterion_idOptionalstring—
criterion_idsOptionalarray<string>—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

manage_device_targeting

כתיבה2 credits

Set a campaign's bid adjustment for one device (or -100% to stop showing on it). Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
campaign_idRequiredstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
deviceRequiredMOBILE | DESKTOP | TABLET | CONNECTED_TV—
bid_modifier_pctRequirednumber-90..900, or -100 to exclude
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

set_call_reporting

כתיבה2 credits

Turn account-level call reporting and call conversion reporting on/off and choose the call conversion action. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
call_reportingOptionalboolean—
call_conversionOptionalboolean—
call_conversion_action_idOptionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.

update_pmax_asset_group

כתיבהIrreversible2 credits

Change a Performance Max asset group's final URL, name, display paths or status; REMOVED is permanent; use it only when the user explicitly asked for it. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

ParameterTypeDescription
asset_group_idRequiredstring—
final_urlOptionalstring—
nameOptionalstring—
statusOptionalENABLED | PAUSED | REMOVED—
path1Optionalstring—
path2Optionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Write tool: the call first produces a preview; the change reaches the platform only after you approve it.