Versionshinweise

Eine aktuelle Liste der aktuellen und geplanten Feature-Einstellung finden Sie unter Einstellung von Funktionen.

Haupt- und Nebenversionen von v24

Die Google Ads API v24 enthält die folgenden neuen Funktionen, Updates und Änderungen, die zu Inkompatibilitäten führen können.

Version 24.2 (24.06.2026)

In der Google Ads API v24.2 wurden die folgenden neuen Funktionen und Aktualisierungen hinzugefügt. Nebenversionen wie v24.2 enthalten keine funktionsgefährdenden Änderungen.

Funktionen und Updates Typ Beschreibung
Anzeigen
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT Neuer Enum-Wert Generiert Textinformationen von der Landingpage, die im Engagement-Bereich für DemandGenVideoResponsiveAd-Instanzen angezeigt werden sollen (die ab dieser API-Version standardmäßig aktiviert sind).
Assets
AssetGroup.google_local_services_info Neues Feld Unterstützung für Informationen zu Google Lokale Dienstleistungen (Kategorie-ID und Zusatzinformationen) in Performance Max-Kampagnen hinzugefügt.
AssetGroupSignal.local_services_id Neues Feld Unterstützung für Dienst-ID-Signale für Anzeigen für lokale Dienstleistungen in Performance Max-Kampagnen hinzugefügt.
AssetGroupSignal.vertical_ads_item_group_rule_list Neues Feld Unterstützung für Regeln für Artikelgruppen für vertikale Anzeigen hinzugefügt, um Artikel aus angehängten vertikalen Feeds in Performance Max-Kampagnen auszuwählen. Diese Funktion ist nur für Konten auf der Zulassungsliste verfügbar.
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN Neuer Enum-Wert / Fehler Wird zurückgegeben, wenn versucht wird, alle Asset-Gruppen aus einer Kampagne zu entfernen.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS Neuer Enum-Wert / Fehler Wird zurückgegeben, wenn versucht wird, alle Signale aus einer Asset-Gruppe zu entfernen.
Kampagnen
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings
Campaign.PmaxCampaignSettings.local_services_enabled		 Neue Felder Unterstützung bei der Identifizierung von Performance Max-Kampagnen für Google Lokale Dienstleistungen
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps Neues Feld Google Maps ist in den auswählbaren Kanälen für Demand Gen-Anzeigengruppen enthalten.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN Neuer Enum-Wert / Fehler Wird zurückgegeben, wenn versucht wird, alle Standorte aus einer Performance Max-Kampagne für lokale Dienstleistungen zu entfernen.
SmartCampaignErrorEnum.CREATION_FAILED Neuer Enum-Wert / Fehler Wird zurückgegeben, wenn versucht wird, neue smarte Kampagnen zu erstellen.
Conversions
ConversionOrigin.LOCAL_SERVICES_ADS
ConversionActionType.LOCAL_SERVICES_ADS		 Neue Enum-Werte Stellen Conversions dar, die erfolgen, wenn ein Nutzer auf eine Anzeige für lokale Dienstleistungen klickt und den Werbetreibenden anruft, ihm eine Nachricht sendet oder ihn bucht.
Tests
COMPARE_CAMPAIGNS
PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION		 Neue Enum-Werte Unterstützung für neue ExperimentType-Typen hinzugefügt:
  • COMPARE_CAMPAIGNS: Für Tests zum Kampagnenmix und benutzerdefinierte Performance Max-Tests, bei denen mehrere Kampagnen desselben oder verschiedener Typen in einem einzigen Test verglichen werden.
  • PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION: Für Tests zur Optimierung von Performance Max-Kampagnen für die Textanpassung und die Erweiterung der finalen URL.
Allgemein
Asset.synthetic_content_info
Ad.synthetic_content_info		 Neue Felder Sie enthalten Bestätigungen für synthetische/KI-generierte Inhalte, unterteilt in advertiser_input (direkt vom Werbetreibenden bereitgestellte Erklärungen) und system_input (automatisch erkannte oder vom System bereitgestellte Bestätigungen).

Diese Funktion wurde auf Version 23 und Version 22 zurückportiert.

Damit Sie Ihre bevorstehende Integrationsarbeit für Version 25 besser planen können, wird die Schnittstelle zum Ändern von Attestierungsfeldern für Werbetreibende bereits für Version 22 und höher eingeführt. Die Benutzeroberfläche ist in diesen Versionen sichtbar, aber synthetic_content_info.advertiser_attestation.status und synthetic_content_info.advertiser_attestation.source bleiben für diese Versionen unverändert.

Wenn Sie versuchen, eine Mutationsanfrage für eines dieser Felder zu senden, wird einer der folgenden Fehler zurückgegeben:

„The field attempted to be mutated is immutable“ (Das Feld, das geändert werden sollte, ist unveränderlich) oder „Field cannot be set“ (Feld kann nicht festgelegt werden).

Ab Version 25 können diese Felder vollständig geändert werden. Wir empfehlen, die Schnittstelle jetzt zu verwenden, um Ihre interne Logik zu entwickeln und zu testen, damit Ihr System bereit für vollständige Schreibfunktionen ist, wenn Version 25 eingeführt wird.
Autorisierung durch mehrere Parteien Neue Funktionen Unterstützung für MPA-Überprüfungen (Multi-Party Authorization) hinzugefügt:
Diese Funktion wurde auf v23.3, v22.2 und v21.2 zurückportiert.
IncentiveService.FetchIncentive Verhaltensänderung Wenn in der Anfrage eine ungültige E-Mail-Adresse angegeben wird, gibt die Methode jetzt stattdessen die Standardangebote für Anreize zurück, anstatt einen AuthenticationError.INVALID_EMAIL_ADDRESS-Fehler auszugeben.
Planung
GenerateCreatorInsightsRequest.search_topics Neues Feld Dem Dienst ContentCreatorInsightsService.GenerateCreatorInsights hinzugefügt. Bei dieser Option wird nach Creatorn gesucht, die über ein Thema im Land sprechen, das in country_locations angegeben ist. Es kann nur nach einem Land gesucht werden.
CREATOR_TOPIC_INSIGHTS Neuer Enum-Wert Wird InsightsKnowledgeGraphEntityCapabilities hinzugefügt, um Entitäten für die Suche nach Creatorn zu kennzeichnen, die über ein Thema sprechen. Diese Rechtssubjekte sollten im Feld search_topics verwendet werden. Abgerufen mit AudienceInsightsService.ListAudienceInsightsAttributes.
KnowledgeGraphEntitySearchOptions Neuer Typ / neue Optionen Enthält zusätzliche Suchoptionen für Themen in ListAudienceInsightsAttributes, einschließlich Optionen zum Abrufen aller Themen, die als Creator-Attribute unterstützt werden, und zum Filtern nach Funktionen.
GenerateCreatorInsightsRequest.supplemental_data
GenerateTrendingInsightsRequest.supplemental_data		 Neue Felder Optionale Eingaben für die ContentCreatorInsightsService-Methoden. Wenn Sie dieses Feld angeben, werden zusätzliche Standorte oder Erstellerattribute in der Antwort ausgegeben.
local_creator_insights
related_local_creators		 Neue Felder Wird ausgefüllt, wenn supplemental_data die Enumeration LOCAL_CREATOR_DATA enthält. Hier werden lokale Creator angezeigt, die im ausgewählten Land angesehen wurden oder dort ansässig sind und der Weitergabe von Standortdaten zugestimmt haben.
GenerateTrendingInsightsRequest.sub_country_locations Neues Feld ContentCreatorInsightsService.GenerateTrendingInsights wurde hinzugefügt. Damit können Sie nach Trendstatistiken suchen, indem Sie den Standort des Landes und untergeordneter Standorte angeben.
Berichte
PerformanceMaxPlacementView Segmenterweiterung Segmentierbar gemacht durch ad_network_type.
Shopping
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads Neues Feld Wenn der Wert „true“ ist, werden Markenausschlüsse für Shopping-Anzeigen ignoriert. Wird nur für Shopping-Kampagnen unterstützt.
Targeting
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE Neuer Enum-Wert / Fehler Wird zurückgegeben, wenn versucht wird, eine nicht zulässige Sprache auszurichten.
Videos
DataLink.youtube_link_metadata Neues Feld Enthält brand_channel_id, um die ID des verknüpften YouTube-Markenkanals anzugeben.

Version 24.1 (13.05.2026)

In der Google Ads API v24.1 wurden die folgenden neuen Funktionen und Aktualisierungen hinzugefügt. Nebenversionen wie v24.1 enthalten keine funktionsgefährdenden Änderungen.

Funktionen und Updates Typ Beschreibung
Anzeigen
DemandGenMultiAssetAdInfo.classic_display_images Neues Feld Benutzerdefinierte hochgeladene Displaybilder werden ohne zusätzliche responsive Assets ausgeliefert.
Tests
ADOPT_AI_MAX
ADOPT_BROAD_MATCH_KEYWORDS
OPTIMIZE_ASSETS
PMAX_REPLACEMENT_SHOPPING		 Neue Enum-Werte Unterstützung für neue ExperimentType-Typen hinzugefügt:
  • ADOPT_AI_MAX: Für Tests, mit denen Sie herausfinden können, ob Sie mit AI Max mehr Nutzer mithilfe von Google AI und weitgehend passenden Keywords ansprechen können.
  • ADOPT_BROAD_MATCH_KEYWORDS: Für Tests, mit denen untersucht wird, wie sich weitgehend passende Keywords auf die Anzahl der Suchanfragen auswirken, bei denen Ihre Anzeigen ausgeliefert werden.
  • OPTIMIZE_ASSETS: Für benutzerdefinierte Tests zur Optimierung von Assets.
  • PMAX_REPLACEMENT_SHOPPING: Für Tests, in denen die Leistung Ihrer Shopping-Kampagnen mit der von Performance Max-Kampagnen verglichen wird.
Experiment.video_experiment Neues Feld Unterstützung bei der Konfiguration für bestehende YOUTUBE_CUSTOM-Tests mit Videokampagnen.
ExperimentArm.asset_testing_info
ExperimentArm.asset_groups
ExperimentArm.performance_max_experiment_arm_info		 Neue Felder Felder für Asset-Tests, Asset-Gruppen und Performance Max-Einstellungen in Testgruppen:
  • asset_testing_info: Details zu Assets, die mit den Testkopien von Anzeigen verknüpft sind.
  • asset_groups: Liste der Asset-Gruppen im Testlauf für Optimize Assets-Tests.
  • performance_max_experiment_arm_info: Einstellungen für Performance Max-Kampagnen in PMAX_REPLACEMENT_SHOPPING-Tests.
Allgemein
CustomerUserAccess.passkey_enabled Neues Feld Schreibgeschütztes Feld, das angibt, ob der Nutzer einen Passkey aktiviert hat.
Berichte
mobile_device_platform Neues Segment Ermöglicht das Segmentieren von Berichten nach der Plattform des Nutzergeräts (z. B. iOS oder Android).
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED Neuer Enum-Wert / Fehler Wird zurückgegeben, wenn die angeforderte tägliche, stündliche oder wöchentliche Zeitgranularität für Abfragezeiträume nicht unterstützt wird (nur für die letzten 37 Monate verfügbar).
vertical_ads_listing_user_rating
vertical_ads_listing_venue		 Neue Segmente Neue Segmente für branchenspezifische Anzeigen
user_rating, venue, event_participant_display_name Neue Filterkriterien Unterstützte Filter in VerticalAdsItemGroupRuleInfo für die Ressource SharedCriterion
Messwerte für Kontroll-/Testgruppen Neue Felder Es wurden Kontrollwerte (control_clicks usw.), Behandlungswerte (clicks usw.), Punktschätzungen (clicks_point_estimate usw.), Fehlermargen (clicks_margin_of_error usw.) und p-Werte (clicks_p_value usw.) für sieben wichtigen Messwertfamilien (Klicks, Impressionen, Kosten, Conversions, Cost-per-Conversion, Conversion-Wert, Conversion-Wert pro Kosten) hinzugefügt.
Messwerte für die absolute Änderung von Conversions Neue Felder Unterstützung für Conversions-Schätzungen der absoluten Differenz mit Feldern für Punktschätzung, Schwankungsintervall und p-Wert.
Targeting
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS Neuer Enum-Wert / Fehler Wird zurückgegeben, wenn versucht wird, alle demografischen Zielgruppen auszuschließen.
Videos
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR Neuer Enum-Wert ZEFR wurde als Drittanbieter für die Sichtbarkeitsintegration veröffentlicht.
DataLink.youtube_video.channel_id Neues Feld Gibt die YouTube-Kanal-ID zurück, die mit der Datenverknüpfung verknüpft ist.

Version 24 (22.04.2026)

In der Google Ads API v24, einem wichtigen Release, wurden die folgenden neuen Funktionen, Updates und funktionsgefährdenden Änderungen hinzugefügt.

Eine Anleitung finden Sie unter Upgrade auf die neueste Version durchführen.

Wichtige Änderungen

Ausgangsstatus Neuer Status Art der Änderung Implementierungsleitfaden
Anzeigen
Optional: videos und logo_images in DemandGenVideoResponsiveAdInfo Pflichtfelder Verhaltensänderung Geben Sie beim Erstellen oder Ändern responsiver Demand Gen-Videoanzeigen videos und logo_images an.
Optional: videos, business_name und logo_images in VideoResponsiveAdInfo Pflichtfelder Verhaltensänderung Geben Sie videos, business_name und logo_images an, wenn Sie responsive Videoanzeigen erstellen oder ändern. VideoResponsiveAdInfo kann jetzt geändert werden.
Kampagnen
Campaign.video_brand_safety_suitability Keine Entfernung Die Eignungseinstellung auf Kampagnenebene wurde entfernt. Die Markensicherheit ist weiterhin auf Kundenebene verfügbar. Verwenden Sie stattdessen Customer.video_brand_safety_suitability.
Conversions
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS Keine Entfernung Die Nutzerkategorie „Registrierungen für Treuepunkte“ wurde entfernt. Entfernen Sie Codeverweise darauf.
Planung
InsightsAudienceAttributeGroup-Typ für topic_audience_combinations common.InsightsAudienceAttributeGroup Typ Verhaltensänderung / Typänderung Integrationen mit typisierten Clientbibliotheken müssen aktualisiert werden, damit die neuen Ressourcennamespaces verwendet werden.
Feld youtube_select_lineups in ReachPlanService.ListPlannableProducts Keine Entfernung Zu Playlists von youtube_select_lineup_targeting wechseln
Feld is_brand_connect_creator in ContentCreatorInsightsService.GenerateCreatorInsights und GenerateTrendingInsights Keine Entfernung Prüfe stattdessen, ob ein Creator CREATOR_PARTNERSHIPS in partnership_opportunities anbietet.
geo_modifiers und biddable_keywords in KeywordPlanIdeaService.GenerateKeywordForecastMetrics geo_target_constants und keywords Umbenennen / Entfernen Ersetzt durch CampaignToForecast.geo_target_constants[] und ForecastAdGroup.keywords[].
Nicht mehr unterstützte Felder für Keyword-Pläne und ‑Prognosen in GenerateKeywordForecastMetrics Keine Entfernung Die folgenden Plan-/Prognosefelder und ‑typen wurden entfernt: Aktualisieren Sie die Integrationen entsprechend.
Berichte
ad_sub_network_type-Segment in campaign_budget Keine Entfernung Das Segment ad_sub_network_type wurde für die Ressource campaign_budget entfernt.
click_type-Segment in Asset-Ansichten Keine Entfernung Das Segment wurde aus den Ansichten AdGroupAsset, CampaignAsset und CustomerAsset entfernt.
Videos
Teilweise fehlgeschlagene Vorgänge in ShareablePreviewService.GenerateShareablePreviews zulässig Kein teilweiser Fehler Verhaltensänderung Anfragen schlagen fehl und geben einen Fehler aus, wenn eine ID darin die Validierung nicht besteht.
ShareablePreviewError-Legacy-Codes: MutateErrorEnum.RESOURCE_NOT_FOUND
ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST		 Umbenennung / Verhaltensänderung Fehlercodes, die für Asset-Gruppen zurückgegeben werden, wurden so geändert, dass sie mit Anzeigenfehlern in Anzeigengruppen übereinstimmen. Die Logik für das Abfangen von Validierungsfehlern wurde aktualisiert.

Funktionen und Updates (nicht abwärtsinkompatibel)

Funktionen und Updates Typ Beschreibung
Anzeigen
Veränderlichkeit von VideoResponsiveAdInfo Verhaltensänderung Informationsobjekte für responsive Videoanzeigen können jetzt geändert werden.
Assets
travel_feed_data in AssetSet Neues Feld Es wurden Attribute zum Abrufen von Reisefeed-Assets hinzugefügt (hotel_center_account_id, merchant_center_id, partner_center_id, subset_id, travel_feed_vertical_type).
Kampagnen
Campaign.view_through_conversion_optimization_enabled Neues Feld Ermöglicht die Aktivierung der View-through-Conversion-Optimierung (VTC-Optimierung) (Standard false) in Demand Gen- und App-Kampagnen.
CampaignCriterion.gender Neue Funktion Geschlechtsausschlüsse für Performance Max-Kampagnen in allen Google Ads API-Versionen aktiviert.
Conversions
Conversion-Typen für die Lead-Generierung Neue Enum-Werte In ConversionActionType wurden neue GA4-/Firebase-Conversion-Aktionstyp-Enums hinzugefügt:
  • GOOGLE_ANALYTICS_4_GENERATE_LEAD
  • GOOGLE_ANALYTICS_4_QUALIFY_LEAD
  • GOOGLE_ANALYTICS_4_CLOSE_CONVERT_LEAD
  • FIREBASE_ANDROID_GENERATE_LEAD
  • FIREBASE_ANDROID_QUALIFY_LEAD
  • FIREBASE_ANDROID_CLOSE_CONVERT_LEAD
  • FIREBASE_IOS_GENERATE_LEAD
  • FIREBASE_IOS_QUALIFY_LEAD
  • FIREBASE_IOS_CLOSE_CONVERT_LEAD
Allgemein
UserListErrorEnum.DUPLICATE_LOOKALIKE Neuer Enum-Wert / Fehler Wird zurückgegeben, wenn versucht wird, mehrere identische Lookalike-Listen zu erstellen.
Planung
ProductCoreAttributes-Felder in ListPlannableProductsResponse Neue Felder Unter ListPlannableProductsResponse wurde ProductCoreAttributes um eine planbare Produktbeschreibung, ein Marketingziel, ein Kostenmodell und eine Kaufmethode ergänzt.
Berichte
CartDataSalesView Neue Berichtsressource Hier werden Berichte mit Conversion-Messwerten nach dem verkauften Produkt (Marke usw.) zusätzlich zum angeklickten Produkt angezeigt.
Nicht gebotsfähige Messwerte Neue Felder Allen entsprechenden Ressourcen wurden nicht gebotsfähige Messwerte hinzugefügt. Diese Messwerte zeigen Conversions, für die Kampagnen nicht optimiert werden:
conversion_attribution_event_type Neues Segment Zu ShoppingPerformanceView hinzugefügt
Shopping
App-Kampagnen in ShoppingProduct Neue Funktion Unterstützte App-Kampagnen in der ShoppingProduct-Ressource. Hinweisstatus und Probleme werden nicht unterstützt.
Tag-basierte Produktfilterung Neue Funktion Dynamisches Filtern mit logischen Mengen-Ausdrücken eingeführt: Diese Funktion ist nur für Konten auf der Zulassungsliste verfügbar.

Haupt- und Nebenversionen von v23

Die Google Ads API v23 enthält die folgenden neuen Funktionen, Updates und Breaking Changes.

Version 23.3 (24.06.2026)

In der Google Ads API v23.3 wurden die folgenden neuen Funktionen und Aktualisierungen hinzugefügt. Nebenversionen wie v23.3 enthalten keine funktionsgefährdenden Änderungen.

Funktionen und Updates Typ Beschreibung
Allgemein
Asset.synthetic_content_info
Ad.synthetic_content_info		 Neue Felder Sie enthalten Attestierungen für synthetische/KI-generierte Inhalte, unterteilt in advertiser_attestation (direkt vom Werbetreibenden bereitgestellte Erklärungen) und system_attestation (automatisch erkannte oder von den Systemen von Google bereitgestellte Attestierungen).

Damit Sie Ihre bevorstehende Integrationsarbeit für Version 25 besser planen können, wird die Schnittstelle zum Ändern von Attestierungsfeldern für Werbetreibende bereits für Version 22 und höher eingeführt. Die Benutzeroberfläche ist in diesen Versionen sichtbar, aber synthetic_content_info.advertiser_attestation.status und synthetic_content_info.advertiser_attestation.source bleiben für diese Versionen unverändert.

Wenn Sie versuchen, eine Mutationsanfrage für eines dieser Felder zu senden, wird einer der folgenden Fehler zurückgegeben:

„The field attempted to be mutated is immutable“ (Das Feld, das geändert werden sollte, ist unveränderlich) oder „Field cannot be set“ (Feld kann nicht festgelegt werden).

Ab Version 25 können diese Felder vollständig geändert werden. Wir empfehlen, die Schnittstelle jetzt zu verwenden, um Ihre interne Logik zu entwickeln und zu testen, damit Ihr System bereit für vollständige Schreibfunktionen ist, wenn Version 25 eingeführt wird.
Genehmigungen durch mehrere Parteien Neue Funktionen Unterstützung für die Überprüfung der Genehmigung durch mehrere Parteien hinzugefügt:

Version 23.2 (25.03.2026)

In der Google Ads API v23.2 wurden die folgenden neuen Funktionen und Aktualisierungen hinzugefügt. Nebenversionen wie v23.2 enthalten keine funktionsgefährdenden Änderungen.

Funktionen und Updates Typ Beschreibung
Assets
VideoEnhancement Neue Ressource Enthält verbesserungsspezifische Videoanzeigeninformationen, z. B. ob die Anzeige von Google oder vom Werbetreibenden bereitgestellt wurde. Weitere Informationen zu Video-Optimierungen
AppTopCombinationView Neue Ressource Schreibgeschützte Ressource, die Informationen zu den leistungsstärksten Asset-Kombinationen in App-Kampagnen enthält.
CustomerAsset Neue Funktion Unterstützung für das Abrufen von CustomerAsset mit field_type auf BUSINESS_LOGO festgelegt.
Kampagnen
AdGroupAd.start_date_time
AdGroupAd.end_date_time		 Neue Felder Detailliertere Planungsbedingungen für den Kampagnenzeitraum festlegen Dies wird nur für einige Anzeigengruppentypen unterstützt.
HotelSettingInfo.disable_hotel_setting Neues Feld Ermöglicht das Deaktivieren des Hotelfeeds in Demand Gen-Kampagnen.
Allgemein
CustomerClientLinkError Neue Enum-Werte / Fehler Zwei neue Fehlercodes wurden hinzugefügt: MAX_CUSTOMER_LIMIT_REACHED und ACCOUNT_CREATION_POLICY_VIOLATION.
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS Verhaltensänderung Wenn Sie versuchen, diese eingestellte Kundentypkategorie für Nutzerlisten zu verwenden, wird jetzt ein Fehler ausgegeben.
Planung
GenerateTrendingInsights
GenerateCreatorInsights		 Neue Funktionen Unterstützung für benutzerdefinierte UND/ODER-Kombinationen von Einheiten, Themen und Zielgruppen hinzugefügt.
ReachPlanService.GenerateReachForecast Neue Enum-Werte Es wurden neue Altersgruppen für die Ausrichtung hinzugefügt, z. B. AGE_RANGE_21_44 oder AGE_RANGE_21_49.
youtube_select_lineup_targeting Neues Feld Wurde zu ReachPlanService.ListPlannableProducts hinzugefügt und ersetzt youtube_select_lineups. Beide Felder sind derzeit ausgefüllt.
ReachPlanSurface Neuer Enum-Wert IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS als Option für die Platzierung hinzugefügt.
Forecast Neues Feld clicks für „Klicks maximieren“ (CPC) für Demand Gen-Kampagnen in ReachPlanService.GenerateReachForecast hinzugefügt.
partnership_opportunities Neues Feld ContentCreatorInsightsService.GenerateCreatorInsights und ContentCreatorInsightsService.GenerateTrendingInsights hinzugefügt.
Berichte
biddable_indirect_install_first_in_app_conversion_micros Neues Feld Den Ressourcen Campaign, Customer und AdGroup hinzugefügt.
Videos
ShareablePreviewService Neue Funktion Erweitert, um YouTube Live-Vorschaubilder zu unterstützen, indem preview_type auf YOUTUBE_LIVE_PREVIEW gesetzt wird. UNSUPPORTED_AD_TYPE und TOO_MANY_RESOURCES_IN_REQUEST wurden zu ShareablePreviewError hinzugefügt. Dies wird nur für einige Anzeigentypen unterstützt.

v23.1 (25.02.2026)

In der Google Ads API v23.1 wurden die folgenden neuen Funktionen und Aktualisierungen hinzugefügt. Nebenversionen wie v23.1 enthalten keine funktionsgefährdenden Änderungen.

Funktionen und Updates Typ Beschreibung
Kontoverwaltung
advertising_partner_properties.allowed_domain Neues Feld Den Ressourcen ProductLinkInvitation und ProductLink hinzugefügt. Der Werbepartner kann nur auf dieser Domain werben.
Customer.contains_eu_political_advertising Neues Feld Ruft den Erklärungsstatus auf Kontoebene ab, ob politische Werbung mit Targeting auf die EU enthalten ist, und gibt ein EuPoliticalAdvertisingStatus zurück.
Kampagnen
Campaign.text_guidelines Neues Feld Unterstützung für Richtlinien für Text hinzugefügt, die mit Performance Max- und Suchkampagnen verwendet werden können, um KI-generierte Text-Assets programmatisch zu steuern. Innerhalb von text_guidelines können Sie term_exclusions und messaging_restrictions definieren.
CampaignPrimaryStatusReason Neue Enum-Werte Die Felder CAMPAIGN_NOT_BOOKED, BOOKING_HOLD_EXPIRING, BOOKING_HOLD_EXPIRED und BOOKING_CANCELLED wurden hinzugefügt, um die primären Statusgründe für Kampagnen mit der Gebotsstrategie FIXED_CPM anzugeben.
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure
Campaign.VideoCampaignSettings.booking_details		 Neue Felder Unterstützung für die eigenständige Offenlegung der Reservierungsanzeigenkategorie und schreibgeschützte Buchungsdetails hinzugefügt.
Campaign.missing_eu_political_advertising_declaration Neues Feld Unterstützt das Abfragen und Filtern von Kampagnen, für die keine Erklärungen dazu vorliegen, ob sie politische Werbung enthalten, die auf die EU ausgerichtet ist.
Conversions
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS Neuer Enum-Wert Unterstützt das Tracking von Nutzern, die sich eine Anzeige ansehen und später ein Video desselben Kanals aufrufen.
Allgemein
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED Neuer Enum-Wert / Fehler Wird zurückgegeben, wenn versucht wird, nur auf die Kategorie „Unbestimmt“ in demografischen Dimensionen auszurichten.
Incentives
IncentiveErrorEnum Neue Enum-Werte / Fehler Zwei neue Fehlercodes wurden hinzugefügt: MAX_INCENTIVES_REDEEMED und ACCOUNT_TOO_OLD. Diese Fehler können für Anfragen zurückgegeben werden, die am oder nach dem 11. März 2026 gestellt werden.
Planung
GenerateBenchmarksMetrics Neue Funktion Unterstützung für Aufschlüsselungen nach Datum mit einem BreakdownDefinition hinzugefügt.
ReachPlanService.GenerateReachForecast Neuer Enum-Wert GOOGLE_DISPLAY_NETWORK wurde als ausrichtbare Plattform für Demand Gen-Kampagnen mit dem Zielvorhaben „Maximale Anzahl von Conversions“ hinzugefügt.
GenerateTrendingInsights Neue Felder Beim Suchen nach Thema wurden in TrendInsightDataPoint Informationen zur historischen Trendlinie zu TrendInsights hinzugefügt.
Berichte
Messwerte für die Häufigkeit einzelner Nutzer Neue Felder Es wurden neue Messwerte hinzugefügt, mit denen Sie sehen können, wie viele Nutzer Ihre Anzeige mindestens zwei-, drei-, vier-, fünf- oder zehnmal gesehen haben: unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus und unique_users_ten_plus.
SearchTermMatchSource Neuer Enum-Wert VERTICAL_ADS_DATA_FEED wurde hinzugefügt, um vertikale Anzeigenfeeds wie die Ausrichtung von Reiseanzeigen auf Entitäten zu unterstützen.
YouTubeVideoUpload
YouTubeVideoUpload Neuer Dienst / neue Ressource Der Dienst YouTubeVideoUpload wurde hinzugefügt, um das Hochladen und Verwalten von Videos auf YouTube zu unterstützen. Die Ressource YouTubeVideoUpload wurde hinzugefügt, um das Abrufen von Uploadstatus und Metadaten zu unterstützen. Diese Funktion wird nur für REST und die Python-Clientbibliothek unterstützt.

Version 23 (28.01.2026)

In der Google Ads API v23, einer Hauptversion, wurden die folgenden neuen Funktionen, Aktualisierungen und funktionsgefährdenden Änderungen hinzugefügt.

Eine Anleitung finden Sie unter Upgrade auf die neueste Version durchführen.

Wichtige Änderungen

Ausgangsstatus Neuer Status Art der Änderung Implementierungsleitfaden
Anzeigen
Anzeigenteilung zulässig AdGroupAdError.AD_SHARING_NOT_ALLOWED Verhaltensänderung Die gemeinsame Nutzung von Anzeigen in mehreren Anzeigengruppen ist nicht mehr zulässig. Bei Anfragen, die versuchen, Anzeigen zu teilen, wird der Fehler AD_SHARING_NOT_ALLOWED zurückgegeben.
Unterstützung für CallAd und CallAdInfo Keine Entfernung Die Unterstützung für Anrufanzeigen wurde eingestellt. Weitere Informationen finden Sie im Hilfeartikel Anrufanzeigen.
Kampagnen
Campaign.start_date
Campaign.end_date		 Campaign.start_date_time
Campaign.end_date_time		 Umbenennen / Ersetzen Mit den neuen Datums-/Uhrzeitfeldern können Sie Zeitkomponenten für Kampagnen angeben. Die ursprünglichen Felder mit nur dem Datum werden entfernt.
Demand Gen
DemandGenMultiAssetAdInfo.lead_form_only Keine Entfernung Das Feld lead_form_only wurde entfernt. Aktualisieren Sie Verweise in Ihrem Code.
Berichte
Messwerte und Enum für das Leistungslabel für Assets zusammenfassen Keine Entfernung Zusammengefasste Leistungslabel für Assets entfernt Die Enumeration für Leistungslabel wird für Such- und Displaykampagnen nicht mehr zurückgegeben.

Funktionen und Updates (nicht abwärtsinkompatibel)

Funktionen und Updates Typ Beschreibung
Anzeigen
AdFormatType Neue Enum-Werte Es wurden die neuen Formattypen TEXT, VERTICAL_ADS_BOOKING_LINK und VERTICAL_ADS_PROMOTION hinzugefügt.
Assets
asset_group Aufruf Neue Felder Die folgenden Messwerte wurden hinzugefügt: metrics.engagements, metrics.engagement_rate und metrics.average_cpe.
asset_group_asset Aufruf Neue Felder Die folgenden Messwerte wurden hinzugefügt: metrics.average_cpe, metrics.average_cpm, metrics.trueview_average_cpv, metrics.video_trueview_view_rate, metrics.video_trueview_views und metrics.interaction_event_types.
Asset.orientation Neues Feld Das schreibgeschützte Feld „Ausrichtung“ wurde Bild- und Video-Assets hinzugefügt.
CampaignAsset Neue Funktion Unterstützung für das Abrufen von Kampagnen-Assets mit field_type auf HEADLINE und DESCRIPTION festgelegt hinzugefügt.
ServedAssetFieldType Neue Enum-Werte HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE und DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO für Assets hinzugefügt, die als Sitelinks ausgeliefert werden.
BusinessMessageAsset Neue Funktionen / Unterstützung Aktualisierte Assets für Nachrichten an das Unternehmen:
Abrechnung
InvoiceService.ListInvoices Neue Optionen Durch Festlegen von include_granular_level_invoice_details in ListInvoicesRequest können jetzt detailliertere Informationen in Invoice zurückgegeben werden, einschließlich einer Aufschlüsselung der Kosten auf Kampagnenebene, detaillierter regulatorischer Kosten und Anpassungsinformationen.
RegulatoryFeeType
UnitOfMeasure		 Neue Enums Es wurden Hilfs-Enums für gesetzlich vorgeschriebene Gebühren und Maßeinheiten hinzugefügt.
Kampagnen
CampaignError Neue Enum-Werte / Fehler Die Fehlercodes DURATION_TOO_LONG_FOR_TOTAL_BUDGET und END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET wurden hinzugefügt.
Conversions
ConversionActionCategory Neuer Enum-Wert YOUTUBE_FOLLOW_ON_VIEWS wurde hinzugefügt, um Nutzer zu erfassen, die sich eine Anzeige ansehen und später ein Video vom selben Kanal aufrufen.
Demand Gen
DemandGenVideoResponsiveAdInfo.companion_banner Neues Feld Unterstützung von Companion-Bannern in responsiven Demand Gen-Videoanzeigen hinzugefügt
Incentives
Unterstützung für CYO-Anreize (Choose Your Own) hinzugefügt:

Um eine detailliertere programmatische Verarbeitung von Fehlern zu ermöglichen, werden wir in zukünftigen Versionen zusätzliche Fehlercodes zu IncentivesService hinzufügen. Wir empfehlen Ihnen, anstehende Ankündigungen und Versionshinweise zu diesen neuen Fehlercodes im Blick zu behalten, damit Ihre Anwendungen diese neuen Fehlermodi verarbeiten können.
Planung
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST Neuer Enum-Wert Ermöglicht das Erstellen von Zielgruppen mit Lebensereignissen in GenerateAudienceCompositionInsights, GenerateSuggestedTargetingInsights, GenerateInsightsFinderReport und GenerateCreatorInsights.

Lebensereignisse werden für andere AudienceInsightsService-Methoden wie AudienceInsightsService.GenerateAudienceOverlap und AudienceInsightsService.GenerateTargetingSuggestionMetrics nicht unterstützt.
ReachPlanService.GenerateConversionRates Neue Felder / Optionen Die Antwort enthält jetzt Oberflächen, um Vorschläge für die Conversion-Rate basierend auf Oberflächenkontrollen (z.B. Gmail, Shorts) zu unterstützen. Wird nur für Demand Gen-Kampagnen unterstützt.
LanguageDistribution Neues Feld / neuer Typ Wurde YouTubeChannelInsights hinzugefügt, um Details zur Sprachverteilung in YouTube-Kanalinhalten bereitzustellen.
BenchmarksService Neuer Dienst Vergleicht YouTube-Werbedaten mit Branchen-Benchmarks.
AudienceInsightsService.GenerateAudienceDefinition Neue Methode Übersetzt eine Freitextbeschreibung einer Zielgruppe mithilfe generativer KI in passende Zielgruppenattribute.
YouTubeChannelInsights.relevance_score Neues Feld Bewertet, wie relevant ein Creator für ein Thema ist, gewichtet nach Aufrufen.
TrendInsightMetrics.trend_change_percent Neues Feld Die prozentuale Änderung des Werts eines Trends im Vergleichszeitraum.
Empfehlungen
GenerateRecommendationsRequest Neues Feld is_new_customer wurde hinzugefügt. Wenn der Wert für CAMPAIGN_BUDGET-Empfehlungen auf true festgelegt ist, wird ein für Neukunden optimiertes Modell verwendet. Dies wird nur für Kunden ohne Kampagnen empfohlen.
Berichte
AdGroupAdAssetView Unterstützung für neue Funktionen / Messwerte Es werden jetzt Impressions-, Leistungs- und Conversion-Messwerte für RESPONSIVE_DISPLAY_AD unterstützt.
ad_sub_network_type-Segment Neues Segment Bietet eine detaillierte Leistungsaufschlüsselung innerhalb eines Werbenetzwerks. Zunächst für Demand Gen-Kampagnen auf YouTube verfügbar (In‑Stream, In‑Feed, Shorts). Muss zusammen mit ad_network_type ausgewählt werden.
Berichte zu Performance Max-Kampagnen Neue Funktion Aufschlüsselung nach Anzeigennetzwerktyp für Performance Max-Kampagnen aktiviert.
UserLocationView
GeographicView		 Unterstützung für neue Segmente Messwerte für den Support, segmentiert nach Conversion-Datum: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, all_conversions_value_by_conversion_date, value_per_conversions_by_conversion_date, value_per_all_conversions_by_conversion_date, cross_device_conversions_by_conversion_date und cross_device_conversions_value_by_conversion_date.
Segmente für vertikale Anzeigen Neue Segmente Die folgenden Segmente wurden hinzugefügt: vertical_ads_event_participant_display_names, vertical_ads_hotel_class, vertical_ads_listing, vertical_ads_listing_brand, vertical_ads_listing_city, vertical_ads_listing_country, vertical_ads_listing_region, vertical_ads_partner_account und vertical_ads_vertical.
PerStoreView
MatchedLocationInterestView		 Neue Berichtsressourcen PerStoreView wurde hinzugefügt, um Details zum Standort des Geschäfts abzufragen, und MatchedLocationInterestView (für AI Max-Kampagnen), um Leistungsmesswerte nach geografischen Orten von Interesse bereitzustellen.
Shopping
ShoppingPerformanceView Unterstützung für neue Messwerte Die folgenden Messwerte werden jetzt nach Conversion-Datum segmentiert unterstützt: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, value_per_conversions_by_conversion_date und value_per_all_conversions_by_conversion_date.
ShoppingPerformanceView Unterstützung für neue Messwerte Unterstützung für search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share und search_rank_lost_absolute_top_impression_share hinzugefügt.
ShoppingProduct.product_image_uri Neues Feld Zu ShoppingProduct hinzugefügt
Vertikale Anzeigen
AdGroup.vertical_ads_format_setting Neues Feld Damit lässt sich steuern, welche Anzeigenformate in Suchkampagnen mit Reisefeeds ausgeliefert werden können.
AdGroupCriterion
SharedCriterion		 Neue Felder / Kriterien Der Kriteriumstyp vertical_ads_item_group_rule_list wurde AdGroupCriterion und vertical_ads_item_group_rule wurde SharedCriterion hinzugefügt, um das Ausrichten von Artikelgruppen in Suchkampagnen mit Reisefeeds zu ermöglichen.
Einbindung von Datenfeeds für vertikale Anzeigen Neue Funktion Sie können jetzt einen vertikalen Anzeigen-Datenfeed mit einer Suchkampagne verknüpfen, in der AI Max verwendet wird, um Anzeigen für Immobilienangebote und Anzeigen mit Buchungslinks neben Textanzeigen zu präsentieren. Formatieren Sie Steuerelemente mit vertical_ads_format_setting und definieren Sie Regeln mit vertical_ads_item_group_rule. Berichte nach AdFormatType- und vertikalen Anzeigen-Feed-Dimensionen segmentieren
Videos
AdVideoAssetInfo.ad_video_asset_feature_control Neues Feld Es wurden Optionen für die Funktionssteuerung für Videoanzeigen-Assets hinzugefügt.
CampaignCriterionError Neuer Enum-Wert / Fehler Der Fehlercode INVALID_VIDEO_LINEUP_ID wurde hinzugefügt.
Messwerte zur Hörbarkeit auf YouTube Neue Messwerte Es wurden Messwerte für die Hörbarkeit von Audioanzeigen auf YouTube hinzugefügt. Sie geben an, ob eine Anzeige hörbar war und bei wie vielen Impressionen die Hörbarkeit gemessen werden konnte.

Haupt- und Nebenversionen von v22

Die Google Ads API v22 enthält die folgenden neuen Funktionen, Updates und Breaking Changes.

Version 22.2 (24.06.2026)

In der Google Ads API v22.2 wurden die folgenden neuen Funktionen und Aktualisierungen hinzugefügt. Nebenversionen wie v22.2 enthalten keine funktionsgefährdenden Änderungen.

Funktionen und Updates Typ Beschreibung
Allgemein
Asset.synthetic_content_info
Ad.synthetic_content_info		 Neue Felder Sie enthalten Attestierungen für synthetische/KI-generierte Inhalte, unterteilt in advertiser_attestation (direkt vom Werbetreibenden bereitgestellte Erklärungen) und system_attestation (automatisch erkannte oder von den Systemen von Google bereitgestellte Attestierungen).

Damit Sie Ihre bevorstehende Integrationsarbeit für Version 25 besser planen können, wird die Schnittstelle zum Ändern von Attestierungsfeldern für Werbetreibende bereits für Version 22 und höher eingeführt. Die Benutzeroberfläche ist in diesen Versionen sichtbar, aber synthetic_content_info.advertiser_attestation.status und synthetic_content_info.advertiser_attestation.source bleiben für diese Versionen unverändert.

Wenn Sie versuchen, eine Mutationsanfrage für eines dieser Felder zu senden, wird einer der folgenden Fehler zurückgegeben:

„The field attempted to be mutated is immutable“ (Das Feld, das geändert werden sollte, ist unveränderlich) oder „Field cannot be set“ (Feld kann nicht festgelegt werden).

Ab Version 25 können diese Felder vollständig geändert werden. Wir empfehlen, die Schnittstelle jetzt zu verwenden, um Ihre interne Logik zu entwickeln und zu testen, damit Ihr System bereit für vollständige Schreibfunktionen ist, wenn Version 25 eingeführt wird.
Genehmigungen durch mehrere Parteien Neue Funktionen Unterstützung für die Überprüfung der Genehmigung durch mehrere Parteien hinzugefügt:

Version 22.1 (25.02.2026)

Die folgende neue Funktion wurde in die Google Ads API v22.1 aufgenommen. Nebenversionen wie v22.1 enthalten keine funktionsgefährdenden Änderungen.

Funktionen und Updates Typ Beschreibung
Kontoverwaltung
Customer.contains_eu_political_advertising Neues Feld Ruft den Erklärungsstatus auf Kontoebene ab, ob politische Werbung für die EU enthalten ist, und gibt ein EuPoliticalAdvertisingStatus zurück.
Kampagnen
Campaign.missing_eu_political_advertising_declaration Neues Feld Unterstützt das Abfragen und Filtern von Kampagnen, für die keine Erklärungen dazu vorliegen, ob sie politische Werbung enthalten, die auf die EU ausgerichtet ist.

v22 (15.10.2025)

In der Google Ads API v22, einem Hauptrelease, wurden die folgenden neuen Funktionen, Aktualisierungen und Änderungen mit Breaking Changes hinzugefügt.

Eine Anleitung finden Sie unter Upgrade auf die neueste Version durchführen.

Wichtige Änderungen

Ausgangsstatus Neuer Status Art der Änderung Implementierungsleitfaden
Demand Gen
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros minimum_budget_amount_micros Umbenennen / Rechtschreibfehler korrigieren Benennen Sie Verweise um, damit der korrigierte Feldname verwendet wird.
Allgemein
Kein Vorgangslimit in AddBatchJobOperations Limit von 10.000 Vorgängen pro Anfrage Verhaltensänderung Achten Sie darauf,dass keine einzelne AddBatchJobOperations-Anfrage mehr als 10.000 Vorgänge enthält.
Die Seitengröße wurde in ListBatchJobResultsRequest stillschweigend auf 1.000 begrenzt. Gibt den Fehler INVALID_PAGE_SIZE zurück Verhaltensänderung Achten Sie darauf,dass ListBatchJobResultsRequest.page_size auf 1.000 oder weniger festgelegt ist, da das Anfordern einer größeren Seitengröße jetzt zu einem Fehler führt.
Performance Max-Kampagne
Asset-Leistungslabel Keine Entfernung Die Unterstützung von Asset-Leistungslabels und die zugehörige Enum für Leistungslabels wurden für Performance Max-Kampagnen entfernt. Aktualisieren Sie die Integrationen entsprechend.
Campaign.url_expansion_opt_out FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION-Flag in AssetAutomationSetting Entfernung / Austausch Verwenden Sie die Einstellung für die Automatisierung von Text-Assets für die Erweiterung der finalen URL. Das Feld zum Deaktivieren der URL-Erweiterung auf Kampagnenebene wurde entfernt.
Planung
views trueview_views Entfernung / Austausch Ersetzen Sie Verweise auf views durch das neue Feld trueview_views in ReachPlanService.
Videos
average_cpv
video_view_rate
video_views
video_view_rate_in_feed
video_view_rate_in_stream
video_view_rate_shorts		 trueview_average_cpv
video_trueview_view_rate
video_trueview_views
video_trueview_view_rate_in_feed
video_trueview_view_rate_in_stream
video_trueview_view_rate_shorts		 Umbenennungen Aktualisieren Sie Abfragestrings und Integrationen, damit die neuen Messwertnamen für TrueView-Videoaufrufe verwendet werden.

Funktionen und Updates (nicht abwärtsinkompatibel)

Funktionen und Updates Typ Beschreibung
Assets
AssetFieldType.LANDING_PAGE_PREVIEW Neuer Enum-Wert Als neuer Feldtyp für Bild-Assets hinzugefügt.
AssetGenerationService Neuer Dienst (Beta) Ermöglicht die Generierung von Text- und Bild-Assets mit generativer KI:
  • GenerateText: Generiert Text basierend auf der finalen URL, Prompts, Keywords usw.
  • GenerateImages: Generiert Bilder basierend auf der finalen URL, Prompts oder der Rekontextualisierung von Produktbildern.
  • Fehler werden mit Codes aus AssetGenerationError zurückgegeben.
Anfangs nur für eine begrenzte Anzahl von Teilnehmern der geschlossenen Beta verfügbar.
Kampagnen
AppCampaignBiddingStrategyGoalType Neue Enum-Werte Für App-Installationskampagnen wurden neue Zielvorhaben hinzugefügt, mit denen Sie die Kampagnen ohne Angabe eines Zielwerts optimieren können:
  • OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: Für die Standard-Gebotsstrategie „Conversions maximieren“ verwenden.
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS: Für die Standard-Gebotsstrategie „Conversion-Wert maximieren“ verwenden.
BiddingStrategyType Neue Funktion Unterstützung für den Gebotsstrategietyp „Fester Share of Voice“ hinzugefügt.
Campaign.feed_types Neues Feld Hier werden die Arten von Feeds angezeigt, die mit einer Kampagne verknüpft sind. Bei Performance Max-Kampagnen kann dies die Branche angeben, z. B. MERCHANT_CENTER_FEED für den Einzelhandel.
Targeting mit freigegebenen Sätzen Neue Funktion Es ist jetzt möglich, freigegebene Sets mit auszuschließenden Keywords an Multi-Channel-Kampagnen (für App-Kampagnen) und lokale Kampagnen anzuhängen.
Demand Gen
Gebotsstrategie „Ziel-CPC“ Neue Funktion Gebotsstrategie zum Maximieren von Klicks zum Ziel-CPC hinzugefügt: Legen Sie den Ziel-CPC auf Kampagnenebene mit Campaign.target_cpc fest und überschreiben Sie ihn auf Anzeigengruppenebene mit AdGroup.target_cpc_micros.
AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES Neuer Enum-Wert Wenn diese Option für DemandGenMultiAssetAdInfo aktiviert ist, werden Designelemente hinzugefügt und Text-Assets in Bild-Assets eingebettet, um neue Bild-Assets mit unterschiedlichen Seitenverhältnissen zu erstellen (standardmäßig aktiviert).
AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS Neuer Enum-Wert Wenn diese Option für DemandGenMultiAssetAdInfo aktiviert ist, werden Videos mit anderen Assets wie Bildern und Text generiert, die dann zum Erstellen neuer DemandGenVideoResponsiveAdInfo-Instanzen verwendet werden können (standardmäßig aktiviert).
Allgemein
ListBatchJobResultsRequest Fallback für die Seitengröße Verhaltensänderung Wenn page_size nicht festgelegt oder 0 ist, wird jetzt standardmäßig der Maximalwert von 1.000 verwendet (zuvor wurde INVALID_PAGE_SIZE zurückgegeben).
QuotaError Neuer Enum-Wert / Fehler PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED wurde hinzugefügt, um anzugeben, wann das Ratenlimit für die Aktivierung von Zahlungsprofilen überschritten wird.
Performance Max-Kampagne
Einstellungen für die Asset-Automatisierung Neue Enum-Werte Es wurden neue Optionen für die Asset-Automatisierung in Performance Max-Kampagnen hinzugefügt:
  • GENERATE_IMAGE_ENHANCEMENT: Aktiviert die automatische Erstellung optimierter Bilder (automatisches Zuschneiden). Standardmäßig aktiviert.
  • GENERATE_IMAGE_EXTRACTION: Bilder aus finalen URLs. Standardmäßig wird die Einstellung für dynamische Bilderweiterungen des Kontos verwendet.
PMax-Berichtssegmente Neue Segmente Es wurden neue Segmente hinzugefügt, die nur für Performance Max-Kampagnen verfügbar sind:
  • ad_using_product_data: Gibt an, ob in einer Anzeige Produktdaten aus dem Google Merchant Center verwendet werden.
  • ad_using_video: Gibt an, ob in einer Anzeige ein Video-Asset verwendet wird.
Planung
CRM-Partnerdatenlisten Neues Feature / neuer Enum-Wert THIRD_PARTY_PARTNER_DATA wurde CRM-Datenquellen hinzugefügt, zusammen mit Fehlercodes für die Zielgruppenvalidierung von Partnern (z. B. TOS-Akzeptanz, fehlender Link usw.).
Messwerte für Livestream-Creator Neues Feld YouTubeMetrics.is_active_live_stream_creator wurde hinzugefügt. Dieser Wert wird von Creator-Insights zurückgegeben und gibt an, ob ein Creator in den letzten 90 Tagen einen Livestream veröffentlicht hat.
Planbare CRM-Quellmetadaten Neue Nachricht PlannableUserListMetadata wurde in PlannableUserList eingefügt, das von ReachPlanService.ListPlannableUserLists zurückgegeben wird, um CRM-Datenquellentypen anzuzeigen.
Unterstützung für ähnliche Videos und Creator in TrendInsight Neue Felder Unterstützung für related_videos und related_creators auf TrendInsight sowie für die Eigenschaften von Uhren in video_properties und publish_date hinzugefügt.
Verbesserungen bei InsightsFinder Neue Funktion GenerateInsightsFinderReport unterstützt jetzt parental_status, income_ranges und komplexere UND/ODER-Targeting-Kombinationen.
Berichte
Neue Klicktypen Neue Enum-Werte CLICK_TO_MESSAGE_THIRD_PARTY_CLICK und CLICK_TO_MESSAGE_LANDING_PAGE_CLICK wurden hinzugefügt.
Segmentierung von AssetGroupAsset Unterstützung für neue Segmente AssetGroupAsset kann jetzt nach device, conversion_action, conversion_action_name und conversion_action_category segmentiert werden.
Responsive Suchanzeigen in AdGroupAdAssetView Unterstützung für neue Funktionen / Messwerte AdGroupAdAssetView unterstützt jetzt vollständig Leistungs- und Conversion-Messwerte für RESPONSIVE_SEARCH_AD (bisher wurden nur Impressionen zurückgegeben).
Segmentierungen von Messwerten für Cluster von explorativen Anfragen Unterstützung für neue Segmente Die Messwerte clicks_unique_query_clusters, conversions_unique_query_clusters und impressions_unique_query_clusters können jetzt nach Datumsfeldern segmentiert werden.
TargetingExpansionView Neue Berichtsressource TargetingExpansionView wurde hinzugefügt, um Messwerte für Erweiterungen über das manuelle Targeting zu melden, z. B. Erweiterungen ohne Keywords für AI Max für Suchkampagnen.
Shopping
Shopping-Bereich korrigieren Fehlerkorrektur Der Kampagnen- und Anzeigengruppenbereich von Messwerten in der ShoppingProduct-Ressource wurde korrigiert.
Vereinheitlichte Zielvorhaben
Zielvorhaben „Kundenbindung“ Neue Funktion Unterstützung für Zielvorhaben zur Kundenbindung hinzugefügt, um die erneute Interaktion mit Bestandskunden zu optimieren (z.B. mit target_option und TARGET_SPECIFIC oder TARGET_ALL).
Videos
Messwerte zur Videowiedergabezeit Neue Felder Messwerte für die Wiedergabezeit hinzugefügt: video_watch_time_duration_millis (Gesamtdauer) und average_video_watch_time_duration_millis (durchschnittliche Dauer pro Impression).

Haupt- und Nebenversionen von v21

Die Google Ads API v21 enthält die folgenden neuen Funktionen, Updates und Breaking Changes.

Version 21.2 (24.06.2026)

In der Google Ads API v21.2 wurden die folgenden neuen Funktionen und Aktualisierungen hinzugefügt. Nebenversionen wie v21.2 enthalten keine funktionsgefährdenden Änderungen.

Funktionen und Updates Typ Beschreibung
Allgemein
Genehmigungen durch mehrere Parteien Neue Funktionen Unterstützung für die Überprüfung der Genehmigung durch mehrere Parteien hinzugefügt:

Version 21.1 (25.02.2026)

In der Google Ads API v21.1 wurden die folgenden neuen Funktionen und Aktualisierungen hinzugefügt. Nebenversionen wie v21.1 enthalten keine funktionsgefährdenden Änderungen.

Funktionen und Updates Typ Beschreibung
Kontoverwaltung
Customer.contains_eu_political_advertising Neues Feld Ruft den Erklärungsstatus auf Kontoebene ab, ob politische Werbung mit Targeting auf die EU enthalten ist, und gibt ein EuPoliticalAdvertisingStatusEnum zurück.
Kampagnen
Campaign.missing_eu_political_advertising_declaration Neues Feld Unterstützt das Abfragen und Filtern von Kampagnen, für die keine Erklärungen dazu vorliegen, ob sie politische Werbung enthalten, die auf die EU ausgerichtet ist.

v21 (06.08.2025)

In der Google Ads API v21, einem Hauptrelease, wurden die folgenden neuen Funktionen, Aktualisierungen und wichtigen Änderungen hinzugefügt.

Eine Anleitung finden Sie unter Upgrade auf die neueste Version durchführen.

Wichtige Änderungen

Ausgangsstatus Neuer Status Art der Änderung Implementierungsleitfaden
Kampagnen
Gibt CriterionError.INVALID_LISTING_GROUP_HIERARCHY zurück Gibt CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION zurück Änderung des Fehlercodes Bei Anfragen, bei denen ein teilweiser Fehler aktiviert ist, müssen Sie den neuen Fehlercode anstelle des ursprünglichen Hierarchie-Fehlercodes verarbeiten.
Conversions
Zugriff auf den debug_enabled-Modus in ConversionUploadService Keine Entfernung Das Feld debug_enabled wurde entfernt. Aktualisieren Sie den Code, der darauf verweist, sodass dieser Parameter nicht festgelegt oder abgefragt wird.
Änderungen bei politischer Werbung in der EU
Optionale Selbsterklärungen für politische Werbung in der EU Erforderliches Feld contains_eu_political_advertising für neue Kampagnen Validierungsregel / Verhaltensänderung API-Aufrufe zum Erstellen neuer Kampagnen schlagen mit dem Fehler FieldError.REQUIRED fehl, wenn dieses Feld nicht festgelegt ist. Ab dem 22. September 2025 werden Kampagnen, die als CONTAINS_EU_POLITICAL_ADVERTISING deklariert sind, nicht mehr in der EU ausgeliefert.
Änderbare Kriterien ohne Selbstdeklaration Updates mit CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION schlagen fehl Validierungsregel / Verhaltensänderung Legen Sie den Status der Selbsterklärung fest, bevor Sie versuchen, Targeting-Kriterien für die Nähe, den Standort oder die Standortgruppe auf Kampagnen- oder Anzeigengruppenebene für bestehende Kampagnen zu erstellen oder zu aktualisieren.
Tests ohne Aufforderung zur Selbstdeklaration Updates mit ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION schlagen fehl Validierungsregel / Verhaltensänderung Die Selbsterklärungen müssen für die Kampagnen des Tests abgegeben worden sein.
Performance Max-Kampagne
Der Standardwert für brand_guidelines_enabled ist false. Die Standardeinstellung ist true. Verhaltensänderung Bei neuen Performance Max-Kampagnen sind Markenrichtlinien standardmäßig aktiviert. Legen Sie das Feld explizit auf false fest, wenn die Funktionen deaktiviert werden sollen.
Planung
Ursprünglicher Eingabeargumenttyp für AudienceInsightsService.GenerateTargetingSuggestionMetrics Eingabe vom Typ InsightsAudience Typänderung Aktualisieren Sie die Implementierungen, um den neuen Eingabetyp zu übergeben, der eine AND-of-ORs-Kombination von Nutzerinteressen unterstützt. So können Sie potenzielle Reichweitenmesswerte für benutzerdefinierte Zielgruppendefinitionen verwenden.

Funktionen und Updates (nicht abwärtsinkompatibel)

Funktionen und Updates Typ Beschreibung
AI Max für Suchkampagnen
ai_max_setting.enable_ai_max in Campaign Neues Feld Ermöglicht es AI Max, den Suchanfragen-Abgleich zu erweitern. Dabei werden die bisherige Text-Asset-Automatisierung und die Markenlisten berücksichtigt, bis die Funktion deaktiviert wird. Das Feld Campaign.ai_max_setting.bundling_required gibt an, ob AI Max aktiviert sein muss, damit diese Einstellungen berücksichtigt bzw. geändert werden können. Mit AdGroup.ai_max_ad_group_setting.disable_search_term_matching kann der Abgleich auf Anzeigengruppenebene deaktiviert werden. Erzielen Sie mit AI Max für Suchkampagnen eine höhere Leistung.
CampaignError.AI_MAX_MUST_BE_ENABLED Neuer Enum-Wert / Fehler Wird ausgelöst, wenn die Text-Asset-Automatisierung für die URL-Erweiterung in Suchkampagnen aktiviert wird, ohne AI Max zu aktivieren.
Targeting auf Anzeigengruppenebene Neue Funktion In AI Max für Suchkampagnen werden jetzt Markenlisten, Standorte und Webseiten (URL-Regeln) auf Anzeigengruppenebene unterstützt.
ai_max_search_term_ad_combination_view Neue Berichtsressource Berichte zur Leistung von Kombinationen aus Suchbegriffen, Anzeigentiteln und Landingpages.
search_term_match_type-Segment Neuer Enum-Wert AI_MAX als Option für den Übereinstimmungstyp von Suchbegriffen hinzugefügt.
Assets
PromotionAsset Neue Felder terms_and_conditions_text, terms_and_conditions_uri und eine der promotion_trigger-Optionen (promotion_barcode_info, promotion_qr_code_info) wurden hinzugefügt. Weitere Informationen zu Angebots-Assets
AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION Neuer Enum-Wert AssetAutomationType wurde hinzugefügt, um die automatische Text- und Landingpage-Generierung aus finalen URLs in Suchkampagnen zu steuern.
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset Neuer Dienst / neue Methode Ermöglicht das Entfernen automatisch erstellter Assets für die Erweiterung der finalen URL aus Kampagnen.
ServedAssetFieldType.DESCRIPTION_PREFIX Neuer Enum-Wert Wurde hinzugefügt, um ein Problem mit Berichten zu beheben, bei dem der Typ in ad_group_ad_asset_combination_view als UNKNOWN zurückgegeben wurde.
Kampagnen
CampaignPrimaryStatusReason.MISSING_LOCATION_TARGETING Neuer Enum-Wert Wird zurückgegeben, wenn bei standortbeschränkten Kampagnen kein geografisches Targeting vorhanden ist. Wenn das Targeting außerhalb des zulässigen Bereichs erfolgt, wird jetzt LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN ausgegeben.
Integration von Drittanbieter-App-Analysen Neue Felder Unterstützung für VideoCustomer.third_party_integration_partners und Campaign.third_party_integration_partners hinzugefügt. Weitere Informationen zum Erfassen von App-Conversions mit Drittanbieter-App-Analysetools
Campaign.advertising_partner_ids Unterstützung für neue Felder Das Feld kann jetzt für bestehende Kampagnen festgelegt werden (bleibt nach der Festlegung unveränderlich).
Auszuschließende Placements auf Verwaltungskontoebene Neue Funktion Ermöglicht Ausschlüsse von Placement-Listen in einzelnen Werbetreibendenkonten mit CustomerNegativeCriterion.
Toleranzkonfigurationen in Ziel-ROAS-Strategien Neue Felder Unterstützung für TargetRoas.target_roas_tolerance_percent_millis (für Portfolio-Gebotsstrategien für Suchkampagnen) in MaximizeConversionValue und TargetRoas hinzugefügt.
LocationInterestView Neue Berichtsressource Fasst die Leistung von Kriterien für Orte von Interesse der Anzeigengruppe zusammen.
Conversions
conversion_attribution_event_type-Segment Neuer Enum-Wert ENGAGED_VIEW wurde den Optionen für den Conversion-Attributionstyp hinzugefügt.
Demand Gen
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM Neuer Enum-Wert / Fehler Wurde im Hinblick auf die Durchsetzung von Mindestbudgets für Demand Gen-Kampagnen hinzugefügt. Details werden über budgetDailyMinimumErrorDetails bereitgestellt.
Performance Max-Kampagne
campaign_search_term_view Neue Berichtsressource Hier werden Messwerte für Suchbegriffe auf Kampagnenebene zusammengefasst, sodass sich Suchbegriffe für Performance Max-Kampagnen analysieren und Berichte erstellen lassen.
Planung
ReachPlanService.ListPlannableUserInterests Neue Methode Ermöglicht die Ermittlung von planbaren Zielgruppen mit gemeinsamen Interessen und kaufbereiten Zielgruppen für generateReachForecast.
AdditionalApplicationInfo Neues Feld Wurde als optionale Eingabe in ReachPlanService.ListPlannableUserLists hinzugefügt.
Liste der AudienceInsights-Attribute Neue Funktion AudienceInsightsService.ListAudienceInsightsAttributes ruft jetzt verfügbare Nutzerlisten von Drittanbietern ab.
CRM-Listen für AudienceCompositionInsights-Targeting Neue Funktion AudienceInsightsService.GenerateAudienceCompositionInsights gibt jetzt Details zum Nutzerlistenindex für die Dimensionen AudienceInsightsDimension zurück: AGE_RANGE, GENDER, AFFINITY_USER_INTEREST und IN_MARKET_USER_INTEREST.
TrendInsightMetrics Anteil der Zuschauer Neues Feld Stellt den Anteil einer Zielgruppe für einen Trend dar.
KnowledgeGraphAttributeMetadata-Kategorien Neue Felder Filtert Knowledge Graph-Attribute nach übereinstimmenden Kategorien.
Berichte
Messwerte für Asset-Ansichten Neue Funktionen / Messwerte Für AssetGroupAsset, ChannelAggregateAssetView und CampaignAggregateAssetView wurden mehrere neue Messwerte hinzugefügt. Für Performance Max-Kampagnen werden jetzt auch tatsächliche Werte für impressions gemeldet.
Selector-Erweiterungen Neue Funktion AssetSet und CampaignAssetSet können jetzt gemeinsam in ChangeStatus abgefragt werden.
search_term_targeting_status Neues Segment Auswählbares Segment in der Ansicht „Suchbegriffe der Kampagne“.
final_url_expansion_asset_view Neue Berichtsressource Berichte mit Leistungsdetails zu Assets, wenn die Erweiterung der finalen URL aktiviert ist.
Wertanpassungen für Asset-Gruppen Neue Felder Der Bericht AssetGroup unterstützt jetzt die Messwerte value_adjustment und all_value_adjustment.
landing_page_source Neues Segment Stellt ein Segment für die Landingpage-Quelle in landing_page_view bereit.
search_term_match_source Neues Segment Auswählbares Segment in den Ansichten „Suchanfragen“ und „Kampagnen-Suchanfragen“.
match_type Neues Segment Auswählbarer Segmentierungsschlüssel in der Keyword-Ansicht.
Berichte zu eindeutigen Clustern mit Suchanfragen Neue Felder clicks_unique_query_clusters, conversions_unique_query_clusters und impressions_unique_query_clusters wurden hinzugefügt, um Cluster mit eindeutiger Suchanfrageabsicht zu melden.
ClickType.VEHICLE_ASSETS Neuer Enum-Wert Klicks, die sich speziell auf Anzeigenformate für Fahrzeuge beziehen, lassen sich im Bericht click_view erfassen und analysieren.
Traffic-Finder für Smart Bidding
Toleranzkonfigurationen in Suchstrategien Neue Felder / Einstellungen Ermöglicht die Aktivierung des Traffic-Finders für Smart Bidding für Suchkampagnen, indem target_roas_tolerance_percent_millis auf einen Wert zwischen 10.000 (10%) und 30.000 (30%) festgelegt wird (für „Conversion-Wert maximieren“ ist die Einstellung target_roas erforderlich). Weitere Informationen finden Sie in unserem Traffic-Finder für Smart Bidding und im Hilfeartikel.
Kompatibilität mit Berichten zur Vielfalt Neue Funktion Die aggregierte Berichterstellung zur Vielfalt wird jetzt für die folgenden Messwerte für eindeutige Cluster mit Suchanfragen unterstützt. In der Google Ads-Benutzeroberfläche ist eine nach Zeit segmentierte Ansicht verfügbar:
  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters
Videos
YouTubeVideoListAsset Neue Ressource / Neues Feld Ermöglicht das Einrichten von Verknüpfungen zwischen Kampagnen und Video-Listen-Assets mit Asset.youtube_video_list_asset. Weitere Informationen finden Sie unter Ähnliche Videos verwenden.
Erweiterungen für Metadaten zur Statistik Neue Felder YouTubeChannelInsights und YouTubeVideoAttributeMetadata wurden neue Metadaten hinzugefügt.
Interaktive Klicktypen Neue Enum-Werte Die Klicktypen VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICK und PRODUCT_ASSETS wurden hinzugefügt.
VideoAdInventoryControl.allow_non_skippable_in_stream Neues Feld Responsive Videoanzeigen können als nicht überspringbare In-Stream-Anzeigen für Kampagnen ausgeliefert werden, in denen überspringbare und nicht überspringbare Formate kombiniert werden.
Einstellungen für Videosequenzen Neue Felder Schreibgeschützte Sequenzierungskonfigurationen hinzugefügt: Campaign.VideoCampaignSettings.video_ad_sequence und VideoAdSequenceStepSetting. Weitere Informationen zu Kampagnen mit Videosequenzen
Targeting auf Videopakete Neuer Kriteriumstyp / neues Feld Der Kriterientyp VIDEO_LINEUP und das entsprechende Feld wurden in CampaignCriterion und AdGroupCriterion hinzugefügt. Diese Funktion ist nur für Konten auf der Zulassungsliste verfügbar.
Aufrufe von Placements für die Eignung von Inhalten Neue Berichtsressourcen Es wurde ein Bericht zur Eignung von Inhalten sowohl auf Detail- (detail_content_suitability_placement_view) als auch auf Gruppenebene (group_content_suitability_placement_view) hinzugefügt. Weitere Informationen zum Bericht „Eignung der Inhalte“

Archivierte Versionshinweise

Archivierte Versionshinweise finden Sie unter Eingestellte Versionen.