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 tools45 tools
list_google_ads_accounts
Read1 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
Read2 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 | ad | keyword | search_term | 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
Read2 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
Read1 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
Read1 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
Read2 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
Read2 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
Read1 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
Read1 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
Read1 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
Read1 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
Read1 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 |
statusOptional | string | only this status, e.g. ENABLED or REMOVED |
searchOptional | string | name contains |
include_removedOptional | boolean | also list removed actions (to verify a removal) |
limitOptional | integer (1–200) | default 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_google_asset_groups
Read1 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
Read1 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
Read1 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
Read2 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
Read1 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
Read1 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
Read1 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
Read1 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
Read2 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
Read1 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
Read1 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
Read2 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
Read2 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
Read2 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
Read2 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
Read1 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
Read2 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
Read2 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
Read2 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
Read1 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
Read1 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
Read1 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
Read1 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
Read1 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
Read2 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
Read2 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
Read1 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 |
searchOptional | string | name contains, or exact list 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_experiments
Read1 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
Read1 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 |
google_campaign_diagnosis
Read2 creditsLIVE status diagnosis of a Google Ads campaign — call this FIRST when the user reports a warning or status such as misconfigured, limited, not eligible, learning, disapproved ('Yanlış yapılandırıldı', 'Sınırlı', 'Öğreniyor', 'Teklif stratejisi hatalı yapılandırılmış'), and to verify a change afterwards. Returns primary status with every reason (code, meaning, typical fix, tools), serving status, bidding strategy type with its target CPA / ROAS, the field holding the target, the bid strategy system status (the exact cause behind a bidding misconfiguration), App campaign goal type, budget and Google's recommended budget, start/end dates, the conversion actions it optimises for with their status, findings, recommendations and recent changes. Amounts in account currency. Read only. 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; omit to list every campaign that has a status issue |
relatedOptional | boolean | default true: also this campaign's recommendations and last 14 days of changes |
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
Read2 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
Read2 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 |
list_google_location_assets
Read1 creditsBusiness Profile location sync in Google Ads: location asset sets (LOCATION_SYNC, location groups), whether they are linked to the account, and the synced location assets. linked=false means ads cannot show the Business Profile address yet. 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 |
Write tools74 tools
select_google_ads_account
Write1 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
Write2 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
Write2 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
Write2 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.
create_google_display_campaign
Write2 creditsCreate a Display Network campaign: budget + campaign + ad group + responsive display ad (images downloaded from the given URLs, cropped to each field's ratio and uploaded) in one atomic request, created PAUSED. Search network is off, so it runs only on the Display Network. 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> | 1-5, ≤30 chars |
long_headlineRequired | string | ≤90 chars |
descriptionsRequired | array<string> | 1-5, ≤90 chars |
marketing_imagesRequired | array<string> | 1.91:1 landscape, at least 1 |
square_marketing_imagesOptional | array<string> | 1:1, at least 1 (cropped from the landscape one if missing) |
logo_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 | target_cpa | maximize_clicks | manual_cpc | — |
target_cpaOptional | number | — |
max_cpcOptional | number | — |
cpc_bidOptional | number | — |
locationsOptional | array<string> | — |
countryOptional | string | — |
languagesOptional | array<string> | — |
ad_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.
create_google_shopping_campaign
Write2 creditsCreate a standard Shopping campaign: budget + campaign + ad group + product ad in one atomic request, created PAUSED. Products come from the linked Merchant Center account; priority 0-2 decides which campaign wins when several hold the same product. 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 | — |
merchant_idRequired | string | — |
campaign_priorityOptional | 0 | 1 | 2 | — |
feed_labelOptional | string | — |
enable_localOptional | boolean | — |
bid_strategyOptional | manual_cpc | maximize_clicks | target_roas | maximize_conversion_value | — |
target_roasOptional | number | — |
max_cpcOptional | number | — |
cpc_bidOptional | number | — |
locationsOptional | array<string> | — |
countryOptional | string | — |
languagesOptional | array<string> | — |
ad_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.
manage_google_conversion_value_rules
Write2 creditsAdjust conversion value at auction time by condition: e.g. a conversion from mobile counts 1.2x, or from a city counts more. One condition per rule (device, location or audience); the rule is attached to a value rule set on the account or one 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 |
|---|---|---|
actionOptional | create | remove | — |
operationOptional | ADD | MULTIPLY | SET | — |
valueOptional | number | MULTIPLY 0.5-10; ADD/SET > 0 in account currency |
device_typesOptional | array<string> | e.g. MOBILE, DESKTOP, TABLET |
geo_target_idsOptional | array<string> | — |
geo_match_typeOptional | string | — |
user_list_idsOptional | array<string> | — |
campaign_idOptional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
resource_nameOptional | string | for action=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 |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
update_google_campaign
Write2 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
Write2 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
WriteIrreversible2 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
Write2 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). On an App campaign the strategy type cannot be changed; only its target is updated (target_cpa = target cost per install / in-app action, or target_roas). Read google_campaign_diagnosis first: do not change a target to clear a warning whose cause you have not read. The previous value is stored and the change can be undone. 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
Write2 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
Write2 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
WriteIrreversible2 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
Write2 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
Write2 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
Write2 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
Write2 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
Write2 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
Write2 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
Write2 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
WriteIrreversible2 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
Write2 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
Write2 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
Write2 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
Write2 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
Write2 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
Write2 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 | 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
Write2 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 | ENABLED | HIDDEN | REMOVED | — |
categoryOptional | DEFAULT | PAGE_VIEW | PURCHASE | SIGNUP | DOWNLOAD | ADD_TO_CART | BEGIN_CHECKOUT | SUBSCRIBE_PAID | PHONE_CALL_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
Write2 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
Write2 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
Write2 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
Write2 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.
update_google_app_ad
Write2 creditsReplace the headlines and descriptions of a Google App campaign ad (read current copy with get_ad_details). The result keeps the previous copy.
| Parameter | Type | Description |
|---|---|---|
ad_idRequired | string | — |
headlinesOptional | array<string> | 2-5, up to 30 characters |
descriptionsOptional | array<string> | 1-5, up to 90 characters |
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
Write2 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
Write2 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
WriteIrreversible2 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
Write2 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
Write2 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
Write2 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
Write2 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
WriteIrreversible2 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
Write2 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
Write2 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
Write2 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
WriteIrreversible2 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
WriteIrreversible2 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
Write2 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
Write2 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
WriteIrreversible2 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
Write2 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
Write2 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_google_bidding_periods
Write2 creditsTell smart bidding about a short period in advance: a seasonality adjustment for a sale or launch (expected conversion-rate multiplier), or a data exclusion for days when measurement was broken (site down, tag missing) so those days do not teach the bidder. Read existing ones with google_ads_query (bidding_seasonality_adjustment / bidding_data_exclusion). 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 | create | remove | — |
typeRequired | seasonality | data_exclusion | — |
nameOptional | string | — |
scopeOptional | CAMPAIGN | CHANNEL | — |
campaign_idsOptional | array<string> | — |
channel_typesOptional | array<string> | — |
devicesOptional | array<string> | — |
start_date_timeOptional | string | YYYY-MM-DD or YYYY-MM-DD HH:MM:SS, account time zone |
end_date_timeOptional | string | YYYY-MM-DD or YYYY-MM-DD HH:MM:SS, account time zone |
conversion_rate_modifierOptional | number (0.1–10) | seasonality only: 1.2 = 20% more conversions expected |
resource_nameOptional | string | for action=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 |
Write tool: the call first produces a preview; the change reaches the platform only after you approve it.
manage_recommendation_auto_apply
Write2 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
Write2 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 | 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
WriteIrreversible2 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
Write2 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. Goes through Google Data Manager when Google requires it; error scope_missing means the user must re-authorise Google once for offline conversions (Connections › Google). 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
Write2 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
Write2 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.
link_google_business_profile
Write2 creditsLink Google Business Profile locations to the Google Ads account as location assets (address, directions, call in ads; store visit conversions). Uses the connected Business Profile; filter by business name, label or listing id when the profile has several businesses. Only one sync per account; an existing one is reused. 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_name_filterOptional | string | only listings with this business name |
label_filtersOptional | array<string> | only listings with one of these Business Profile labels |
listing_idsOptional | array<string> | only these Business Profile listing ids |
business_account_idOptional | string | — |
emailOptional | string | Business Profile account e-mail; default: the connected Google account |
nameOptional | 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_campaign_locations
Write2 creditsShow only some Business Profile locations in one campaign's ads (dynamic location group by label or listing id), so another business's address does not appear when the account syncs several businesses. Needs the account-level sync (link_google_business_profile). 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 |
label_filtersOptional | array<string> | Business Profile labels (OR) |
listing_idsOptional | array<string> | Business Profile listing ids (OR) |
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_audience
WriteIrreversible2 creditsPermanently remove a Google Ads audience list (Customer Match, website, lookalike). A list still used by a campaign is rejected by Google; use 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 |
|---|---|---|
user_list_idRequired | string | audience (user list) id from list_audiences |
nameOptional | string | list name, shown in the approval |
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
Write2 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
Write2 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
Write2 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
Write2 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
WriteIrreversible2 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
Write2 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
Write2 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
Write2 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
Write2 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
Write2 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
Write2 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
WriteIrreversible2 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.