Versionshinweise

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

Haupt- und Nebenversionen von v25

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

Version 25.1 (19.08.2026)

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

Funktionen und Updates Typ Beschreibung
Assets
AssetFieldType.TEXT_DISCLAIMER
ServedAssetFieldType.TEXT_DISCLAIMER		 Neue Enum-Werte Unterstützung für Text-Haftungsausschluss-Assets hinzugefügt.
Kampagnen
Campaign.aca_migration_date_time
Campaign.broad_match_migration_date_time		 Neue Felder Anstehende automatische Migration zu AI Max verfolgen
Conversions
Analysen der Anzeigenwirkung auf die Markenbekanntheit Neue Funktionen Die Analyse der Anzeigenwirkung auf die Markenbekanntheit wird jetzt unterstützt. Dazu wurden folgende Änderungen vorgenommen:
Analysen der Conversion-Steigerung Neue Funktionen Unterstützung für die Analyse der Conversion-Steigerung wurde mit den folgenden Updates hinzugefügt:
  • Eine neue schreibgeschützte Ressource LiftMeasurementConfig für Brand Lift-Studien wurde hinzugefügt.
  • Es wurden neue auswählbare Segmente hinzugefügt, mit denen sich die Ergebnisse für Kampagnen mit Steigerung als Zielvorhaben segmentieren und filtern lassen.
  • Es wurden 24 neue Messwerte für die Conversion-Steigerung und Gewinner-Messwerte hinzugefügt, die eine detaillierte statistische Analyse der Steigerungsleistung ermöglichen.
  • Unterstützung für das Abrufen von Kampagnendetails und Conversion-Zielvorhaben hinzugefügt.
  • Es wurde ein neues optionales Feld Experiment.lift_measurement_config hinzugefügt.
  • Die Enum-Klasse ConversionLiftIncludedConversionActionTypes wurde hinzugefügt.
LiftMeasurementFlight Neue Ressource Eine neue schreibgeschützte Ressource, die Flugdetails für eine Konfiguration für die Analyse der Anzeigenwirkung enthält, einschließlich der gemessenen Start- und Enddaten des Flugs (start_date und end_date).
Allgemein
SmartCampaignError Neue Enum-Werte Es wurden neue spezifische Fehlercodes für Einschränkungen bei der Generierung von Performance Max-Kampagnen hinzugefügt:
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION Neuer Enum-Wert / Fehler Wird zurückgegeben, wenn ein Google Cloud-Projekt mit der Zugriffsebene TEST versucht, Anfragen an ein Nicht-Testkonto zu senden.
Planung
Statistiken zum Empfinden gegenüber Marken Neue Funktionen Unterstützung für Informationen zum Markensentiment in ContentCreatorInsightsService hinzugefügt:
BenchmarksService-Verbesserungen Neue Funktionen Es ist jetzt möglich, Kategorien als Filter für die Eingrenzung einer Benchmarks-Analyse zu verwenden. Außerdem werden zusätzliche geschäftskritische Messwerte unterstützt:
Targeting nach Elternstatus Neue Funktion Unterstützung für das Targeting nach Elternstatus bei der Reichweitenplanung hinzugefügt Das neue Feld parental_statuses wurde Targeting für den Dienst ReachPlanService.GenerateReachForecast hinzugefügt und parental_statuses wurde PlannableTargeting für den Dienst ReachPlanService.ListPlannableProducts hinzugefügt.
Empfehlungen
Recommendation.campaign_specific_app_goal_recommendation Neue Empfehlung Es wird vorgeschlagen, ein kampagnenspezifisches App-Conversion-Zielvorhaben hinzuzufügen. Die neue Ressource EffectiveAutomaticGoal wird verwendet, um aktuelle Ziele in dieser Empfehlung darzustellen.
Berichte
Metrics.original_conversion_value Neues Feld Der ursprüngliche Conversion-Wert aus gebotsfähigen Conversions. Das ist der nicht angepasste Wert der Conversions, bevor Anpassungen aufgrund von Wert-Regeln wie Conversion-Wert-Regeln oder Zielvorhaben für den Kundenlebenszyklus angewendet werden.
Statistiken zur Mitgliedschaft im Treuepunkteprogramm Neue Funktionen Es wurde Unterstützung für die Segmentierung von Statistiken nach dem Status des Treuepunkteprogramms für Nutzer hinzugefügt. Außerdem wurde die primäre Dimension „Treuepunkteprogramm-Mitgliedschaft“ für Conversion-Wert-Regeln hinzugefügt:
  • Das Segment Segments.loyalty_membership wurde hinzugefügt, um die Segmentierung von Berichtsmesswerten nach der Treuepunkteprogrammstufe des Nutzers zu unterstützen, der die Conversion ausführt.
  • Die primäre Dimension LOYALTY_MEMBERSHIP wurde hinzugefügt, um zu ermitteln, wann eine Bedingung für die Mitgliedschaft in einem Treuepunkteprogramm für eine Conversion-Wert-Regel erfüllt war.
Targeting
vertical_ads_item_bid Neuer Kriteriumstyp Der neue Kriterientyp vertical_ads_item_bid wurde AdGroupCriterion.criterion hinzugefügt.

Version 25 (22.07.2026)

In der Google Ads API v25, 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
Kampagnen
Eigenständige Felder additional_value und additional_high_lifetime_value in CustomerLifecycleOptimizationValueSettings Teil der Oneofs value_adjustment und high_lifetime_value_adjustment sowie der neuen Felder value_multiplier und high_lifetime_value_multiplier Struktureller Wandel Aktualisieren Sie Verweise auf diese Felder, da sie jetzt Teil von „oneofs“ sind.
Alte CustomerLifecycleGoal- und CampaignLifecycleGoal-Ressourcen, die entsprechenden Dienste CustomerLifecycleGoalService und CampaignLifecycleGoalService sowie alte Einstellungen/Enums (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings) – Entfernung Verwenden Sie das überarbeitete Schema für vereinheitlichte Zielvorhaben:
Allgemein
Verschachtelte Enum-Felder in Anfragen und Antworten des Incentive Service:
  • FetchIncentiveRequest.type
  • Incentive.type
  • IncentiveOffer.type
 Eigenständige Enum-Felder: Umbenennen / Entfernen Verwenden Sie die neuen eigenständigen Enum-Felder anstelle der alten type-Felder.
Optionale Felder selected_incentive_id und customer_id in ApplyIncentiveRequest Pflichtfelder Verhaltensänderung Achten Sie darauf, dass Sie beim Aufrufen von ApplyIncentive beide Felder angeben.
Das Feld für die E-Mail-Adresse des Verbrauchers ContactDetails.email in der Ressource LocalServicesLead – Entfernung Entfernen Sie Verweise auf dieses Feld, da es nicht mehr unterstützt wird.
Optionales Feld allowed_domain in AdvertisingPartnerLinkInvitationProperties Pflichtfeld beim Aufrufen von CreateProductLinkInvitation für einen Werbepartner Verhaltensänderung Geben Sie beim Erstellen einer Einladung für einen Produktlink für einen Werbepartner allowed_domain an.
Planung
Das Feld search_brand in GenerateCreatorInsightsRequest – Entfernung Verwenden Sie stattdessen search_topics.
Das Feld plannable_location_id in Targeting und das Feld cookie_frequency_cap in GenerateReachForecastRequest – Entfernung Wechseln Sie zur Verwendung von plannable_location_ids und cookie_frequency_cap_setting.
Berichte
Feld customer_metrics in GenerateBenchmarksMetricsResponse und BreakdownMetrics vom Typ Metrics Feld vom Typ CustomerMetrics Typänderung / Verhaltensänderung Aktualisieren Sie Ihre Integrationen, damit sie den neuen Typ CustomerMetrics verwenden. Dieser enthält nur Messwerte zur Anzeigenleistung des Kunden.

Funktionen und Updates (nicht abwärtsinkompatibel)

Funktionen und Updates Typ Beschreibung
Anzeigen
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS Neuer Enum-Wert / neues Verhalten Verfügbar für DemandGenMultiAssetAds. Wenn diese Option aktiviert ist, werden animierte Bilder mit nicht animierten Bildern als Eingabe generiert. Neue DemandGenMultiAssetAds sind ab dieser API-Version standardmäßig aktiviert.
Änderbarkeit von Informationen zu synthetischen Inhalten Verhaltensänderung Asset.synthetic_content_info und Ad.synthetic_content_info sind in Version 25, Version 24 und Version 23 jetzt vollständig veränderbar.
Kampagnen
Zielvorhaben „Kundentreue und -bindung“ Neue Funktionen / Einstellungen Unterstützung für das Zielvorhaben „Kundenbindung“ hinzugefügt. Damit können Werbetreibende Kampagnen optimieren, um Mitglieder von Treuepunkteprogrammen zu binden.
Zielvorhaben „Kundenakquisition“ Neue Funktionen / Einstellungen Aktualisierte Unterstützung für das Zielvorhaben „Kundenakquisition“ in der Google Ads API, um das überarbeitete einheitliche Zielvorhaben-Schema zu berücksichtigen:
Conversions
YouTube-Conversion-Attribution durch Drittanbieter Neue Felder Unterstützung für die Überprüfung der YouTube-Conversion-Attribution durch Drittanbieter hinzugefügt: Weitere Informationen
Allgemein
ContactDetails.phone_number_extension Neues Feld Der Ressource LocalServicesLead hinzugefügt.
IncentiveError Neue Enum-Werte / Fehler Es wurden neue spezifische Fehlercodes für Fehler beim Einlösen von Incentives hinzugefügt:
Planung
YouTube-Kanaldetails in Trendanalysen Neue Felder Es werden jetzt mehr YouTube-Kanaldetails zu ähnlichen Videos angezeigt, wenn Sie nach Trendstatistiken suchen. Die neuen Felder channel_id, channel_name und channel_url wurden YouTubeVideoAttributeMetadata hinzugefügt.
YouTubeChannelInsights.data_sharing_consent_given Neues Feld Zu YouTubeChannelInsights hinzugefügt Das ist der Fall, wenn ein Creator der Weitergabe nicht öffentlicher Daten zugestimmt hat. Wenn ja, werden die folgenden Felder ausgefüllt:
Berichte
ad_sub_format_type Neues Segment Hier finden Sie eine Aufschlüsselung der nicht überspringbaren In-Stream-Anzeigen auf YouTube nach Dauer: Dieses Segment muss immer zusammen mit ad_format_type ausgewählt werden. Sie kann mit AdGroup, AdGroupAd, Campaign, Customer, Video und VideoEnhancement ausgewählt werden.
Videospezifische Messwerte zu sozialen Netzwerken Neue Felder / Messwerte Wir haben videospezifische Social-Media-Messwerte hinzugefügt, damit Werbetreibende das Nutzer-Engagement (Kommentare, „Mag ich“-Bewertungen und Shares) für YouTube Shorts-Anzeigen besser nachvollziehen können: Sie sind in AdGroup, AdGroupAd, Asset, Campaign, Customer und Video verfügbar.

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 Google 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 wurde 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 jetzt 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_attestation (direkt vom Werbetreibenden bereitgestellte Erklärungen) und system_attestation (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 Feldern für die Bestätigung von Werbetreibenden 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änderlich.

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-Prüfungen (Autorisierung durch mehrere Parteien) 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 Trendinformationen 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 als Ziel zu verwenden.
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, wie 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 Sie herausfinden möchten, 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 zur Unterstützung von Asset-Tests, Asset-Gruppen und Performance Max-Kampagnen-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 der angeforderte tägliche, stündliche oder wöchentliche zeitliche Detaillierungsgrad 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.), Testwerte (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 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
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 – Entfernung Die Eignungseinstellung auf Kampagnenebene wurde entfernt. Markensicherheit und -eignung sind weiterhin auf Kundenebene verfügbar. Verwenden Sie stattdessen Customer.video_brand_safety_suitability.
Conversions
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS – 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 – Entfernung Zu Playlists von youtube_select_lineup_targeting wechseln
Feld is_brand_connect_creator in ContentCreatorInsightsService.GenerateCreatorInsights und GenerateTrendingInsights – 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 – Entfernung Die folgenden Plan-/Prognosefelder und ‑typen wurden entfernt: Aktualisieren Sie die Integrationen entsprechend.
Berichte
ad_sub_network_type-Segment in campaign_budget – Entfernung Das Segment ad_sub_network_type wurde für die Ressource campaign_budget entfernt.
click_type-Segment in Asset-Ansichten – 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.) und dem 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-basiertes Filtern von Produkten 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 Bestätigungen für synthetische/KI-generierte Inhalte, unterteilt in advertiser_attestation (direkt vom Werbetreibenden bereitgestellte Erklärungen) und system_attestation (Bestätigungen, die automatisch von den Systemen von Google erkannt oder bereitgestellt werden).

Damit Sie Ihre bevorstehende Integrationsarbeit für Version 25 besser planen können, wird die Schnittstelle zum Ändern von Feldern für die Bestätigung von Werbetreibenden 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änderlich.

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 von Genehmigungen durch mehrere Parteien hinzugefügt:

v23.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 Informationen zu Videoanzeigen, z. B. ob sie von Google oder vom Werbetreibenden bereitgestellt wurden. 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 Zu ReachPlanService.ListPlannableProducts hinzugefügt, wodurch youtube_select_lineups ersetzt wird. 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 Zu 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-Livestream-Vorschauen 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 in Performance Max-Kampagnen 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 Oberfläche für Demand Gen-Kampagnen mit dem Zielvorhaben „Maximale Anzahl von Conversions“ hinzugefügt.
GenerateTrendingInsights Neue Felder Beim Suchen nach Thema wurden in TrendInsightDataPoint zu TrendInsights Informationen zur historischen Trendlinie 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 zehn Mal 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 Anzeigendatenfeeds 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 – Entfernung Die Unterstützung für Anrufanzeigen wurde entfernt. 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 – 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 – 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 desselben Kanals aufrufen.
Demand Gen
DemandGenVideoResponsiveAdInfo.companion_banner Neues Feld Responsiven Videoanzeigen in Demand Gen-Kampagnen können jetzt Companion-Banner hinzugefügt werden.
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 RESPONSIVE_DISPLAY_AD unterstützt jetzt Impressions-, Leistungs- und Conversion-Messwerte.
ad_sub_network_type-Segment Neues Segment Bietet eine detaillierte Leistungsaufschlüsselung innerhalb eines Werbenetzwerks. Zuerst 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 Sie können festlegen, welche Anzeigenformate in Suchkampagnen mit Reisefeeds ausgeliefert werden dürfen.
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 Targeting 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 zur 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 Atteste 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 Atteste).

Damit Sie Ihre bevorstehende Integrationsarbeit für Version 25 besser planen können, wird die Schnittstelle zum Ändern von Feldern für die Werbetreibendenbestätigung 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änderlich.

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 von Genehmigungen 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 mit Targeting auf 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 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
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 – 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 die 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 Neukontextualisierung 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 Kampagnen mit mehreren Kanälen (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 Funktion 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.
Berichtssegmente für Performance Max-Kampagnen 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).

Archivierte Versionshinweise

Archivierte Versionshinweise finden Sie unter Eingestellte Versionen.