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 creditsGoogle 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_ads_report
קריאה2 creditsGoogle Ads performance (spend, clicks, impressions, conversions, revenue, CTR, CPC, CPA, ROAS) by campaign, ad group, keyword, device, location, hour, day of week, or account (all MCC client accounts ranked). Date range by days or start/end; compare_previous adds the prior period. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
breakdownOptional | campaign | ad_group | keyword | device | location | hour | day_of_week | account | — |
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
compare_previousOptional | boolean | also return the previous period of the same length and % change |
customer_idOptional | string | optional: 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_device_report
קריאה2 creditsGoogle 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.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
compare_previousOptional | boolean | — |
customer_idOptional | string | optional: 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_ads_change_history
קריאה1 creditsWho changed what and when in the Google Ads account (last 30 days max): user, tool (UI/API), resource, operation and old → new values. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–30) | — |
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
limitOptional | integer (1–1000) | — |
resource_typeOptional | AD | AD_GROUP | AD_GROUP_CRITERION | CAMPAIGN | CAMPAIGN_BUDGET | AD_GROUP_BID_MODIFIER | CAMPAIGN_CRITERION | AD_GROUP_AD | ASSET | CUSTOMER_ASSET | CAMPAIGN_ASSET | AD_GROUP_ASSET | ASSET_SET | ASSET_SET_ASSET | CAMPAIGN_ASSET_SET | — |
operationOptional | CREATE | UPDATE | REMOVE | — |
customer_idOptional | string | optional: 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 creditsGoogle'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.
| Parameter | Type | Description |
|---|---|---|
typesOptional | array<string> | recommendation types, e.g. KEYWORD, CAMPAIGN_BUDGET, SITELINK_ASSET |
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
include_dismissedOptional | boolean | — |
limitOptional | integer (1–10000) | — |
customer_idOptional | string | optional: 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_ads_quality_score_report
קריאה2 creditsKeyword Quality Score (1-10) with its components (expected CTR, ad relevance, landing page experience) and spend; summarises low-score keywords and which component drags them down. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–90) | — |
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
customer_idOptional | string | optional: 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 creditsGoogle 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.
| Parameter | Type | Description |
|---|---|---|
seed_keywordsOptional | array<string> | — |
urlOptional | string | — |
locationOptional | string | city/region names, comma separated |
countryOptional | string | ISO code, default TR |
languageOptional | string | tr, en, de, fr, es, ar, ru |
limitOptional | integer (10–500) | — |
customer_idOptional | string | optional: 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 creditsIP exclusions on Google Ads campaigns. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.
| Parameter | Type | Description |
|---|---|---|
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
customer_idOptional | string | optional: 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 creditsAd 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
customer_idOptional | string | optional: 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 creditsShared 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.
| Parameter | Type | Description |
|---|---|---|
list_idOptional | string | also return this list's keywords |
customer_idOptional | string | optional: 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 creditsResponsive 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
ad_group_idOptional | string | — |
customer_idOptional | string | optional: 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 creditsConversion 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.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–365) | also return conversions recorded per action in this window |
customer_idOptional | string | optional: 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 creditsPerformance 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
asset_group_idOptional | string | — |
signalsOptional | boolean | also return audience signals and search themes |
customer_idOptional | string | optional: 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 creditsDemand 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.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
customer_idOptional | string | optional: 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 creditsApp 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.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
customer_idOptional | string | optional: 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 creditsInvalid-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.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
threshold_rateOptional | number | suspicious invalid-click rate as a fraction, default 0.10 |
customer_idOptional | string | optional: 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 creditsGoogle 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 creditsMerchant 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.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Merchant Center account id; optional when the user has a single account or one is selected |
statusOptional | all | disapproved | pending | approved | issues | issues = any item-level issue or disapproved country |
queryOptional | string | substring of title or offer id |
limitOptional | integer (1–1000) | — |
get_merchant_product_issues
קריאה1 creditsItem-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.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Merchant Center account id; optional when the user has a single account or one is selected |
product_idOptional | string | e.g. online~tr~TR~SKU123 (from list_merchant_products) |
offer_idOptional | string | — |
merchant_feed_status
קריאה1 creditsMerchant 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.
| Parameter | Type | Description |
|---|---|---|
account_idOptional | string | Merchant Center account id; optional when the user has a single account or one is selected |
google_ads_query
קריאה2 creditsRun a single read-only Google Ads Query Language SELECT and get the raw rows — for data no dedicated tool returns. Only one SELECT is accepted (no ';', comments or write keywords); LIMIT is enforced (≤1000). Money fields come in micros. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.
| Parameter | Type | Description |
|---|---|---|
queryRequired | string | one GAQL SELECT statement, e.g. SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS |
limitOptional | integer (1–1000) | — |
customer_idOptional | string | optional: 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_details
קריאה1 creditsFull 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
ad_group_idOptional | string | Google Ads ad group id (list_google_ad_groups) |
ad_idOptional | string | — |
customer_idOptional | string | optional: 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 creditsCurrent 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
ad_group_idOptional | string | Google Ads ad group id (list_google_ad_groups) |
customer_idOptional | string | optional: 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 creditsThe 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.
| Parameter | Type | Description |
|---|---|---|
asset_typeOptional | TEXT | IMAGE | YOUTUBE_VIDEO | SITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | LEAD_FORM | BUSINESS_MESSAGE | MOBILE_APP | CALL_TO_ACTION | LOCATION | PAGE_FEED | — |
limitOptional | integer (1–1000) | — |
include_usageOptional | boolean | also list which campaigns/ad groups use each asset |
include_approvalOptional | boolean | add policy approval/review status |
customer_idOptional | string | optional: 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 creditsPer-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.
| Parameter | Type | Description |
|---|---|---|
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
daysOptional | integer (1–365) | — |
limitOptional | integer (1–1000) | — |
min_impressionsOptional | integer (0–…) | — |
customer_idOptional | string | optional: 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 creditsKeyword 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.
| Parameter | Type | Description |
|---|---|---|
keywordsRequired | array<string> | — |
language_idOptional | string | Google language constant id, default 1037 (Turkish) |
languageOptional | string | language code alternative (tr, en…) |
geo_idsOptional | array<string> | geo target constant ids (geo_target_search), default 2792 (Turkey) |
start_monthOptional | string | YYYY-MM |
end_monthOptional | string | YYYY-MM |
customer_idOptional | string | optional: 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 creditsDay-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.
| Parameter | Type | Description |
|---|---|---|
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
ad_group_idOptional | string | Google Ads ad group id (list_google_ad_groups) |
daysOptional | integer (1–90) | — |
limitOptional | integer (1–500) | — |
customer_idOptional | string | optional: 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 creditsEvery 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
customer_idOptional | string | optional: 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 creditsNegative 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.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–90) | — |
min_wasteOptional | number | minimum spend per term |
limitOptional | integer (1–500) | — |
customer_idOptional | string | optional: 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 creditsConversion 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.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–90) | — |
customer_idOptional | string | optional: 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 creditsHow 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.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–365) | — |
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
field_typeOptional | SITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | BUSINESS_MESSAGE | MOBILE_APP | HOTEL_CALLOUT | LEAD_FORM | BUSINESS_NAME | BUSINESS_LOGO | AD_IMAGE | — |
limitOptional | integer (1–1000) | — |
customer_idOptional | string | optional: 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 creditsA 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idRequired | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
customer_idOptional | string | optional: 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 creditsTag 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.
| Parameter | Type | Description |
|---|---|---|
conversion_action_idsOptional | array<string> | — |
customer_idOptional | string | optional: 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 creditsExtension 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
ad_group_idOptional | string | Google Ads ad group id (list_google_ad_groups) |
customer_idOptional | string | optional: 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 creditsAccount 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
customer_idOptional | string | optional: 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 creditsCustom 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.
| Parameter | Type | Description |
|---|---|---|
customer_idOptional | string | optional: 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 creditsMonth-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.
| Parameter | Type | Description |
|---|---|---|
threshold_pctOptional | number (1–100) | deviation that triggers an alert, default 10 |
customer_idOptional | string | optional: 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 creditsSearch 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.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–365) | — |
levelOptional | campaign | ad_group | — |
customer_idOptional | string | optional: 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 creditsAudience 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.
| Parameter | Type | Description |
|---|---|---|
limitOptional | integer (1–1000) | — |
definitionOptional | boolean | include the list's rule / seed definition |
customer_idOptional | string | optional: 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 creditsList 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.
| Parameter | Type | Description |
|---|---|---|
actionOptional | list | only list; use manage_experiment to end or promote |
customer_idOptional | string | optional: 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 |
geo_target_search
קריאה1 creditsLook up Google location targeting ids by name: id, type (city, province, country…), canonical name and reach — use the ids in location targeting. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.
| Parameter | Type | Description |
|---|---|---|
queryRequired | string | — |
countryOptional | string | ISO country hint |
levelOptional | string | filter by type, e.g. City, Province, Country, District, Postal Code |
limitOptional | integer (1–50) | — |
customer_idOptional | string | optional: 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 creditsAds 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.
| Parameter | Type | Description |
|---|---|---|
only_problemsOptional | boolean | default true: only disapproved / limited ads |
limitOptional | integer (1–1000) | — |
customer_idOptional | string | optional: 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 creditsLeads 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.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–90) | — |
asset_idOptional | string | lead form asset id |
limitOptional | integer (1–1000) | — |
customer_idOptional | string | optional: 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 creditsSwitch 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.
| Parameter | Type | Description |
|---|---|---|
customer_idRequired | string | client 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 creditsApply (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.
| Parameter | Type | Description |
|---|---|---|
recommendationsRequired | array<string> | resource names from list_google_ads_recommendations |
actionOptional | apply | dismiss | default apply |
customer_idOptional | string | optional: 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 creditsCreate 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.
| Parameter | Type | Description |
|---|---|---|
nameRequired | string | — |
daily_budgetRequired | number | account currency |
locationsOptional | array<string> | city/region/country names; default: brand profile city |
location_idsOptional | array<string> | Google geo target constant ids |
countryOptional | string | — |
languagesOptional | array<string> | language codes (tr, en…) or Google language ids; default Turkish |
bid_strategyOptional | maximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks | — |
target_cpaOptional | number | — |
target_roasOptional | number | — |
max_cpcOptional | number | — |
cpc_bidOptional | number | ad group default CPC |
keywordsOptional | array<any> | — |
headlinesOptional | array<any> | — |
descriptionsOptional | array<any> | — |
final_urlOptional | string | — |
ad_group_nameOptional | string | — |
search_partnersOptional | boolean | — |
end_dateOptional | string | YYYY-MM-DD |
goalOptional | string | — |
customer_idOptional | string | optional: 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 creditsCreate 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.
| Parameter | Type | Description |
|---|---|---|
nameRequired | string | — |
daily_budgetRequired | number | — |
final_urlRequired | string | — |
business_nameRequired | string | ≤25 chars |
headlinesRequired | array<string> | 3-15, ≤30 chars |
long_headlinesRequired | array<string> | 1-5, ≤90 chars |
descriptionsRequired | array<string> | 2-5, ≤90 chars |
marketing_imagesRequired | array<string> | 1.91:1 landscape, at least 1 |
square_marketing_imagesRequired | array<string> | 1:1, at least 1 |
logo_imagesRequired | array<string> | 1:1 logo, at least 1 |
portrait_marketing_imagesOptional | array<string> | image URLs (https) or Studio /medya files |
landscape_logo_imagesOptional | array<string> | image URLs (https) or Studio /medya files |
bid_strategyOptional | maximize_conversions | maximize_conversion_value | — |
target_cpaOptional | number | — |
target_roasOptional | number | — |
locationsOptional | array<string> | — |
countryOptional | string | — |
languagesOptional | array<string> | — |
asset_group_nameOptional | string | — |
end_dateOptional | string | — |
goalOptional | string | — |
customer_idOptional | string | optional: 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 creditsRename, 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idRequired | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
nameOptional | string | — |
statusOptional | pause | enable | — |
end_dateOptional | string | null | YYYY-MM-DD, or null to run indefinitely |
customer_idOptional | string | optional: 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 creditsBulk-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.
| Parameter | Type | Description |
|---|---|---|
renamesOptional | array<object> | — |
campaign_idsOptional | array<string> | — |
patternOptional | string | naming pattern with {name}, {channel}, {id}, e.g. 'Brand | {channel} | {name}' |
findOptional | string | — |
replaceOptional | string | — |
customer_idOptional | string | optional: 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 creditsPERMANENTLY 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idRequired | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
customer_idOptional | string | optional: 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 creditsSwitch 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idRequired | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
strategyRequired | maximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks | target_impression_share | — |
target_cpaOptional | number | account currency |
target_roasOptional | number | ratio, 4.0 = 400% |
max_cpcOptional | number | CPC ceiling for maximize_clicks / target_impression_share |
impression_share_locationOptional | ANYWHERE_ON_PAGE | TOP_OF_PAGE | ABSOLUTE_TOP_OF_PAGE | — |
impression_share_percentOptional | number (1–100) | — |
customer_idOptional | string | optional: 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 creditsSet 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idRequired | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
replaceOptional | boolean | remove the existing schedule first |
scheduleRequired | array<object> | — |
customer_idOptional | string | optional: 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 creditsTarget 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idRequired | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
locationsOptional | array<string> | names, e.g. İstanbul, Ankara |
location_idsOptional | array<string> | — |
countryOptional | string | ISO code hint, default TR |
excludeOptional | boolean | — |
replaceOptional | boolean | remove existing targeted locations (and languages, if given) first |
bid_adjustmentOptional | number | percent |
languagesOptional | array<string> | language codes (tr, en…) or Google language ids to target |
customer_idOptional | string | optional: 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 creditsSafe 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.
| Parameter | Type | Description |
|---|---|---|
target_campaign_idRequired | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
source_campaign_idsRequired | array<string> | — |
move_budgetOptional | boolean | add the sources' daily budgets to the target (default true) |
new_daily_budgetOptional | number | explicit target daily budget instead of the sum |
customer_idOptional | string | optional: 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 creditsExclude 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idRequired | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
ipsRequired | array<string> | IPv4/IPv6 addresses or CIDR blocks |
customer_idOptional | string | optional: 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 creditsRemove 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idRequired | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
ipsRequired | array<string> | IPv4/IPv6 addresses or CIDR blocks to stop excluding |
customer_idOptional | string | optional: 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 creditsAdd 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idRequired | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
nameRequired | string | — |
cpc_bidOptional | number | — |
keywordsOptional | array<any> | — |
headlinesOptional | array<any> | — |
descriptionsOptional | array<any> | — |
final_urlOptional | string | — |
path1Optional | string | — |
path2Optional | string | — |
customer_idOptional | string | optional: 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 creditsPause 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.
| Parameter | Type | Description |
|---|---|---|
ad_group_idsOptional | array<string> | — |
ad_group_idOptional | string | — |
statusRequired | pause | enable | — |
customer_idOptional | string | optional: 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 creditsPause 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.
| Parameter | Type | Description |
|---|---|---|
ad_group_idsRequired | array<string> | — |
customer_idOptional | string | optional: 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 creditsAdd 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.
| Parameter | Type | Description |
|---|---|---|
ad_group_idRequired | string | — |
keywordsRequired | array<any> | — |
customer_idOptional | string | optional: 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 creditsPause/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.
| Parameter | Type | Description |
|---|---|---|
ad_group_idRequired | string | — |
keyword_idRequired | string | — |
statusOptional | pause | enable | — |
bidOptional | number | — |
match_typeOptional | BROAD | PHRASE | EXACT | — |
customer_idOptional | string | optional: 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 creditsRemove 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
shared_list_idOptional | string | — |
keywordsOptional | array<string> | — |
criterion_idsOptional | array<string> | negative criterion ids (list_negative_keywords) instead of / in addition to text |
match_typeOptional | BROAD | PHRASE | EXACT | — |
customer_idOptional | string | optional: 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 creditsAdd 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.
| Parameter | Type | Description |
|---|---|---|
list_idOptional | string | — |
list_nameOptional | string | creates a new list when list_id is not given |
keywordsRequired | array<any> | — |
attach_campaign_idsOptional | array<string> | — |
customer_idOptional | string | optional: 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 creditsCreate 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.
| Parameter | Type | Description |
|---|---|---|
ad_group_idRequired | string | — |
headlinesRequired | array<any> | — |
descriptionsRequired | array<any> | — |
final_urlRequired | string | — |
path1Optional | string | — |
path2Optional | string | — |
final_mobile_urlOptional | string | — |
tracking_url_templateOptional | string | — |
statusOptional | enable | pause | — |
customer_idOptional | string | optional: 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 creditsRefresh 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.
| Parameter | Type | Description |
|---|---|---|
ad_group_idRequired | string | — |
ad_idRequired | string | — |
replace_low_performingOptional | boolean | — |
remove_headlinesOptional | array<string> | — |
add_headlinesOptional | array<any> | — |
remove_descriptionsOptional | array<string> | — |
add_descriptionsOptional | array<any> | — |
headlinesOptional | array<any> | — |
descriptionsOptional | array<any> | — |
final_urlOptional | string | — |
path1Optional | string | — |
path2Optional | string | — |
pause_oldOptional | boolean | default true |
customer_idOptional | string | optional: 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_sitelinks
כתיבה2 creditsAdd sitelink assets (text ≤25, optional two descriptions ≤35, final URL) 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idRequired | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
sitelinksRequired | array<object> | — |
customer_idOptional | string | optional: 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 creditsAdd 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idRequired | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
calloutsRequired | array<string> | ≤25 chars each |
customer_idOptional | string | optional: 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 creditsCreate 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.
| Parameter | Type | Description |
|---|---|---|
nameRequired | string | — |
categoryOptional | DEFAULT | 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_typeOptional | one | many | — |
primary_for_goalOptional | boolean | — |
default_valueOptional | number | — |
currencyOptional | string | — |
always_use_default_valueOptional | boolean | — |
click_through_window_daysOptional | integer (1–90) | — |
view_through_window_daysOptional | integer (1–30) | — |
phone_call_duration_secondsOptional | integer (0–10800) | — |
typeOptional | WEBPAGE | UPLOAD_CLICKS | UPLOAD_CALLS | AD_CALL | WEBSITE_CALL | CLICK_TO_CALL | default WEBPAGE; UPLOAD_CLICKS for offline conversion upload |
customer_idOptional | string | optional: 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 creditsChange 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.
| Parameter | Type | Description |
|---|---|---|
conversion_action_idRequired | string | — |
nameOptional | string | — |
statusOptional | enable | hide | remove | — |
categoryOptional | DEFAULT | 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_typeOptional | one | many | — |
primary_for_goalOptional | boolean | — |
default_valueOptional | number | — |
currencyOptional | string | — |
always_use_default_valueOptional | boolean | — |
click_through_window_daysOptional | integer (1–90) | — |
view_through_window_daysOptional | integer (1–30) | — |
phone_call_duration_secondsOptional | integer (0–10800) | — |
customer_idOptional | string | optional: 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 creditsAdd 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.
| Parameter | Type | Description |
|---|---|---|
asset_group_idRequired | string | — |
headlinesOptional | array<string> | — |
long_headlinesOptional | array<string> | — |
descriptionsOptional | array<string> | — |
business_nameOptional | string | — |
marketing_imagesOptional | array<string> | image URLs (https) or Studio /medya files |
square_marketing_imagesOptional | array<string> | image URLs (https) or Studio /medya files |
logo_imagesOptional | array<string> | image URLs (https) or Studio /medya files |
portrait_marketing_imagesOptional | array<string> | image URLs (https) or Studio /medya files |
landscape_logo_imagesOptional | array<string> | image URLs (https) or Studio /medya files |
customer_idOptional | string | optional: 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 creditsUpload 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.
| Parameter | Type | Description |
|---|---|---|
imagesRequired | array<any> | https URLs or Studio /medya files (JPEG/PNG/GIF, ≤5120 KB), up to 20 |
customer_idOptional | string | optional: 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 creditsCreate 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.
| Parameter | Type | Description |
|---|---|---|
nameRequired | string | — |
daily_budgetRequired | number | account currency |
final_urlRequired | string | — |
business_nameRequired | string | ≤25 chars |
headlinesRequired | array<string> | 1-5, ≤40 chars |
descriptionsRequired | array<string> | 1-5, ≤90 chars |
marketing_imagesOptional | array<string> | 1.91:1 landscape — URLs to upload or existing asset ids |
square_marketing_imagesOptional | array<string> | 1:1 — URLs or asset ids |
portrait_marketing_imagesOptional | array<string> | 4:5 — URLs or asset ids |
logo_imagesRequired | array<string> | 1:1 logo, at least 1 — URLs or asset ids |
call_to_actionOptional | string | e.g. Learn more, Shop now (≤15 chars) |
bid_strategyOptional | maximize_conversions | maximize_conversion_value | target_cpa | target_roas | maximize_clicks | — |
target_cpaOptional | number | — |
target_roasOptional | number | — |
max_cpcOptional | number | — |
audience_idsOptional | array<string> | Google Ads Audience ids (Audience Manager) to target on the ad group; empty = broad |
locationsOptional | array<string> | — |
location_idsOptional | array<string> | — |
countryOptional | string | — |
languagesOptional | array<string> | — |
ad_group_nameOptional | string | — |
end_dateOptional | string | YYYY-MM-DD |
goalOptional | string | — |
customer_idOptional | string | optional: 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 creditsCreate 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.
| Parameter | Type | Description |
|---|---|---|
nameRequired | string | — |
daily_budgetRequired | number | account currency |
app_idRequired | string | Apple numeric app id (e.g. 284815942) or Android package name (e.g. com.example.app) |
app_storeRequired | apple | google | — |
goalOptional | installs | installs_no_target | in_app_actions | in_app_actions_cpa | value | pre_registration | installs = 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_cpaOptional | number | target cost per install / in-app action |
target_roasOptional | number | — |
conversion_action_idsOptional | array<string> | in-app conversion actions for in_app / value goals (list_google_conversion_actions) |
headlinesRequired | array<string> | 2-5, ≤30 chars |
descriptionsRequired | array<string> | 1-5, ≤90 chars |
imagesOptional | array<string> | optional image URLs to upload or existing asset ids |
video_asset_idsOptional | array<string> | existing YouTube video asset ids |
locationsOptional | array<string> | — |
location_idsOptional | array<string> | — |
countryOptional | string | — |
languagesOptional | array<string> | — |
ad_group_nameOptional | string | — |
end_dateOptional | string | YYYY-MM-DD |
goal_noteOptional | string | — |
customer_idOptional | string | optional: 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 creditsClick-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.
| Parameter | Type | Description |
|---|---|---|
daysOptional | integer (1–365) | — |
start_dateOptional | string | YYYY-MM-DD |
end_dateOptional | string | YYYY-MM-DD |
threshold_rateOptional | number | — |
campaign_idsOptional | array<string> | explicit campaigns; default: campaigns flagged by the invalid-click report |
ipsOptional | array<string> | IPv4/IPv6 addresses or CIDR blocks from your own server/analytics logs |
customer_idOptional | string | optional: 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 creditsAdd 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.
| Parameter | Type | Description |
|---|---|---|
offer_idRequired | string | — |
content_languageOptional | string | default tr |
feed_labelOptional | string | default TR |
account_idOptional | string | Merchant Center account id; optional when the user has a single account or one is selected |
data_sourceOptional | string | data source id; default: the account's API/primary product data source |
titleOptional | string | — |
descriptionOptional | string | — |
linkOptional | string | — |
image_linkOptional | string | — |
priceOptional | number | — |
sale_priceOptional | number | — |
currencyOptional | string | ISO, default TRY |
availabilityOptional | in stock | out of stock | preorder | backorder | — |
conditionOptional | new | refurbished | used | — |
brandOptional | string | — |
gtinOptional | string | — |
googleProductCategoryOptional | string | — |
imageLinkOptional | string | Alias of image_link |
channelOptional | ONLINE | LOCAL | default ONLINE |
attributesOptional | object | other 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 creditsEnd 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.
| Parameter | Type | Description |
|---|---|---|
experiment_idRequired | string | — |
actionRequired | end | promote | — |
customer_idOptional | string | optional: 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 creditsAdd 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.
| Parameter | Type | Description |
|---|---|---|
ad_group_idRequired | string | Google Ads ad group id (list_google_ad_groups) |
youtube_videoRequired | string | YouTube URL or 11-char id, or an existing video asset id |
headlinesRequired | array<string> | 1-5, ≤40 |
long_headlinesRequired | array<string> | 1-5, ≤90 |
descriptionsRequired | array<string> | 1-5, ≤90 |
business_nameRequired | string | — |
final_urlRequired | string | — |
logo_asset_idRequired | string | 1:1 logo asset id or image URL |
call_to_actionOptional | LEARN_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_nameOptional | string | — |
statusOptional | enable | pause | — |
customer_idOptional | string | optional: 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 creditsDuplicate 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.
| Parameter | Type | Description |
|---|---|---|
ad_group_idsRequired | array<string> | — |
target_campaign_idRequired | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
new_nameOptional | string | — |
name_suffixOptional | string | — |
statusOptional | pause | enable | default pause |
cpc_bidOptional | number | — |
include_keywordsOptional | boolean | — |
include_negativesOptional | boolean | — |
include_adsOptional | boolean | — |
include_assetsOptional | boolean | — |
include_audiencesOptional | boolean | — |
customer_idOptional | string | optional: 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 creditsLocation 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.
| Parameter | Type | Description |
|---|---|---|
ad_group_idRequired | string | Google Ads ad group id (list_google_ad_groups) |
locationsOptional | array<string> | — |
location_idsOptional | array<string> | — |
negative_locationsOptional | array<string> | — |
negative_location_idsOptional | array<string> | — |
languagesOptional | array<string> | — |
countryOptional | string | — |
modeOptional | add | replace | — |
customer_idOptional | string | optional: 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 creditsRename 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.
| Parameter | Type | Description |
|---|---|---|
ad_group_idRequired | string | Google Ads ad group id (list_google_ad_groups) |
nameOptional | string | — |
cpc_bidOptional | number | — |
statusOptional | pause | enable | — |
customer_idOptional | string | optional: 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 creditsEnable, 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.
| Parameter | Type | Description |
|---|---|---|
ad_group_idRequired | string | Google Ads ad group id (list_google_ad_groups) |
ad_idRequired | string | — |
statusRequired | ENABLED | PAUSED | REMOVED | — |
customer_idOptional | string | optional: 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 creditsAdd 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.
| Parameter | Type | Description |
|---|---|---|
asset_group_idRequired | string | — |
headlinesOptional | array<string> | — |
long_headlinesOptional | array<string> | — |
descriptionsOptional | array<string> | — |
remove_resource_namesOptional | array<string> | asset group asset links from list_google_asset_groups |
customer_idOptional | string | optional: 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 creditsEdit 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.
| Parameter | Type | Description |
|---|---|---|
ad_idRequired | string | — |
headlinesOptional | array<any> | — |
descriptionsOptional | array<any> | — |
add_headlinesOptional | array<any> | — |
remove_headlinesOptional | array<string> | — |
add_descriptionsOptional | array<any> | — |
remove_descriptionsOptional | array<string> | — |
headline_pinsOptional | object | {text: pin field} — empty string unpins |
description_pinsOptional | object | {text: pin field} — empty string unpins |
final_urlOptional | string | — |
path1Optional | string | — |
path2Optional | string | — |
customer_idOptional | string | optional: 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 creditsAdd 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
ad_group_idOptional | string | Google Ads ad group id (list_google_ad_groups) |
textOptional | string | — |
keywordsOptional | array<any> | — |
match_typeOptional | BROAD | PHRASE | EXACT | — |
skip_existingOptional | boolean | default true |
customer_idOptional | string | optional: 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 creditsBulk 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.
| Parameter | Type | Description |
|---|---|---|
ad_group_idRequired | string | Google Ads ad group id (list_google_ad_groups) |
criterion_idsRequired | array<string> | — |
actionRequired | pause | enable | remove | set_bid | set_url | — |
cpc_bidOptional | number | — |
final_urlOptional | string | — |
final_mobile_urlOptional | string | — |
customer_idOptional | string | optional: 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 creditsManage 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.
| Parameter | Type | Description |
|---|---|---|
actionRequired | create | add_keywords | remove_keywords | attach | detach | rename | delete | — |
shared_set_idOptional | string | — |
nameOptional | string | — |
keywordsOptional | array<any> | — |
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
campaign_idsOptional | array<string> | — |
customer_idOptional | string | optional: 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 creditsDismiss 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.
| Parameter | Type | Description |
|---|---|---|
resource_namesRequired | array<string> | from list_google_ads_recommendations |
customer_idOptional | string | optional: 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 creditsAdd 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
ad_group_idOptional | string | Google Ads ad group id (list_google_ad_groups) |
sitelinksOptional | array<object> | — |
calloutsOptional | array<string> | — |
snippet_headerOptional | string | e.g. Services, Brands, Types, Destinations |
snippet_valuesOptional | array<string> | — |
phone_numberOptional | string | — |
phone_countryOptional | string | — |
whatsapp_numberOptional | string | — |
whatsapp_countryOptional | string | — |
whatsapp_greetingOptional | string | — |
whatsapp_ctaOptional | APPLY_NOW | BOOK_NOW | CONTACT_US | GET_INFO | GET_OFFER | GET_QUOTE | GET_STARTED | LEARN_MORE | — |
whatsapp_cta_textOptional | string | — |
promotionsOptional | array<object> | — |
pricesOptional | object | — |
customer_idOptional | string | optional: 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 creditsUnlink 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.
| Parameter | Type | Description |
|---|---|---|
resource_namesOptional | array<string> | link resource names from list_extension_assets |
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
field_typeOptional | SITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | BUSINESS_MESSAGE | MOBILE_APP | HOTEL_CALLOUT | LEAD_FORM | BUSINESS_NAME | BUSINESS_LOGO | AD_IMAGE | with campaign_id: remove every link of this type |
customer_idOptional | string | optional: 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_sitelink
כתיבה2 creditsEdit an existing sitelink in place (link text, the two description lines, final URL) without recreating 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.
| Parameter | Type | Description |
|---|---|---|
asset_idRequired | string | — |
link_textOptional | string | — |
description1Optional | string | — |
description2Optional | string | — |
final_urlOptional | string | — |
customer_idOptional | string | optional: 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 creditsPortfolio (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.
| Parameter | Type | Description |
|---|---|---|
actionOptional | list | create | update | assign | — |
nameOptional | string | — |
strategyOptional | target_cpa | target_roas | maximize_clicks | maximize_conversions | maximize_conversion_value | target_impression_share | — |
target_cpaOptional | number | — |
target_roasOptional | number | — |
max_cpcOptional | number | — |
min_cpcOptional | number | — |
impression_share_locationOptional | ANYWHERE_ON_PAGE | TOP_OF_PAGE | ABSOLUTE_TOP_OF_PAGE | — |
impression_share_percentOptional | number (1–100) | — |
bidding_strategy_idOptional | string | — |
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
customer_idOptional | string | optional: 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 creditsSee 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.
| Parameter | Type | Description |
|---|---|---|
actionOptional | list | enable | disable | — |
typesOptional | array<string> | — |
customer_idOptional | string | optional: 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 creditsMake 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.
| Parameter | Type | Description |
|---|---|---|
categoryRequired | DEFAULT | 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 | — |
originOptional | WEBSITE | GOOGLE_HOSTED | APP | CALL_FROM_ADS | STORE | YOUTUBE_HOSTED | LOCAL_SERVICES_ADS | — |
roleRequired | primary | secondary | — |
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
customer_idOptional | string | optional: 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 creditsCreate, 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.
| Parameter | Type | Description |
|---|---|---|
goal_idOptional | string | omit to create a new goal |
conversion_actionsOptional | array<string> | — |
nameOptional | string | — |
removeOptional | boolean | — |
customer_idOptional | string | optional: 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 creditsUpload 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.
| Parameter | Type | Description |
|---|---|---|
conversion_actionRequired | string | id of an UPLOAD_CLICKS conversion action |
currency_codeOptional | string | — |
conversionsRequired | array<object> | — |
customer_idOptional | string | optional: 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 creditsRetract (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.
| Parameter | Type | Description |
|---|---|---|
conversion_actionRequired | string | — |
currency_codeOptional | string | — |
adjustmentsRequired | array<object> | — |
customer_idOptional | string | optional: 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 creditsCreate 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.
| Parameter | Type | Description |
|---|---|---|
nameRequired | string | — |
membership_daysOptional | integer (1–540) | — |
upload_key_typeOptional | CONTACT_INFO | CRM_ID | MOBILE_ADVERTISING_ID | — |
customer_idOptional | string | optional: 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 creditsCreate 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.
| Parameter | Type | Description |
|---|---|---|
nameRequired | string | — |
seed_user_list_idsRequired | array<string> | — |
country_codesRequired | array<string> | — |
expansion_levelOptional | NARROW | BALANCED | BROAD | — |
membership_daysOptional | integer (1–540) | — |
customer_idOptional | string | optional: 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 creditsCreate 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.
| Parameter | Type | Description |
|---|---|---|
nameRequired | string | — |
url_containsRequired | any | — |
string_operatorOptional | CONTAINS | EQUALS | STARTS_WITH | ENDS_WITH | — |
membership_daysOptional | integer (1–540) | — |
lookback_daysOptional | integer (1–540) | — |
customer_idOptional | string | optional: 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 creditsAttach 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.
| Parameter | Type | Description |
|---|---|---|
audienceRequired | string | user list id (list_audiences) |
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
ad_group_idOptional | string | Google Ads ad group id (list_google_ad_groups) |
actionOptional | add | remove | — |
modeOptional | observation | targeting | — |
bid_modifierOptional | number | multiplier, 1.2 = +20% |
customer_idOptional | string | optional: 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 creditsRead (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.
| Parameter | Type | Description |
|---|---|---|
campaign_idRequired | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
geo_target_typeOptional | PRESENCE | PRESENCE_OR_INTEREST | — |
search_partnersOptional | boolean | — |
display_expansionOptional | boolean | — |
tracking_url_templateOptional | string | — |
eu_political_adsOptional | boolean | — |
ai_maxOptional | boolean | AI Max for Search |
customer_idOptional | string | optional: 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 creditsOpen 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.
| Parameter | Type | Description |
|---|---|---|
manager_customer_idRequired | string | — |
nameRequired | string | — |
currency_codeRequired | string | — |
time_zoneRequired | string | — |
tracking_url_templateOptional | string | — |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
create_lead_form
כתיבה2 creditsCreate 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.
| Parameter | Type | Description |
|---|---|---|
business_nameRequired | string | — |
headlineRequired | string | — |
descriptionRequired | string | — |
privacy_policy_urlRequired | string | — |
final_urlRequired | string | — |
ctaOptional | LEARN_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_descriptionOptional | string | — |
fieldsOptional | array<FULL_NAME | FIRST_NAME | LAST_NAME | EMAIL | PHONE_NUMBER | POSTAL_CODE | STREET_ADDRESS | CITY | REGION | COUNTRY | WORK_EMAIL | COMPANY_NAME | WORK_PHONE | JOB_TITLE> | — |
questionsOptional | array<any> | — |
post_submit_headlineOptional | string | — |
post_submit_descriptionOptional | string | — |
post_submit_ctaOptional | VISIT_SITE | DOWNLOAD | LEARN_MORE | SHOP_NOW | — |
webhook_urlOptional | string | — |
webhook_keyOptional | string | — |
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
ad_group_idOptional | string | Google Ads ad group id (list_google_ad_groups) |
customer_idOptional | string | optional: 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_logo
כתיבה2 creditsReplace the business logo 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idRequired | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
asset_idRequired | string | 1:1 image asset id or image URL |
customer_idOptional | string | optional: 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 creditsSet 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idRequired | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
textRequired | string | ≤25 chars |
customer_idOptional | string | optional: 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 creditsList, 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idRequired | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
actionOptional | list | add | remove | — |
latOptional | number | — |
lngOptional | number | — |
radiusOptional | number | — |
unitsOptional | KILOMETERS | MILES | — |
pointsOptional | array<object> | — |
criterion_idOptional | string | — |
criterion_idsOptional | array<string> | — |
customer_idOptional | string | optional: 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 creditsSet 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.
| Parameter | Type | Description |
|---|---|---|
campaign_idRequired | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
deviceRequired | MOBILE | DESKTOP | TABLET | CONNECTED_TV | — |
bid_modifier_pctRequired | number | -90..900, or -100 to exclude |
customer_idOptional | string | optional: 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 creditsTurn 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.
| Parameter | Type | Description |
|---|---|---|
call_reportingOptional | boolean | — |
call_conversionOptional | boolean | — |
call_conversion_action_idOptional | string | — |
customer_idOptional | string | optional: 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 creditsChange 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.
| Parameter | Type | Description |
|---|---|---|
asset_group_idRequired | string | — |
final_urlOptional | string | — |
nameOptional | string | — |
statusOptional | ENABLED | PAUSED | REMOVED | — |
path1Optional | string | — |
path2Optional | string | — |
customer_idOptional | string | optional: 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.