Zum Inhalt springen
Tecrübetecrube.com
Assistenten-Tools · Einrichtung und Kampagnen

Google-Ads-Tools

Such- und Performance-Max-Kampagnen, Keywords, Anzeigentexte, Conversions, Gebotsstrategien und Empfehlungen.

Toolnamen und Beschreibungen werden direkt aus dem Servercode erzeugt; die Beschreibungen sind Übersetzungen des Textes, den der Assistent sieht, Tool- und Parameternamen bleiben unverändert.

Lese-Tools45 Tools

list_google_ads_accounts

Lesen1 Credits

Google Ads-Konten, auf die der verbundene Google-Nutzer zugreifen kann, einschließlich Kundenkonten unter MCC-/Verwaltungskonten (ID, Name, Währung, Zeitzone, Verwalter, login_customer_id), und welches ausgewählt ist. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

Dieses Tool hat keine Parameter.

google_device_report

Lesen2 Credits

Google Ads-Leistung aufgeteilt nach Gerät (Mobil, Desktop, Tablet, Connected TV) mit CPA und ROAS je Gerät. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

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

list_google_ads_recommendations

Lesen1 Credits

Googles eigene Optimierungsempfehlungen (Typ, Kampagne, geschätzte Auswirkung). Ausgewählte mit apply_google_ads_recommendation anwenden. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
typesOptionalarray<string>Empfehlungstypen, z. B. KEYWORD, CAMPAIGN_BUDGET, SITELINK_ASSET
campaign_idOptionalstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
include_dismissedOptionalboolean—
limitOptionalinteger (1–10000)—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

google_keyword_planner

Lesen2 Credits

Ideen aus dem Google Ads Keyword-Planer: echte durchschnittliche monatliche Suchanfragen, Wettbewerb und Gebotsspanne für die obere Seitenposition zu Ausgangs-Keywords oder einer URL. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
seed_keywordsOptionalarray<string>—
urlOptionalstring—
locationOptionalstringStadt-/Regionsnamen, kommagetrennt
countryOptionalstringISO-Code, Standard TR
languageOptionalstringtr, en, de, fr, es, ar, ru
limitOptionalinteger (10–500)—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_ip_exclusions

Lesen1 Credits

IP-Ausschlüsse in Google Ads-Kampagnen. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
campaign_idOptionalstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_ad_groups

Lesen1 Credits

Anzeigengruppen (ID, Name, Status, Standard-CPC) des Google Ads-Kontos oder einer Kampagne. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
campaign_idOptionalstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_shared_negative_lists

Lesen1 Credits

Gemeinsame Listen auszuschließender Keywords im Google Ads-Konto mit Keyword-Anzahl und zugeordneten Kampagnen. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
list_idOptionalstringliefert zusätzlich die Keywords dieser Liste
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_ads

Lesen1 Credits

Responsive Suchanzeigen mit allen Anzeigentiteln/Beschreibungen, Googles Leistungslabel (LOW/GOOD/BEST), Anzeigeneffektivität und finaler URL. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
campaign_idOptionalstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
ad_group_idOptionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_conversion_actions

Lesen1 Credits

Conversion-Aktionen des Google Ads-Kontos: Typ, Kategorie, Status, primär/sekundär, Zählung, Werteinstellungen, Klick-Conversion-Fenster. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
daysOptionalinteger (1–365)also return conversions recorded per action in this window
statusOptionalstringonly this status, e.g. ENABLED or REMOVED
searchOptionalstringname contains
include_removedOptionalbooleanalso list removed actions (to verify a removal)
limitOptionalinteger (1–200)default 50
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_asset_groups

Lesen1 Credits

Performance Max-Asset-Gruppen mit Anzeigeneffektivität, finalen URLs und ihren Text-/Bild-Assets je Feldtyp. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

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

list_google_demand_gen_campaigns

Lesen1 Credits

Demand Gen-Kampagnen des Google Ads-Kontos mit Status, Gebotsstrategie, Tagesbudget und Zeitraumleistung (Ausgaben, Klicks, Impressionen, Conversions, Umsatz, CTR, CPC, CPA, ROAS). Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

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

list_google_app_campaigns

Lesen1 Credits

App-Kampagnen des Google Ads-Kontos mit App-ID, Store, Gebotsziel, Status, Tagesbudget und Zeitraumleistung. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

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

google_invalid_clicks_report

Lesen2 Credits

Bericht zu ungültigen Klicks (Klickbetrug) je Kampagne und Tag aus Googles eigenen Messwerten (metrics.invalid_clicks, metrics.invalid_click_rate, clicks, cost) für die letzten N Tage (Standard 14); markiert Kampagnen, deren ungültige Rate den Schwellenwert (Standard 10 %) überschreitet oder deren letzter Tag sprunghaft anstieg (3x des vorherigen Durchschnitts), plus Städte mit vielen Klicks ohne Conversions bei verdächtigen Kampagnen. Ehrliche Grenzen: Google meldet nur bereits herausgefilterte ungültige Klicks und gibt nie Klicker-IPs preis — ein Warnsignal, kein Beweis auf IP-Ebene. Ungültige Klicks werden nicht berechnet. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
daysOptionalinteger (1–365)—
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
campaign_idOptionalstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
threshold_rateOptionalnumberverdächtige Rate ungültiger Klicks als Bruchteil, Standard 0.10
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_merchant_accounts

Lesen1 Credits

Google Merchant Center-Konten, die mit dem verbundenen Google-Token erreichbar sind (Merchant API accounts v1beta): ID, Name, Sprache, Zeitzone, Testkennzeichen. Nutzt die verbundene Google-Einwilligung; liefert error=scope_missing, wenn der Merchant Center-Bereich (auth/content) fehlt — der Nutzer muss Google neu autorisieren.

Dieses Tool hat keine Parameter.

list_merchant_products

Lesen1 Credits

Merchant Center-Produkte (Merchant API products v1beta) mit Titel, Angebots-ID, Preis, Verfügbarkeit, Freigabestatus je Ziel und Problemen auf Artikelebene; Filter auf abgelehnte / ausstehende / Produkte mit Problemen. Nutzt die verbundene Google-Einwilligung; liefert error=scope_missing, wenn der Merchant Center-Bereich (auth/content) fehlt — der Nutzer muss Google neu autorisieren.

ParameterTypBeschreibung
account_idOptionalstringMerchant Center-Konto-ID; optional, wenn der Nutzer ein einziges Konto hat oder eines ausgewählt ist
statusOptionalall | disapproved | pending | approved | issuesissues = beliebiges Problem auf Artikelebene oder abgelehntes Land
queryOptionalstringTeilzeichenfolge von Titel oder Angebots-ID
limitOptionalinteger (1–1000)—

get_merchant_product_issues

Lesen1 Credits

Probleme auf Artikelebene eines Merchant Center-Produkts (Code, Schweregrad, Lösung, Beschreibung, betroffene Länder) plus seine Zielstatus; markiert, welche Probleme der Händler über Produktdaten beheben kann. Nutzt die verbundene Google-Einwilligung; liefert error=scope_missing, wenn der Merchant Center-Bereich (auth/content) fehlt — der Nutzer muss Google neu autorisieren.

ParameterTypBeschreibung
account_idOptionalstringMerchant Center-Konto-ID; optional, wenn der Nutzer ein einziges Konto hat oder eines ausgewählt ist
product_idOptionalstringz. B. online~tr~TR~SKU123 (aus list_merchant_products)
offer_idOptionalstring—

merchant_feed_status

Lesen1 Credits

Merchant Center-Datenquellen (Feeds): Typ, Eingabemethode (API/FILE/UI/AUTOFEED), Feed-Label, Sprache und bei Dateifeeds der Verarbeitungsstatus des letzten Uploads, Artikelanzahl und Probleme. Nutzt die verbundene Google-Einwilligung; liefert error=scope_missing, wenn der Merchant Center-Bereich (auth/content) fehlt — der Nutzer muss Google neu autorisieren.

ParameterTypBeschreibung
account_idOptionalstringMerchant Center-Konto-ID; optional, wenn der Nutzer ein einziges Konto hat oder eines ausgewählt ist

get_ad_details

Lesen1 Credits

Vollständiger Inhalt von Google Ads-Anzeigen (Typ, jeder RSA-Anzeigentitel und jede Beschreibung mit Fixierungen, URLs, Tracking-Vorlage, Status) plus Anzeigeneffektivität, Googles Verbesserungsvorschläge und Richtlinienstatus. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
campaign_idOptionalstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
ad_group_idOptionalstringGoogle Ads-Anzeigengruppen-ID (list_google_ad_groups)
ad_idOptionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

get_campaign_targeting

Lesen1 Credits

Aktuelles Targeting einer Google Ads-Kampagne (oder Anzeigengruppe): Standorte mit Namen, ausgeschlossene Standorte, Umkreis-Ziele (Breite/Länge, Radius, Einheit), Sprachen, Gebotsanpassungen für Geräte, Zielgruppen und die Standortoption Anwesenheit/Interesse. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
campaign_idOptionalstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
ad_group_idOptionalstringGoogle Ads-Anzeigengruppen-ID (list_google_ad_groups)
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_assets

Lesen2 Credits

Die gesamte Google Ads-Asset-Bibliothek des Kontos (Text, Bilder mit Größe, YouTube-Videos, Sitelinks, Callouts, Snippets, Anrufe, Angebote, Preise, Lead-Formulare, WhatsApp), optional mit Verwendungsort und Freigabestatus jedes Assets. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
asset_typeOptionalTEXT | IMAGE | YOUTUBE_VIDEO | SITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | LEAD_FORM | BUSINESS_MESSAGE | MOBILE_APP | CALL_TO_ACTION | LOCATION | PAGE_FEED—
limitOptionalinteger (1–1000)—
include_usageOptionalbooleanauch auflisten, welche Kampagnen/Anzeigengruppen jedes Asset nutzen
include_approvalOptionalbooleanRichtlinien-Freigabe-/Prüfstatus hinzufügen
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

rsa_asset_performance

Lesen2 Credits

Ergebnisse responsiver Suchanzeigen je Anzeigentitel und Beschreibung (Impressionen, Klicks, Kosten, Conversions, Wert, CPA, CTR, Conversion-Rate) mit Googles LOW/GOOD/BEST-Label, Fixierung und der Anzeigeneffektivität. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

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

keyword_historical_metrics

Lesen2 Credits

Historische Keyword-Planer-Messwerte für bereits bekannte Keywords: durchschnittliche und monatliche Suchanfragen, Wettbewerb, Gebotsspanne für oben auf der Seite und durchschnittlicher CPC. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
keywordsPflichtarray<string>—
language_idOptionalstringGoogle-Sprachkonstanten-ID, Standard 1037 (Türkisch)
languageOptionalstringalternativ ein Sprachcode (tr, en…)
geo_idsOptionalarray<string>Geo-Target-Konstanten-IDs (geo_target_search), Standard 2792 (Türkei)
start_monthOptionalstringYYYY-MM
end_monthOptionalstringYYYY-MM
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

keyword_quality_report

Lesen2 Credits

Historischer Qualitätsfaktor pro Keyword Tag für Tag mit seinen drei Komponenten; markiert die Tage, an denen er gesunken ist, und welche Komponente sich geändert hat. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
campaign_idOptionalstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
ad_group_idOptionalstringGoogle Ads-Anzeigengruppen-ID (list_google_ad_groups)
daysOptionalinteger (1–90)—
limitOptionalinteger (1–500)—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_negative_keywords

Lesen1 Credits

Alle geltenden auszuschließenden Keywords: auf Kampagnenebene, auf Anzeigengruppenebene und die mit Kampagnen verknüpften gemeinsamen Ausschlusslisten (mit ihren Keywords). Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
campaign_idOptionalstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

smart_negative_keywords

Lesen2 Credits

Vorschläge für auszuschließende Keywords: Suchbegriffe, die ohne Conversion Geld ausgegeben haben und nirgends bereits ausgeschlossen sind, sortiert nach Ausgaben (geschätzte Einsparung). Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

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

conversion_tracking_health

Lesen2 Credits

Check-up des Conversion-Trackings: ausgeblendete/entfernte Aktionen, primäre Aktionen, die im Zeitraum nichts erfasst haben, und eine fehlende primäre Aktion. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

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

extension_asset_performance

Lesen2 Credits

Leistung der Kampagnenerweiterungen (Sitelinks, Callouts, Anruf, Snippets, Angebote, Preise, WhatsApp, Bilder, Unternehmensname/-logo): Impressionen, Klicks, Kosten, Conversions pro Asset. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

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

get_ad_schedule

Lesen1 Credits

Aktueller Werbezeitplan einer Kampagne: Tag, Start-/Endzeit, Gebotsanpassung und Kriteriums-ID pro Zeitfenster. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

get_conversion_tags

Lesen1 Credits

Tag-Details von Conversion-Aktionen: Conversion-ID (AW-…), Label und der send_to-Wert für Tag Manager / gtag sowie die Roh-Snippets. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

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

list_extension_assets

Lesen1 Credits

Mit einer Kampagne oder Anzeigengruppe verknüpfte Erweiterungs-Assets (Sitelinks, Callouts, Anruf, Snippets, Angebote, Preise, WhatsApp, Lead-Formular, App, Unternehmensname/-logo) mit dem Ressourcennamen der Verknüpfung zum Entfernen. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
campaign_idOptionalstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
ad_group_idOptionalstringGoogle Ads-Anzeigengruppen-ID (list_google_ad_groups)
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_conversion_goals

Lesen1 Credits

Conversion-Ziele des Kontos (Kategorie × Quelle) und ob jedes primär/gebotsfähig ist; mit campaign_id auch die Zielüberschreibungen dieser Kampagne. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
campaign_idOptionalstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_custom_conversion_goals

Lesen1 Credits

Benutzerdefinierte Conversion-Ziele: Name, enthaltene Conversion-Aktionen, Status und die Kampagnen, die jeweils darauf optimieren. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

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

budget_pacing_alerts

Lesen2 Credits

Ausgaben seit Monatsbeginn im Vergleich zum Tagesbudget aktiver Kampagnen, hochgerechnet auf das Monatsende; markiert Kampagnen, die das Budget über- oder unterschreiten werden. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
threshold_pctOptionalnumber (1–100)Abweichung, die eine Warnung auslöst, Standard 10
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

impression_share_analysis

Lesen2 Credits

Anteil an möglichen Impressionen im Suchnetzwerk, Anteil oben / ganz oben, Anteil bei exakter Übereinstimmung und wie viel durch Budget bzw. Rang verloren ging, plus abgelehnte Anzeigen pro Kampagne. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

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

list_audiences

Lesen1 Credits

Zielgruppenlisten (Remarketing, regelbasierte Website, Kundenabgleich, Lookalike): ID, Typ, Status, Mitgliedschaftsdauer, Größe für Suche/Display und Berechtigung. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
limitOptionalinteger (1–1000)—
definitionOptionalbooleandie Regel-/Ausgangsdefinition der Liste einbeziehen
searchOptionalstringname contains, or exact list id
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_experiments

Lesen1 Credits

Listet Kampagnentests (A/B-Tests) mit ID, Status und Daten auf. Nur lesend; zum Beenden oder Übernehmen eines Tests manage_experiment verwenden. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
actionOptionallistnur list; zum Beenden oder Übernehmen manage_experiment
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

google_campaign_diagnosis

Lesen2 Credits

LIVE-Statusdiagnose einer Google Ads-Kampagne. Zuerst aufrufen, wenn der Nutzer eine Warnung oder einen Status meldet (falsch konfiguriert, eingeschränkt, nicht aktiv, Lernphase, abgelehnt), und danach zur Überprüfung einer Änderung. Liefert den primären Status mit jedem Grund (Code, Bedeutung, typische Lösung, passende Tools), den Auslieferungsstatus, die Gebotsstrategie mit Ziel-CPA / Ziel-ROAS, das Feld, in dem das Ziel steht, den Systemstatus der Gebotsstrategie (die eigentliche Ursache einer Gebotsfehlkonfiguration), den Zieltyp von App-Kampagnen, Budget und von Google empfohlenes Budget, Start- / Enddatum, die optimierten Conversion-Aktionen mit Status, Befunde, Empfehlungen und letzte Änderungen. Beträge in Kontowährung. Nur lesend. Erfordert ein verbundenes Google Ads-Konto; sonst connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
campaign_idOptionalstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID; ohne Angabe werden alle Kampagnen mit Statusproblem aufgelistet
relatedOptionalbooleanStandard true: auch die Empfehlungen der Kampagne und die Änderungen der letzten 14 Tage
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_ad_policy_issues

Lesen2 Credits

Anzeigen, die Google abgelehnt oder eingeschränkt hat, mit den Richtlinienthemen und dem Belegtext hinter jeder Entscheidung. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
only_problemsOptionalbooleanStandard true: nur abgelehnte / eingeschränkte Anzeigen
limitOptionalinteger (1–1000)—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_lead_form_submissions

Lesen2 Credits

Über Google Ads-Lead-Formulare eingereichte Leads (Name, E-Mail, Telefon und eigene Antworten, Kampagne, Zeit). Personenbezogene Daten — sorgfältig behandeln. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

ParameterTypBeschreibung
daysOptionalinteger (1–90)—
asset_idOptionalstringAsset-ID des Lead-Formulars
limitOptionalinteger (1–1000)—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_location_assets

Lesen1 Credits

Business 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.

Die Beschreibung dieses Tools ist noch nicht übersetzt; gezeigt wird der englische Originaltext, den der Assistent sieht.

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

Schreib-Tools74 Tools

select_google_ads_account

Schreiben1 Credits

Wechselt das Google Ads-Kundenkonto, das alle weiteren Lese- und Schreibvorgänge verwenden (Agentur/MCC: die passende login-customer-id wird automatisch gesetzt). Lokale Einstellung; bei Google ändert sich nichts.

ParameterTypBeschreibung
customer_idPflichtstringKundenkonto-ID aus list_google_ads_accounts

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

apply_google_ads_recommendation

Schreiben2 Credits

Wendet ausgewählte Google Ads-Empfehlungen an (bis zu 100). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_google_search_campaign

Schreiben2 Credits

Erstellt eine Google-Suchkampagne in einem Durchgang: Budget, Kampagne, Standort- + Sprachausrichtung, Gebotsstrategie, Anzeigengruppe, Keywords und responsive Suchanzeige (Texte standardmäßig aus dem Markenprofil). Nach Freigabe als PAUSED erstellt. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

ParameterTypBeschreibung
namePflichtstring—
daily_budgetPflichtnumberKontowährung
locationsOptionalarray<string>Stadt-/Regions-/Ländernamen; Standard: Stadt aus dem Markenprofil
location_idsOptionalarray<string>Google Geo-Target-Konstanten-IDs
countryOptionalstring—
languagesOptionalarray<string>Sprachcodes (tr, en…) oder Google-Sprach-IDs; Standard Türkisch
bid_strategyOptionalmaximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks—
target_cpaOptionalnumber—
target_roasOptionalnumber—
max_cpcOptionalnumber—
cpc_bidOptionalnumberStandard-CPC der Anzeigengruppe
keywordsOptionalarray<any>—
headlinesOptionalarray<any>—
descriptionsOptionalarray<any>—
final_urlOptionalstring—
ad_group_nameOptionalstring—
search_partnersOptionalboolean—
end_dateOptionalstringYYYY-MM-DD
goalOptionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_google_pmax_campaign

Schreiben2 Credits

Erstellt eine Performance Max-Kampagne: Budget + Kampagne + Asset-Gruppe + Text-Assets + Bilder (von den angegebenen URLs heruntergeladen und hochgeladen) in einer atomaren Anfrage, als PAUSED erstellt. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

ParameterTypBeschreibung
namePflichtstring—
daily_budgetPflichtnumber—
final_urlPflichtstring—
business_namePflichtstring≤25 Zeichen
headlinesPflichtarray<string>3-15, ≤30 Zeichen
long_headlinesPflichtarray<string>1-5, ≤90 Zeichen
descriptionsPflichtarray<string>2-5, ≤90 Zeichen
marketing_imagesPflichtarray<string>1.91:1 Querformat, mindestens 1
square_marketing_imagesPflichtarray<string>1:1, mindestens 1
logo_imagesPflichtarray<string>1:1 Logo, mindestens 1
portrait_marketing_imagesOptionalarray<string>Bild-URLs (https) oder Studio-Dateien aus /medya
landscape_logo_imagesOptionalarray<string>Bild-URLs (https) oder Studio-Dateien aus /medya
bid_strategyOptionalmaximize_conversions | maximize_conversion_value—
target_cpaOptionalnumber—
target_roasOptionalnumber—
locationsOptionalarray<string>—
countryOptionalstring—
languagesOptionalarray<string>—
asset_group_nameOptionalstring—
end_dateOptionalstring—
goalOptionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_google_display_campaign

Schreiben2 Credits

Erstellt eine Display-Kampagne: Budget + Kampagne + Anzeigengruppe + responsive Displayanzeige (Bilder werden von den angegebenen URLs geladen, auf das Seitenverhältnis jedes Feldes zugeschnitten und hochgeladen) in einer atomaren Anfrage, als PAUSED. Das Suchnetzwerk ist aus; die Kampagne läuft nur im Displaynetzwerk.

ParameterTypBeschreibung
namePflichtstring—
daily_budgetPflichtnumber—
final_urlPflichtstring—
business_namePflichtstring≤25 Zeichen
headlinesPflichtarray<string>1-5, ≤30 Zeichen
long_headlinePflichtstring≤90 Zeichen
descriptionsPflichtarray<string>1-5, ≤90 Zeichen
marketing_imagesPflichtarray<string>1.91:1 Querformat, mindestens 1
square_marketing_imagesOptionalarray<string>1:1, mindestens 1 (fehlt es, wird aus dem Querformat zugeschnitten)
logo_imagesOptionalarray<string>image URLs (https) or Studio /medya files
landscape_logo_imagesOptionalarray<string>image URLs (https) or Studio /medya files
bid_strategyOptionalmaximize_conversions | target_cpa | maximize_clicks | manual_cpc—
target_cpaOptionalnumber—
max_cpcOptionalnumber—
cpc_bidOptionalnumber—
locationsOptionalarray<string>—
countryOptionalstring—
languagesOptionalarray<string>—
ad_group_nameOptionalstring—
end_dateOptionalstring—
goalOptionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_google_shopping_campaign

Schreiben2 Credits

Erstellt eine Standard-Shopping-Kampagne: Budget + Kampagne + Anzeigengruppe + Produktanzeige in einer atomaren Anfrage, als PAUSED. Die Produkte stammen aus dem verknüpften Merchant-Center-Konto; die Priorität 0-2 entscheidet, welche Kampagne bei gleichem Produkt gewinnt.

ParameterTypBeschreibung
namePflichtstring—
daily_budgetPflichtnumber—
merchant_idPflichtstring—
campaign_priorityOptional0 | 1 | 2—
feed_labelOptionalstring—
enable_localOptionalboolean—
bid_strategyOptionalmanual_cpc | maximize_clicks | target_roas | maximize_conversion_value—
target_roasOptionalnumber—
max_cpcOptionalnumber—
cpc_bidOptionalnumber—
locationsOptionalarray<string>—
countryOptionalstring—
languagesOptionalarray<string>—
ad_group_nameOptionalstring—
end_dateOptionalstring—
goalOptionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

manage_google_conversion_value_rules

Schreiben2 Credits

Passt den Conversion-Wert zur Auktionszeit nach Bedingung an: z. B. zählt eine Conversion vom Mobilgerät 1,2-fach oder aus einer bestimmten Stadt mehr. Eine Bedingung pro Regel (Gerät, Standort oder Zielgruppe); die Regel gehört zu einem Wertregelsatz für das Konto oder eine Kampagne.

ParameterTypBeschreibung
actionOptionalcreate | remove—
operationOptionalADD | MULTIPLY | SET—
valueOptionalnumberfür MULTIPLY 0,5-10; für ADD/SET größer als 0 (in der Kontowährung)
device_typesOptionalarray<string>e.g. MOBILE, DESKTOP, TABLET
geo_target_idsOptionalarray<string>—
geo_match_typeOptionalstring—
user_list_idsOptionalarray<string>—
campaign_idOptionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
resource_nameOptionalstringfor action=remove
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

update_google_campaign

Schreiben2 Credits

Benennt eine Google Ads-Kampagne um, pausiert/aktiviert sie oder setzt/entfernt ihr Enddatum; die Vorschau zeigt aktuell → neu. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
nameOptionalstring—
statusOptionalpause | enable—
end_dateOptionalstring | nullYYYY-MM-DD oder null für unbegrenzte Laufzeit
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

rename_google_campaigns

Schreiben2 Credits

Benennt Google Ads-Kampagnen in Masse um (explizite Liste, Namensmuster oder Suchen/Ersetzen). Die Vorschau ist eine Tabelle alt → neu; Namen müssen eindeutig bleiben. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

ParameterTypBeschreibung
renamesOptionalarray<object>—
campaign_idsOptionalarray<string>—
patternOptionalstringNamensmuster mit {name}, {channel}, {id}, z. B. 'Brand | {channel} | {name}'
findOptionalstring—
replaceOptionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

remove_google_campaign

SchreibenUnumkehrbar2 Credits

Entfernt eine Google Ads-Kampagne DAUERHAFT (nicht rückgängig zu machen oder wieder zu aktivieren; der Verlauf bleibt in Berichten). Nie automatisch angewendet: wartet immer auf die ausdrückliche Freigabe des Nutzers. Im Zweifel update_google_campaign(status=pause) bevorzugen. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

set_google_bid_strategy

Schreiben2 Credits

Stellt die Gebotsstrategie einer Google Ads-Kampagne um: Conversions maximieren (optional Ziel-CPA), Conversion-Wert maximieren (optional Ziel-ROAS), Ziel-CPA, Ziel-ROAS, manueller CPC, Klicks maximieren. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf). Bei App-Kampagnen lässt sich der Strategietyp nicht ändern; nur das Ziel wird aktualisiert (target_cpa = Zielkosten pro Installation / In-App-Aktion oder target_roas). Lesen Sie mit google_campaign_diagnosis die Ursache, bevor Sie ein Ziel ändern, um eine Warnung zu beheben. Der vorherige Wert wird gespeichert und die Änderung ist rückgängig machbar.

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
strategyPflichtmaximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks | target_impression_share—
target_cpaOptionalnumberKontowährung
target_roasOptionalnumberVerhältnis, 4.0 = 400 %
max_cpcOptionalnumberCPC-Obergrenze für maximize_clicks
impression_share_locationOptionalANYWHERE_ON_PAGE | TOP_OF_PAGE | ABSOLUTE_TOP_OF_PAGE—
impression_share_percentOptionalnumber (1–100)—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

set_google_ad_schedule

Schreiben2 Credits

Legt einen Werbezeitplaner für eine Google Ads-Kampagne fest (Tag-/Zeitfenster mit optionaler Gebotsanpassung); außerhalb der Fenster werden keine Anzeigen ausgeliefert. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
replaceOptionalbooleanentfernt zuerst den bestehenden Zeitplan
schedulePflichtarray<object>—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

set_google_location_targets

Schreiben2 Credits

Standorte in einer Google Ads-Kampagne ausrichten oder ausschließen; Namen werden über Googles Geo-Target-Vorschläge aufgelöst und in der Vorschau gezeigt. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
locationsOptionalarray<string>Namen, z. B. İstanbul, Ankara
location_idsOptionalarray<string>—
countryOptionalstringISO-Code als Hinweis, Standard TR
excludeOptionalboolean—
replaceOptionalbooleanentfernt zuerst die bestehenden Zielstandorte
bid_adjustmentOptionalnumberProzent
languagesOptionalarray<string>language codes (tr, en…) or Google language ids to target
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

merge_google_campaigns

SchreibenUnumkehrbar2 Credits

Sichere Kampagnenzusammenführung: pausiert die Quellkampagnen und überträgt ihr Tagesbudget auf das Ziel (Google kann Anzeigengruppen nicht zwischen Kampagnen verschieben). Unterliegt der Budgetschranke (max. +50 % je Änderung); nie automatisch angewendet. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

ParameterTypBeschreibung
target_campaign_idPflichtstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
source_campaign_idsPflichtarray<string>—
move_budgetOptionalbooleanTagesbudgets der Quellen zum Ziel addieren (Standard true)
new_daily_budgetOptionalnumberexplizites Ziel-Tagesbudget statt der Summe
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

exclude_google_ips

Schreiben2 Credits

Schließt IP-Adressen aus einer Google Ads-Kampagne aus (Klickbetrugsschutz; negative IP-Sperre auf Kampagnenebene, max. 500). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
ipsPflichtarray<string>IPv4-/IPv6-Adressen oder CIDR-Blöcke
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

unblock_ip_addresses

Schreiben2 Credits

Entfernt IP-Ausschlüsse aus einer Google Ads-Kampagne (die Umkehrung von exclude_google_ips); nur tatsächlich in der Kampagne ausgeschlossene IPs werden entfernt. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
ipsPflichtarray<string>IPv4/IPv6-Adressen oder CIDR-Blöcke, die nicht mehr ausgeschlossen werden sollen
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_google_ad_group

Schreiben2 Credits

Fügt einer Google Ads-Kampagne eine Such-Anzeigengruppe hinzu, optional mit Keywords und einer responsiven Suchanzeige. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
namePflichtstring—
cpc_bidOptionalnumber—
keywordsOptionalarray<any>—
headlinesOptionalarray<any>—
descriptionsOptionalarray<any>—
final_urlOptionalstring—
path1Optionalstring—
path2Optionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

set_google_ad_group_status

Schreiben2 Credits

Pausiert oder aktiviert Google Ads-Anzeigengruppen. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

pause_google_ad_groups

Schreiben2 Credits

Pausiert mehrere Google Ads-Anzeigengruppen auf einmal (z. B. Gruppen ohne Conversions aus google_ads_report breakdown=ad_group). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

add_google_keywords

Schreiben2 Credits

Fügt einer Google Ads-Anzeigengruppe Keywords hinzu (Text, BROAD|PHRASE|EXACT, optionales CPC-Gebot). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

update_google_keyword

Schreiben2 Credits

Pausiert/aktiviert ein Google Ads-Keyword, ändert sein CPC-Gebot oder seinen Übereinstimmungstyp (Google verlangt Entfernen + Neuanlegen; in einer atomaren Anfrage erledigt). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

remove_google_negative_keywords

SchreibenUnumkehrbar2 Credits

Entfernt auszuschließende Keywords (nach Text, optional Übereinstimmungstyp) aus einer Google Ads-Kampagne oder einer gemeinsamen Ausschlussliste — die Rücknahme eines falschen Ausschlusses. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

add_to_google_shared_negative_list

Schreiben2 Credits

Fügt auszuschließende Keywords (jeweils mit eigenem Übereinstimmungstyp) zu einer kontoweiten gemeinsamen Ausschlussliste hinzu — oder legt eine an — und ordnet sie Kampagnen zu. Vorhandene Begriffe werden übersprungen. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

ParameterTypBeschreibung
list_idOptionalstring—
list_nameOptionalstringlegt eine neue Liste an, wenn list_id fehlt
keywordsPflichtarray<any>—
attach_campaign_idsOptionalarray<string>—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_google_rsa

Schreiben2 Credits

Erstellt eine responsive Suchanzeige (3-15 Anzeigentitel ≤30, 2-4 Beschreibungen ≤90, optionales Anpinnen) in einer Google Ads-Anzeigengruppe. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

ParameterTypBeschreibung
ad_group_idPflichtstring—
headlinesPflichtarray<any>—
descriptionsPflichtarray<any>—
final_urlPflichtstring—
path1Optionalstring—
path2Optionalstring—
final_mobile_urlOptionalstring—
tracking_url_templateOptionalstring—
statusOptionalenable | pause—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

update_google_rsa_assets

Schreiben2 Credits

Erneuert schwache RSA-Anzeigentitel/Beschreibungen: Google erlaubt keine Bearbeitung von RSA-Texten, daher wird in einer Anfrage eine neue Anzeige mit dem neuen Satz erstellt und die alte pausiert. Die Vorschau zeigt alte → neue Texte. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

add_google_callouts

Schreiben2 Credits

Fügt einer Google Ads-Kampagne Zusatzinformations-Assets (≤25 Zeichen) hinzu. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
calloutsPflichtarray<string>jeweils ≤25 Zeichen
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_google_conversion_action

Schreiben2 Credits

Erstellt eine Website-Conversion-Aktion; das Ergebnis enthält das zu installierende Tag-Snippet (z. B. mit den Tag Manager-Tools). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

ParameterTypBeschreibung
namePflichtstring—
categoryOptionalDEFAULT | 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_typeOptionalone | many—
primary_for_goalOptionalboolean—
default_valueOptionalnumber—
currencyOptionalstring—
always_use_default_valueOptionalboolean—
click_through_window_daysOptionalinteger (1–90)—
view_through_window_daysOptionalinteger (1–30)—
phone_call_duration_secondsOptionalinteger (0–10800)—
typeOptionalWEBPAGE | UPLOAD_CLICKS | UPLOAD_CALLS | AD_CALL | WEBSITE_CALL | CLICK_TO_CALLdefault WEBPAGE; UPLOAD_CLICKS for offline conversion upload
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

update_google_conversion_action

Schreiben2 Credits

Ändert eine Google Ads-Conversion-Aktion: primär vs. sekundär (primary_for_goal), Status, Kategorie, Zählung, Werteinstellungen, Klick-Conversion-Fenster. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

ParameterTypBeschreibung
conversion_action_idPflichtstring—
nameOptionalstring—
statusOptionalenable | hide | remove | ENABLED | HIDDEN | REMOVED—
categoryOptionalDEFAULT | 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_typeOptionalone | many—
primary_for_goalOptionalboolean—
default_valueOptionalnumber—
currencyOptionalstring—
always_use_default_valueOptionalboolean—
click_through_window_daysOptionalinteger (1–90)—
view_through_window_daysOptionalinteger (1–30)—
phone_call_duration_secondsOptionalinteger (0–10800)—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

add_google_asset_group_assets

Schreiben2 Credits

Fügt einer Performance Max-Asset-Gruppe in einer atomaren Anfrage Anzeigentitel, lange Anzeigentitel, Beschreibungen und Bilder (von URLs heruntergeladen und hochgeladen) hinzu. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

ParameterTypBeschreibung
asset_group_idPflichtstring—
headlinesOptionalarray<string>—
long_headlinesOptionalarray<string>—
descriptionsOptionalarray<string>—
business_nameOptionalstring—
marketing_imagesOptionalarray<string>Bild-URLs (https) oder Studio-Dateien aus /medya
square_marketing_imagesOptionalarray<string>Bild-URLs (https) oder Studio-Dateien aus /medya
logo_imagesOptionalarray<string>Bild-URLs (https) oder Studio-Dateien aus /medya
portrait_marketing_imagesOptionalarray<string>Bild-URLs (https) oder Studio-Dateien aus /medya
landscape_logo_imagesOptionalarray<string>Bild-URLs (https) oder Studio-Dateien aus /medya
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

upload_google_image_asset

Schreiben2 Credits

Lädt Bilder in die Google Ads-Asset-Bibliothek hoch (assets:mutate, imageAsset); das Ergebnis liefert Asset-Ressourcennamen, die in create_google_demand_gen_campaign / create_google_app_campaign wiederverwendbar sind. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

ParameterTypBeschreibung
imagesPflichtarray<any>https-URLs oder Studio-Dateien aus /medya (JPEG/PNG/GIF, ≤5120 KB), bis zu 20
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_google_demand_gen_campaign

Schreiben2 Credits

Erstellt eine Google Demand Gen-Kampagne (YouTube, Discover, Gmail): Budget + Kampagne (advertising_channel_type DEMAND_GEN) + Anzeigengruppe + Multi-Asset-Anzeige (DemandGenMultiAssetAdInfo: Anzeigentitel, Beschreibungen, Unternehmensname, Logo, Quer-/Quadrat-/Hochformatbilder von URLs hochgeladen oder per Asset-ID verknüpft), optionale Zielgruppen-, Standort- und Sprachausrichtung, Gebote Conversions maximieren / tCPA / tROAS. Nach Freigabe als PAUSED erstellt. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

ParameterTypBeschreibung
namePflichtstring—
daily_budgetPflichtnumberKontowährung
final_urlPflichtstring—
business_namePflichtstring≤25 Zeichen
headlinesPflichtarray<string>1-5, ≤40 Zeichen
descriptionsPflichtarray<string>1-5, ≤90 Zeichen
marketing_imagesOptionalarray<string>1.91:1 Querformat — hochzuladende URLs oder vorhandene Asset-IDs
square_marketing_imagesOptionalarray<string>1:1 — URLs oder Asset-IDs
portrait_marketing_imagesOptionalarray<string>4:5 — URLs oder Asset-IDs
logo_imagesPflichtarray<string>1:1 Logo, mindestens 1 — URLs oder Asset-IDs
call_to_actionOptionalstringz. B. Learn more, Shop now (≤15 Zeichen)
bid_strategyOptionalmaximize_conversions | maximize_conversion_value | target_cpa | target_roas | maximize_clicks—
target_cpaOptionalnumber—
target_roasOptionalnumber—
max_cpcOptionalnumber—
audience_idsOptionalarray<string>Google Ads-Zielgruppen-IDs (Zielgruppenverwaltung) für die Anzeigengruppe; leer = breit
locationsOptionalarray<string>—
location_idsOptionalarray<string>—
countryOptionalstring—
languagesOptionalarray<string>—
ad_group_nameOptionalstring—
end_dateOptionalstringYYYY-MM-DD
goalOptionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_google_app_campaign

Schreiben2 Credits

Erstellt eine Google App-Kampagne (advertising_channel_type MULTI_CHANNEL, Untertyp APP_CAMPAIGN, app_campaign_setting mit App-ID, Store und Gebotsziel): Budget + Kampagne + Anzeigengruppe + App-Anzeige (Text-Assets, optional Bilder/Videos), Ziel-CPI/CPA- oder ROAS-Gebote, Standort-/Sprachausrichtung. Nach Freigabe als PAUSED erstellt; die App muss mit dem Konto verknüpft sein. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

ParameterTypBeschreibung
namePflichtstring—
daily_budgetPflichtnumberKontowährung
app_idPflichtstringnumerische Apple-App-ID (z. B. 284815942) oder Android-Paketname (z. B. com.example.app)
app_storePflichtapple | google—
goalOptionalinstalls | installs_no_target | in_app_actions | in_app_actions_cpa | value | pre_registrationinstalls = Zielkosten pro Installation (Standard); in_app_actions = Installationen mit wahrscheinlicher In-App-Aktion (tCPI); in_app_actions_cpa = Zielkosten pro In-App-Aktion; value = Ziel-ROAS; installs_no_target / pre_registration = maximieren
target_cpaOptionalnumberZielkosten pro Installation / In-App-Aktion
target_roasOptionalnumber—
conversion_action_idsOptionalarray<string>In-App-Conversion-Aktionen für in_app-/value-Ziele (list_google_conversion_actions)
headlinesPflichtarray<string>2-5, ≤30 Zeichen
descriptionsPflichtarray<string>1-5, ≤90 Zeichen
imagesOptionalarray<string>optionale Bild-URLs zum Hochladen oder vorhandene Asset-IDs
video_asset_idsOptionalarray<string>vorhandene YouTube-Video-Asset-IDs
locationsOptionalarray<string>—
location_idsOptionalarray<string>—
countryOptionalstring—
languagesOptionalarray<string>—
ad_group_nameOptionalstring—
end_dateOptionalstringYYYY-MM-DD
goal_noteOptionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

update_google_app_ad

Schreiben2 Credits

Ersetzt Titel und Beschreibungen einer Google-App-Kampagnenanzeige (aktuelle Texte über get_ad_details). Das Ergebnis behält die vorherigen Texte.

ParameterTypBeschreibung
ad_idPflichtstring—
headlinesOptionalarray<string>2-5, up to 30 characters
descriptionsOptionalarray<string>1-5, up to 90 characters
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

google_click_fraud_guard

Schreiben2 Credits

Klickbetrugsschutz: findet Kampagnen mit verdächtigen Raten ungültiger Klicks (oder nimmt campaign_ids entgegen) und schließt die angegebenen IP-Adressen in jeder davon aus (negative IP-Sperre auf Kampagnenebene). Ohne ips werden nur die verdächtigen Kampagnen und Geo-Anomalien gemeldet — die Google Ads API gibt Klicker-IPs nie preis, Ausschlüsse brauchen also selbst ermittelte Adressen. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads erst nach Freigabe und nur mit verbundenem Konto angewendet (sonst Probelauf).

ParameterTypBeschreibung
daysOptionalinteger (1–365)—
start_dateOptionalstringYYYY-MM-DD
end_dateOptionalstringYYYY-MM-DD
threshold_rateOptionalnumber—
campaign_idsOptionalarray<string>explizite Kampagnen; Standard: vom Bericht zu ungültigen Klicks markierte Kampagnen
ipsOptionalarray<string>IPv4-/IPv6-Adressen oder CIDR-Blöcke aus Ihren eigenen Server-/Analytics-Logs
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

upsert_merchant_product

Schreiben2 Credits

Fügt eine Merchant Center-Produkteingabe hinzu oder aktualisiert sie (products v1beta productInputs:insert — ersetzt eine vorhandene Eingabe mit gleicher Angebots-ID, Sprache, Feed-Label und Datenquelle). Erstellt einen Freigabeeintrag mit Vorschau; an Google erst nach Freigabe und nur mit verbundenem Google-Konto gesendet. Nutzt die verbundene Google-Einwilligung; liefert error=scope_missing, wenn der Merchant Center-Bereich (auth/content) fehlt — der Nutzer muss Google neu autorisieren.

ParameterTypBeschreibung
offer_idPflichtstring—
content_languageOptionalstringStandard tr
feed_labelOptionalstringStandard TR
account_idOptionalstringMerchant Center-Konto-ID; optional, wenn der Nutzer ein einziges Konto hat oder eines ausgewählt ist
data_sourceOptionalstringDatenquellen-ID; Standard: die API-/primäre Produktdatenquelle des Kontos
titleOptionalstring—
descriptionOptionalstring—
linkOptionalstring—
image_linkOptionalstring—
priceOptionalnumber—
sale_priceOptionalnumber—
currencyOptionalstringISO, Standard TRY
availabilityOptionalin stock | out of stock | preorder | backorder—
conditionOptionalnew | refurbished | used—
brandOptionalstring—
gtinOptionalstring—
googleProductCategoryOptionalstring—
imageLinkOptionalstringAlias of image_link
channelOptionalONLINE | LOCALdefault ONLINE
attributesOptionalobjectweitere Merchant API-Produktattribute (camelCase), z. B. color, sizes, itemGroupId, customLabel0

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

manage_experiment

SchreibenUnumkehrbar2 Credits

Beendet einen Kampagnentest (A/B-Test) oder überträgt seine Teständerungen auf die Basiskampagne. Nicht umkehrbar; wartet immer auf ausdrückliche Freigabe. Erfordert ein verbundenes Google Ads-Konto; andernfalls connected=false, niemals erfundene Zahlen.

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_demand_gen_ad

Schreiben2 Credits

Fügt einer Demand Gen-Anzeigengruppe eine YouTube-Videoanzeige (DemandGenVideoResponsiveAd) hinzu — das Creative, mit dem eine Demand Gen-Videokampagne ausgeliefert werden kann. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads nach Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst erledigen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

ParameterTypBeschreibung
ad_group_idPflichtstringGoogle Ads-Anzeigengruppen-ID (list_google_ad_groups)
youtube_videoPflichtstringYouTube-URL oder 11-stellige ID oder eine vorhandene Video-Asset-ID
headlinesPflichtarray<string>1-5, ≤40
long_headlinesPflichtarray<string>1-5, ≤90
descriptionsPflichtarray<string>1-5, ≤90
business_namePflichtstring—
final_urlPflichtstring—
logo_asset_idPflichtstring1:1-Logo-Asset-ID oder Bild-URL
call_to_actionOptionalLEARN_MORE | GET_QUOTE | APPLY_NOW | SIGN_UP | CONTACT_US | SUBSCRIBE | DOWNLOAD | BOOK_NOW | SHOP_NOW | BUY_NOW | ORDER_NOW | SEE_MORE | START_NOW | VISIT_SITE | WATCH_NOW—
ad_nameOptionalstring—
statusOptionalenable | pause—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

copy_ad_group

Schreiben2 Credits

Dupliziert Anzeigengruppen mit ihren Keywords, auszuschließenden Keywords, responsiven Suchanzeigen, Anzeigengruppen-Assets und Zielgruppen in einer atomaren Anfrage in eine andere (oder dieselbe) Kampagne; Kopien starten standardmäßig pausiert. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads nach Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst erledigen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

ParameterTypBeschreibung
ad_group_idsPflichtarray<string>—
target_campaign_idPflichtstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
new_nameOptionalstring—
name_suffixOptionalstring—
statusOptionalpause | enableStandard pause
cpc_bidOptionalnumber—
include_keywordsOptionalboolean—
include_negativesOptionalboolean—
include_adsOptionalboolean—
include_assetsOptionalboolean—
include_audiencesOptionalboolean—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

set_ad_group_targeting

Schreiben2 Credits

Standort- und Sprachausrichtung einer Anzeigengruppe (wo Demand Gen sie hält): ausgerichtete / ausgeschlossene Orte und Sprachen hinzufügen oder ersetzen. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

update_ad_group

Schreiben2 Credits

Benennt eine Google Ads-Anzeigengruppe um, ändert ihren Standard-max.-CPC und/oder pausiert/aktiviert sie. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

ParameterTypBeschreibung
ad_group_idPflichtstringGoogle Ads-Anzeigengruppen-ID (list_google_ad_groups)
nameOptionalstring—
cpc_bidOptionalnumber—
statusOptionalpause | enable—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

update_ad_status

SchreibenUnumkehrbar2 Credits

Aktiviert, pausiert oder entfernt eine einzelne Google Ads-Anzeige dauerhaft. REMOVED kann nicht rückgängig gemacht werden und wartet immer auf ausdrückliche Freigabe. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

ParameterTypBeschreibung
ad_group_idPflichtstringGoogle Ads-Anzeigengruppen-ID (list_google_ad_groups)
ad_idPflichtstring—
statusPflichtENABLED | PAUSED | REMOVED—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

update_pmax_assets

Schreiben2 Credits

Fügt Text-Assets einer Performance Max-Asset-Gruppe in einer Anfrage hinzu und entfernt sie (Bilder: add_google_asset_group_assets). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

ParameterTypBeschreibung
asset_group_idPflichtstring—
headlinesOptionalarray<string>—
long_headlinesOptionalarray<string>—
descriptionsOptionalarray<string>—
remove_resource_namesOptionalarray<string>Asset-Gruppen-Asset-Verknüpfungen aus list_google_asset_groups
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

update_rsa

Schreiben2 Credits

Bearbeitet eine responsive Suchanzeige direkt (gleiche Anzeigen-ID, Verlauf bleibt): den ganzen Satz ersetzen oder einzelne Anzeigentitel/Beschreibungen hinzufügen/entfernen, Fixierungen, finale URL und Pfade ändern. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

ParameterTypBeschreibung
ad_idPflichtstring—
headlinesOptionalarray<any>—
descriptionsOptionalarray<any>—
add_headlinesOptionalarray<any>—
remove_headlinesOptionalarray<string>—
add_descriptionsOptionalarray<any>—
remove_descriptionsOptionalarray<string>—
headline_pinsOptionalobject{Text: Fixierungsfeld} — leere Zeichenfolge hebt die Fixierung auf
description_pinsOptionalobject{Text: Fixierungsfeld} — leere Zeichenfolge hebt die Fixierung auf
final_urlOptionalstring—
path1Optionalstring—
path2Optionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

add_negative_keyword

Schreiben2 Credits

Fügt auf Kampagnen- oder Anzeigengruppenebene ein oder mehrere auszuschließende Keywords hinzu (jeweils mit eigener Übereinstimmungsart); vorhandene werden übersprungen. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads nach Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst erledigen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

ParameterTypBeschreibung
campaign_idOptionalstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
ad_group_idOptionalstringGoogle Ads-Anzeigengruppen-ID (list_google_ad_groups)
textOptionalstring—
keywordsOptionalarray<any>—
match_typeOptionalBROAD | PHRASE | EXACT—
skip_existingOptionalbooleanStandard true
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

manage_keywords

SchreibenUnumkehrbar2 Credits

Pausiert / aktiviert / entfernt bestehende Keywords dauerhaft in großer Zahl oder legt ihren max. CPC bzw. finale URLs auf Keyword-Ebene fest. remove wartet auf ausdrückliche Freigabe. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

ParameterTypBeschreibung
ad_group_idPflichtstringGoogle Ads-Anzeigengruppen-ID (list_google_ad_groups)
criterion_idsPflichtarray<string>—
actionPflichtpause | enable | remove | set_bid | set_url—
cpc_bidOptionalnumber—
final_urlOptionalstring—
final_mobile_urlOptionalstring—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

manage_shared_negative_list

SchreibenUnumkehrbar2 Credits

Verwaltet geteilte Listen auszuschließender Keywords auf Kontoebene: erstellen, Keywords hinzufügen/entfernen, Kampagnen zuordnen oder lösen, umbenennen, löschen (Löschen wartet auf ausdrückliche Freigabe). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

dismiss_recommendations

Schreiben2 Credits

Verwirft Google Ads-Empfehlungen, die Sie nicht möchten. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads nach Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst erledigen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

manage_extension_assets

Schreiben2 Credits

Fügt einer Kampagne (oder einer Anzeigengruppe) in einer atomaren Anfrage Erweiterungs-Assets hinzu: Sitelinks, Zusatzinformationen, Snippet mit Zusatzinformationen, Anruf, WhatsApp-Nachricht, Angebote und eine Preisliste. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

remove_extension_assets

SchreibenUnumkehrbar2 Credits

Löst Erweiterungs-Assets von einer Kampagne oder Anzeigengruppe (die Assets bleiben in der Bibliothek und können erneut verknüpft werden). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

ParameterTypBeschreibung
resource_namesOptionalarray<string>Verknüpfungs-Ressourcennamen aus list_extension_assets
campaign_idOptionalstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
field_typeOptionalSITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | BUSINESS_MESSAGE | MOBILE_APP | HOTEL_CALLOUT | LEAD_FORM | BUSINESS_NAME | BUSINESS_LOGO | AD_IMAGEmit campaign_id: entfernt jede Verknüpfung dieses Typs
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

manage_portfolio_bidding_strategy

Schreiben2 Credits

Portfolio-(geteilte) Gebotsstrategien: auflisten, eine erstellen, ihre Ziele ändern oder eine Kampagne daran anhängen. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

manage_google_bidding_periods

Schreiben2 Credits

Teilt Smart Bidding einen kurzen Zeitraum im Voraus mit: eine Saisonalitätsanpassung für eine Aktion oder einen Launch (erwarteter Conversion-Rate-Faktor) oder einen Datenausschluss für Tage mit defekter Messung (Website offline, Tag fehlte) – diese Tage fließen nicht in das Gebotslernen ein. Vorhandene mit google_ads_query lesen. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

ParameterTypBeschreibung
actionOptionalcreate | remove—
typePflichtseasonality | data_exclusion—
nameOptionalstring—
scopeOptionalCAMPAIGN | CHANNEL—
campaign_idsOptionalarray<string>—
channel_typesOptionalarray<string>—
devicesOptionalarray<string>—
start_date_timeOptionalstringJJJJ-MM-TT oder JJJJ-MM-TT HH:MM:SS, in der Zeitzone des Kontos
end_date_timeOptionalstringJJJJ-MM-TT oder JJJJ-MM-TT HH:MM:SS, in der Zeitzone des Kontos
conversion_rate_modifierOptionalnumber (0.1–10)nur Saisonalitätsanpassung: 1,2 = 20 % mehr Conversions erwartet
resource_nameOptionalstringfor action=remove
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

manage_recommendation_auto_apply

Schreiben2 Credits

Zeigt und schaltet die automatische Anwendung von Google-Empfehlungen je Typ. Das Einschalten wartet immer auf ausdrückliche Freigabe, weil Google das Konto danach selbstständig ändert. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

update_conversion_goal

Schreiben2 Credits

Macht ein Conversion-Ziel (Kategorie × Quelle) für das Konto oder eine Kampagne primär oder sekundär — also das, worauf Smart Bidding optimiert. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

ParameterTypBeschreibung
categoryPflichtDEFAULT | 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—
originOptionalWEBSITE | GOOGLE_HOSTED | APP | CALL_FROM_ADS | STORE | YOUTUBE_HOSTED | LOCAL_SERVICES_ADS—
rolePflichtprimary | secondary—
campaign_idOptionalstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

update_custom_conversion_goal

SchreibenUnumkehrbar2 Credits

Erstellt, bearbeitet (enthaltene Aktionen, Name) oder löscht ein benutzerdefiniertes Conversion-Ziel; Löschen wartet auf ausdrückliche Freigabe. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

ParameterTypBeschreibung
goal_idOptionalstringweglassen, um ein neues Ziel zu erstellen
conversion_actionsOptionalarray<string>—
nameOptionalstring—
removeOptionalboolean—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

upload_offline_conversions

Schreiben2 Credits

Lädt Offline-(CRM-)Conversions per Klick-ID (gclid/gbraid/wbraid) oder gehashter E-Mail/Telefonnummer hoch (erweiterte Conversions für Leads); E-Mails/Telefonnummern werden vor jeder Speicherung per SHA-256 gehasht. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

ParameterTypBeschreibung
conversion_actionPflichtstringID einer Conversion-Aktion vom Typ UPLOAD_CLICKS
currency_codeOptionalstring—
conversionsPflichtarray<object>—
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

upload_conversion_adjustments

Schreiben2 Credits

Zieht bereits gemeldete Conversions zurück (Erstattung/Stornierung) oder korrigiert ihren Wert, nach Bestell-ID oder gclid + Zeit. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_customer_match_audience

Schreiben2 Credits

Erstellt eine leere Kundenabgleich-Liste (Customer Match, First-Party-Daten). Mitglieder werden über Googles eigene Upload-Wege hinzugefügt; dieses Tool lädt niemals personenbezogene Daten hoch. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads nach Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst erledigen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

set_google_campaign_locations

Schreiben2 Credits

Show 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.

Die Beschreibung dieses Tools ist noch nicht übersetzt; gezeigt wird der englische Originaltext, den der Assistent sieht.

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
label_filtersOptionalarray<string>Business Profile labels (OR)
listing_idsOptionalarray<string>Business Profile listing ids (OR)
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

remove_google_audience

SchreibenUnumkehrbar2 Credits

Permanently 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.

Die Beschreibung dieses Tools ist noch nicht übersetzt; gezeigt wird der englische Originaltext, den der Assistent sieht.

ParameterTypBeschreibung
user_list_idPflichtstringaudience (user list) id from list_audiences
nameOptionalstringlist name, shown in the approval
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_lookalike_audience

Schreiben2 Credits

Erstellt aus Ausgangslisten eine Lookalike-Zielgruppe (Demand Gen) für die angegebenen Länder und Reichweitenstufe. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads nach Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst erledigen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_website_audience

Schreiben2 Credits

Erstellt eine regelbasierte Remarketing-Liste aus Website-Besuchern, deren Seiten-URL übereinstimmt (erfordert das Google-Tag auf der Website); frühere Besucher werden vorab übernommen. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads nach Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst erledigen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

manage_audience_targeting

Schreiben2 Credits

Verknüpft eine Zielgruppenliste mit einer Kampagne oder Anzeigengruppe (oder entfernt sie) und legt optional Beobachtung vs. Ausrichtung sowie einen Gebotsfaktor fest. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

ParameterTypBeschreibung
audiencePflichtstringNutzerlisten-ID (list_audiences)
campaign_idOptionalstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
ad_group_idOptionalstringGoogle Ads-Anzeigengruppen-ID (list_google_ad_groups)
actionOptionaladd | remove—
modeOptionalobservation | targeting—
bid_modifierOptionalnumberFaktor, 1.2 = +20 %
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

manage_campaign_settings

Schreiben2 Credits

Liest Kampagneneinstellungen (ohne weiteres Argument) oder ändert sie: Standortoption Anwesenheit vs. Interesse, Suchnetzwerk-Partner, Display-Erweiterung, Tracking-Vorlage, EU-Erklärung zu politischer Werbung, AI Max for Search. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
geo_target_typeOptionalPRESENCE | PRESENCE_OR_INTEREST—
search_partnersOptionalboolean—
display_expansionOptionalboolean—
tracking_url_templateOptionalstring—
eu_political_adsOptionalboolean—
ai_maxOptionalbooleanAI Max for Search
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_google_ads_account

SchreibenUnumkehrbar2 Credits

Eröffnet ein neues Kundenkonto unter einem Verwaltungskonto (MCC), das der verbundene Nutzer verwaltet. Wartet immer auf ausdrückliche Freigabe; Währung und Zeitzone sind dauerhaft. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads nach Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst erledigen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

ParameterTypBeschreibung
manager_customer_idPflichtstring—
namePflichtstring—
currency_codePflichtstring—
time_zonePflichtstring—
tracking_url_templateOptionalstring—

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

create_lead_form

Schreiben2 Credits

Erstellt ein Lead-Formular-Asset (das Formular in der Anzeige) mit Standardfeldern, eigenen Fragen, Dankesbildschirm und optionaler Webhook-Zustellung und ordnet es einer Kampagne oder Anzeigengruppe zu. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); in Google Ads nach Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst erledigen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

ParameterTypBeschreibung
business_namePflichtstring—
headlinePflichtstring—
descriptionPflichtstring—
privacy_policy_urlPflichtstring—
final_urlPflichtstring—
ctaOptionalLEARN_MORE | GET_QUOTE | APPLY_NOW | SIGN_UP | CONTACT_US | SUBSCRIBE | DOWNLOAD | BOOK_NOW | GET_OFFER | REGISTER | GET_INFO | REQUEST_DEMO | JOIN_NOW | GET_STARTED—
cta_descriptionOptionalstring—
fieldsOptionalarray<FULL_NAME | FIRST_NAME | LAST_NAME | EMAIL | PHONE_NUMBER | POSTAL_CODE | STREET_ADDRESS | CITY | REGION | COUNTRY | WORK_EMAIL | COMPANY_NAME | WORK_PHONE | JOB_TITLE>—
questionsOptionalarray<any>—
post_submit_headlineOptionalstring—
post_submit_descriptionOptionalstring—
post_submit_ctaOptionalVISIT_SITE | DOWNLOAD | LEARN_MORE | SHOP_NOW—
webhook_urlOptionalstring—
webhook_keyOptionalstring—
campaign_idOptionalstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
ad_group_idOptionalstringGoogle Ads-Anzeigengruppen-ID (list_google_ad_groups)
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

manage_business_name

Schreiben2 Credits

Legt den Unternehmensnamen fest, der in den Anzeigen einer Kampagne angezeigt wird, oder korrigiert ihn. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
textPflichtstring≤25 Zeichen
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

manage_campaign_proximity

Schreiben2 Credits

Listet, ergänzt oder entfernt Umkreis-Ausrichtungen (Breiten-/Längengrad-Kreis) einer Kampagne. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

manage_device_targeting

Schreiben2 Credits

Legt die Gebotsanpassung einer Kampagne für ein Gerät fest (oder -100 %, um dort nicht mehr auszuliefern). Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

ParameterTypBeschreibung
campaign_idPflichtstringTecrübe-Kampagnen-ID (list_campaigns) oder Google Ads-Kampagnen-ID
devicePflichtMOBILE | DESKTOP | TABLET | CONNECTED_TV—
bid_modifier_pctPflichtnumber-90..900 oder -100 zum Ausschließen
customer_idOptionalstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

set_call_reporting

Schreiben2 Credits

Schaltet Anrufberichte und Berichte zu Anruf-Conversions auf Kontoebene ein/aus und wählt die Anruf-Conversion-Aktion. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.

update_pmax_asset_group

SchreibenUnumkehrbar2 Credits

Ändert finale URL, Name, Anzeigepfade oder Status einer Performance Max-Asset-Gruppe; REMOVED ist dauerhaft und wartet auf ausdrückliche Freigabe. Erstellt einen Freigabeeintrag mit Vorschau (aktuell → neu); wird in Google Ads nach der Freigabe durch den Nutzer angewendet (sofort nur, wenn die Freigaberichtlinie des Kontos für diese Art ausdrücklich 'selbst ausführen' lautet) und nur mit verbundenem Konto (sonst Probelauf).

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

Schreib-Tool: Der Aufruf erzeugt zuerst eine Vorschau; die Änderung erreicht die Plattform erst nach Ihrer Freigabe.