Versionshinweise

Eine aktuelle Liste der aktuellen und geplanten Einstellungen von Funktionen 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.2 (17.09.2026)

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

Funktionen und Updates	Typ	Beschreibung
Assets
URL-Optionen für AssetGroup	Neue Felder	Unter AssetGroup werden jetzt URL-Optionen unterstützt. So können Werbetreibende Tracking-Vorlagen, benutzerdefinierte Parameter und Suffixe für die finale URL auf Asset-Gruppenebene angeben: AssetGroup.tracking_url_template: URL-Vorlage zum Erstellen einer Tracking-URL. AssetGroup.url_custom_parameters: Eine Liste von Zuordnungen, die zum Ersetzen von benutzerdefinierten URL-Parameter-Tags in tracking_url_template, final_urls oder final_mobile_urls verwendet werden. AssetGroup.final_url_suffix: URL-Vorlage zum Anhängen von Parametern an Landingpage-URLs, die mit parallelem Tracking ausgeliefert werden.
Kampagnen
Informationen zur automatisierten Videosuche	Neue Felder und Enums	AutomatedVideoCrawlSetting wurde Campaign.AssetAutomationSetting hinzugefügt, zusammen mit AssetAutomationType.AUTOMATED_VIDEO_CRAWL. So können Sie die Einstellungen für das automatische Video-Crawling für eine Performance Max-Kampagne festlegen. AutomatedVideoCrawlSetting.automated_video_crawl_infos enthält eine Liste von AutomatedVideoCrawlInfo-Einträgen, die jeweils einen Crawl url, source_platform (VideoCrawlSourcePlatform: LANDING_PAGE, SOCIAL oder YOUTUBE) und den enabled-Opt-in-Status konfigurieren.
Fehler bei Wertmultiplikatoren für die Optimierung des Kundenlebenszyklus	Neue Enum-Werte und Fehler	Beim Konfigurieren von Wertmultiplikatoren (value_multiplier und high_lifetime_value_multiplier) für die Optimierung des Kundenlebenszyklus wurden neue Gründe für Validierungsfehler hinzugefügt: GoalError: HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER CampaignGoalConfigError: HIGH_LIFETIME_VALUE_MULTIPLIER_PRESENT_BUT_VALUE_MULTIPLIER_ABSENT HIGH_LIFETIME_VALUE_MULTIPLIER_LESS_THAN_OR_EQUAL_TO_VALUE_MULTIPLIER CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_MULTIPLIER_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE
SmartCampaignSettingService.GeneratePMaxDraftCampaign	Neue Funktion	SmartCampaignSettingService.GeneratePMaxDraftCampaign wurde hinzugefügt, um die Erstellung eines Performance Max-Kampagnenentwurfs aus einer bestehenden smarten Kampagne zu unterstützen. Die Kampagne wird mit dem Status CampaignStatus.PAUSED und dem Erstellungsstatus CampaignCreationStatus.INCOMPLETE initialisiert (siehe smarte Kampagnen in Performance Max-Kampagnen umwandeln): Setzen Sie GeneratePMaxDraftCampaignRequest.validate_only auf true, um die Conversion zu validieren und alle Validierungswarnungen oder Conversion-Probleme in GeneratePMaxDraftCampaignResponse.validated_info zu erhalten, ohne den Kampagnenentwurf zu erstellen. Lassen Sie gbp_enabled und image_enabled nicht festgelegt oder auf false. Das Festlegen auf true wird noch nicht unterstützt und gibt SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED oder SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED zurück.) GeneratePMaxDraftCampaignResponse gibt die Ressourcennamen der generierten Einheiten (pmax_campaign, campaign_budget, asset_group und assets) zusammen mit validated_info zurück.
Conversions
Firebase-Anzeigenimpressionen	Neue Conversion-Aktionstypen und ‑kategorie	Die Conversion-Aktionstypen FIREBASE_ANDROID_APP_AD_IMPRESSION und FIREBASE_IOS_APP_AD_IMPRESSION sind jetzt verfügbar. Sie können diese Conversion-Aktionen abrufen und ändern. Außerdem wurde die Kategorie IN_APP_AD_REVENUE in ConversionActionCategory eingeführt, um Einnahmen aus der In-App-Anzeigenmonetarisierung zu erfassen.
Allgemein
BusinessProfileLocationSyncError	Neue Enum-Klasse und Fehler	Es wurden zusätzliche Gründe für Synchronisierungsfehler bei Unternehmensprofil-Standorten hinzugefügt, wenn Standorte in einem LOCATION_SYNC-AssetSet synchronisiert werden. Anstatt eines generischen UNKNOWN-Fehlers gibt die API jetzt BusinessProfileLocationSyncError mit spezifischen Gründen zurück (EMAIL_INVALID, OAUTH_TOKEN_INVALID, ACCOUNT_REMOVED und NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT).
Planung
BenchmarksService.GenerateBenchmarksMetrics Perzentilmesswerte	Neue Funktionen	Die BenchmarksService.GenerateBenchmarksMetrics wurde aktualisiert, um Messwerte bereitzustellen, die die Wettbewerbsposition des Kunden im Vergleich zu anderen Werbetreibenden in Form von Perzentilrängen darstellen. Messwerte werden in PercentileMetrics im neuen Feld CustomerMetrics.percentile_metrics (sowohl für GenerateBenchmarksMetricsResponse.customer_metrics als auch für BreakdownMetrics.customer_metrics) zurückgegeben und mit BenchmarksCustomerPercentileTier dargestellt. CustomerMetrics.percentile_metrics wird nur ausgefüllt, wenn in GenerateBenchmarksMetricsRequest beide der folgenden Bedingungen erfüllt sind: PERCENTILE_DATA wird in supplemental_data angefordert. BenchmarksSource.all_advertisers wird für benchmarks_source festgelegt. Dazu muss auch category_filter angegeben werden. Unterstützung für Prozentilmesswerte für offene Quartalsdaten in ListBenchmarksAvailableDatesResponse.supported_dates (zurückgegeben von BenchmarksService.ListBenchmarksAvailableDates) hinzugefügt. Während aggregierte Kundenmesswerte (CustomerMetrics.aggregate_metrics), Kundenratenmesswerte (CustomerMetrics.average_rate_metrics) und Kundenprozentilmesswerte (CustomerMetrics.percentile_metrics) für alle Datumsangaben in supported_dates (einschließlich offener Quartale) unterstützt werden, werden Kundenanteilsmesswerte (CustomerMetrics.share_metrics) und Ratenmesswerte der Benchmark-Quelle (average_benchmarks_metrics, z. B. average_cpm von Anzeigen für „/Apparel/Clothing“) für offene Quartale nicht unterstützt und aus der Antwort ausgelassen, sofern der angeforderte date_range nicht in den engeren Bereich ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics fällt. Es wurde ein benutzerdefinierter BenchmarksError.NO_METRICS_FOUND-Fehler hinzugefügt, der angibt, dass für die ausgewählte Kombination von Eingaben keine Messwerte gefunden wurden. Dadurch wird die Nutzerfreundlichkeit verbessert.
YouTube-Kanal-Aliasse für Creator-Statistiken	Neue Funktion	Die ContentCreatorInsightsService.GenerateCreatorInsights wurde aktualisiert, sodass die Suche nach YouTube-Kanal-Handles mit YouTubeChannels.youtube_channel_handles möglich ist. Gültige Kanal-Handles müssen mit @ beginnen, z. B. @channel_handle. Diese Option ähnelt der Suche nach YouTube-Kanal-IDs. Die Antwort enthält Statistiken zu den angeforderten YouTube-Creatorn.
Empfehlungen
Empfehlungen für CPA- und ROAS-Gebote	Neue Empfehlungen	Die folgenden Parameter wurden hinzugefügt, um die Erhöhung des Ziel-CPA oder die Senkung des Ziel-ROAS zu unterstützen, wenn Gebote für Suchkampagnen zu niedrig sind, um an Auktionen teilzunehmen: Recommendation.raise_target_cpa_performance_bid_too_low_recommendationRAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOWRecommendation.lower_target_roas_performance_bid_too_low_recommendationLOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOWApplyRecommendationOperation.raise_target_cpa_performance_bid_too_lowApplyRecommendationOperation.lower_target_roas_performance_bid_too_low RaiseTargetCpaPerformanceBidTooLowRecommendation bietet recommended_target_multiplier (ein Faktor größer als 1.0) und current_average_target_cpa_micros. Wenden Sie es mit RaiseTargetCpaPerformanceBidTooLowParameters und target_cpa_multiplier an. LowerTargetRoasPerformanceBidTooLowRecommendation bietet recommended_target_multiplier (ein Faktor kleiner als 1.0) und current_average_target_roas. Wenden Sie es mit LowerTargetRoasPerformanceBidTooLowParameters und target_roas_multiplier an.
Berichte
Dimensionssegmente für Hotelreisepläne	Neue Segmente	Segments wurden die folgenden Dimensionssegmente für Hotel- und Reisebuchungen hinzugefügt (auswählbar mit campaign, ad_group und customer): Segments.advance_booking_window: Reservierungszeitraum für den Reiseplan in Tagen. Segments.length_of_booking: Buchungsdauer für den Reiseplan in Tagen. Segments.start_date: Startdatum der Buchung im Format yyyy-MM-dd. Segments.start_day_of_week: Starttag der Woche (DayOfWeek) der Buchung. Segments.user_set_dates: Gibt an, ob nutzerdefinierte Datumsangaben ausgewählt wurden (HotelDateSelectionType).
Messwerte für vertikale Anzeigen	Neue Messwerte	Für Berichte zu Anzeigen für Hotels und Reisen in Metrics wurden die folgenden Messwerte hinzugefügt (auswählbar mit campaign, ad_group und customer): Metrics.vertical_ads_average_booking_value_micros: Klickgewichteter durchschnittlicher Tagespreis in Mikroeinheiten, einschließlich Steuern und Gebühren, für die gesamte Aufenthaltsdauer bei Hotelbuchungen. Metrics.vertical_ads_potential_impressions: Gesamtzahl der möglichen Impressionen mit Ansichtsbeschränkung, die im Abfragekontext verfügbar sind. Metrics.vertical_ads_price_difference_percentage: Prozentuale Differenz zwischen dem vom Werbetreibenden angebotenen Preis und dem niedrigsten konkurrierenden Preis für dieselbe Unterkunft.
Segmente für vertikale Anzeigen	Neue Segmente	Für Berichte zu Anzeigen für Hotels und Reisen in Segments wurden die folgenden Segmente hinzugefügt (auswählbar mit campaign, ad_group und customer): Segments.vertical_ads_price_tier: Preisklasse des Werbetreibenden (HotelPriceBucket) im Vergleich zu Mitbewerbern in der Auktion. Segments.vertical_ads_rate_rule_id: Die ID der Preisregel, die der Preisregel des Werbetreibenden zugeordnet ist. Segments.vertical_ads_rate_type: Ratenart (HotelRateType) der Hotelbuchung.

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	Die 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: Es wurden neue schreibgeschützte dimensionale Ressourcen für Ergebnisse von Steigerungsstudien hinzugefügt: LiftMeasurementAgeRange, LiftMeasurementCampaign, LiftMeasurementDevice, LiftMeasurementGender und LiftMeasurementVideo. Wir haben neue Segmente und Messwerte hinzugefügt, um die Analyse der Anzeigenwirkung auf die Markenbekanntheit mit LiftMeasurementConfig und den neuen dimensionalen Ressourcen zu unterstützen. Die folgenden Enums wurden hinzugefügt: BrandLiftMeasurementType, LiftMeasurementFlightStatus, SurveyIntendedAction, SurveyLiftFlightTargetResponseMode und SurveySubjectType.
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 von 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 Start- und Enddaten des gemessenen Flights (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: VALIDATE_ONLY_GENERATE_PMAX_NOT_SUPPORTED GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED
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 zur Markenstimmung	Neue Funktionen	Unterstützung für Statistiken zum Markensentiment in ContentCreatorInsightsService hinzugefügt: Die Meldungen BrandSentimentInsight, SentimentInsightDistribution und SentimentInsightSummary wurden hinzugefügt. Die Enum-Klasse Sentiment wurde hinzugefügt. Der Wert BRAND_SENTIMENT_DATA wurde dem Enum ContentCreatorInsightsSupplementalData hinzugefügt. Der Wert BRAND wurde dem Enum InsightsKnowledgeGraphEntityCapabilities hinzugefügt.
BenchmarksService-Optimierungen	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: Es wurde eine Option hinzugefügt, mit der Sie die Leistung mit allen Werbetreibenden vergleichen können, die Anzeigen in einer oder mehreren Produkt- und Dienstleistungskategorien schalten. Dazu verwenden Sie BenchmarksService.GenerateBenchmarksMetrics und category_filter. Es werden mehr Anzeigenmesswerte für Kunden angezeigt, z. B. die Gesamtkosten und ‑aufrufe des Kunden, sowie Messwerte wie share_of_voice. Messwerte werden mit AggregateMetrics und ShareMetrics zurückgegeben. Die Liste der unterstützten Kategorien kann mit BenchmarksService.ListBenchmarksSources und dem Quelltyp CATEGORY abgerufen werden.
Targeting nach Elternstatus	Neue Funktion	Unterstützung des Elternstatus-Targetings bei der Reichweitenplanung Das neue Feld parental_statuses wurde Targeting für den Dienst ReachPlanService.GenerateReachForecast und parental_statuses für den Dienst ReachPlanService.ListPlannableProducts in PlannableTargeting hinzugefügt.
Empfehlungen
Recommendation.campaign_specific_app_goal_recommendation	Neue Empfehlung	Es wird vorgeschlagen, ein kampagnenspezifisches App-Conversion-Zielvorhaben hinzuzufügen. Die neue EffectiveAutomaticGoal-Ressource wird verwendet, um aktuelle Zielvorhaben 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 Stufe des Treuepunkteprogramms 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 wurde.
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 Google Ads API v25, einem Hauptrelease, 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
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: Verwenden Sie das Feld new_customer_acquisition_goal_settings in der Ressource Goal. Verwenden Sie das Feld campaign_new_customer_acquisition_settings in der Ressource CampaignGoalConfig, um kampagnenspezifische Überschreibungen zu konfigurieren.
Allgemein
Verschachtelte Enum-Felder in Anfragen und Antworten des Incentive Service: FetchIncentiveRequest.type Incentive.type IncentiveOffer.type	Eigenständige Enum-Felder: FetchIncentiveRequest.incentive_type Incentive.incentive_type IncentiveOffer.offer_type	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 allowed_domain an, wenn Sie eine Einladung für einen Produktlink für einen Werbepartner erstellen.
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
customer_metrics-Feld 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, die die Anzeigenleistung des Kunden darstellen.

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. Ab dieser API-Version sind neue DemandGenMultiAssetAds 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, mit dem Werbetreibende Kampagnen für die Bindung von Treuepunkteprogramm-Mitgliedern optimieren können. LOYALTY_RETENTION wurde dem Enum GoalType hinzugefügt. CampaignGoalConfig.campaign_loyalty_retention_settings wurde hinzugefügt, um kampagnenspezifische Einstellungen für die Kundenbindung im Treuepunkteprogramm zu konfigurieren, einschließlich Gebotsanpassungen und der Anzeige von Vorteilen für Mitglieder im PLA-Format. Goal.loyalty_retention_goal_settings wurde hinzugefügt, um Einstellungen für das Zielvorhaben „Kundenbindung“ auf Kontoebene zu konfigurieren. Neue Fehlercodes hinzugefügt: LOYALTY_RETENTION_GOAL_INVALID_MODE CANNOT_USE_INCOMPATIBLE_CLO_GOALS LOYALTY_RETENTION_GOAL_ALREADY_EXISTS
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: Die Ressource Goal wurde erweitert, um Einstellungen für die Kundenakquisition mit dem Feld new_customer_acquisition_goal_settings zu unterstützen. Die CampaignGoalConfig-Ressource wurde erweitert, um kampagnenspezifische Überschreibungen für die Kundenakquisition mit dem Feld campaign_new_customer_acquisition_settings zu unterstützen. Die neue Enum CustomerLifecycleOptimizationGoalSubType wurde hinzugefügt, um unterstützte Zielvorhaben-Untertypen zu definieren. NEW_CUSTOMER_ACQUISITION wurde der Enum-Klasse GoalType hinzugefügt. Der GoalError-Dokumentation wurden neue Gründe für Validierungsfehler hinzugefügt: NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS Der CampaignGoalConfigError-Dokumentation wurden neue Gründe für Validierungsfehler hinzugefügt: CAMPAIGN_OVERRIDE_VALUES_SET_FOR_NEW_CUSTOMER_ACQUISITION_TARGET_SPECIFIC_OPTION CAMPAIGN_OVERRIDE_HIGH_LIFETIME_VALUE_NOT_SUPPORTED_FOR_CAMPAIGN_TYPE CANNOT_USE_INCOMPATIBLE_CLO_GOALS ErrorDetails.incompatible_clo_goal_error_details wurde hinzugefügt, um die neue Struktur IncompatibleCloGoalsErrorDetails für Validierungsfehler verfügbar zu machen.
Conversions
Conversion-Attribution durch Drittanbieter auf YouTube	Neue Felder	Unterstützung für die Überprüfung der YouTube-Conversion-Attribution durch Drittanbieter hinzugefügt: CustomerThirdPartyIntegrationPartners.conversion_attribution_integration_partners wurde hinzugefügt, um die Konfiguration von Integrationspartnern auf Kundenebene zu ermöglichen. CampaignThirdPartyIntegrationPartners.conversion_attribution_integration_partners wurde hinzugefügt, um die Konfiguration von Integrationspartnern auf Kampagnenebene zu ermöglichen. Weitere Informationen finden Sie in diesem Hilfeartikel.
Allgemein
ContactDetails.phone_number_extension	Neues Feld	Der Ressource LocalServicesLead hinzugefügt.
IncentiveError	Neue Enum-Werte und Fehler	Es wurden neue spezifische Fehlercodes für Fehler beim Einlösen von Prämien hinzugefügt: BILLING_COUNTRY_NOT_ELIGIBLE (das Land der Rechnungsadresse des Kunden ist nicht für den Incentive berechtigt) USER_IS_MCC_MANAGER (der Nutzer hat ein Verwaltungskonto und kann den Incentive nicht einlösen) USER_SUSPENDED (das Kundenkonto wurde gesperrt) MAX_PENDING_INCENTIVES (der Kunde hat die maximal zulässige Anzahl ausstehender Prämien erreicht) ACCOUNT_HAD_RECENT_SPEND (das Konto hatte in letzter Zeit Ausgaben und ist nicht berechtigt) MAX_INCENTIVES_REDEEMED_FROM_OFFER (der Kunde hat bereits die maximale Anzahl an Prämien aus diesem Angebot eingelöst) MISMATCHING_BILLING_COUNTRY_CODE (der in der Anfrage angegebene Ländercode für das Land der Rechnungsadresse stimmt nicht mit dem Land des Kundenkontos überein)
Planung
Details zum YouTube-Kanal in Trendstatistiken	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 zu 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: average_views_per_video average_likes_per_video average_comments_per_video engagement_rate channel_audience_attributes
Berichte
ad_sub_format_type	Neues Segment	Hier finden Sie eine Aufschlüsselung der nicht überspringbaren In-Stream-Anzeigen auf YouTube nach Dauer: INSTREAM_NON_SKIPPABLE_STANDARD (In-Stream-Anzeige mit Standarddauer, nicht überspringbar) INSTREAM_NON_SKIPPABLE_MAX30_SEC (nicht überspringbare In-Stream-Anzeige mit einer Länge von maximal 30,99 Sekunden) INSTREAM_NON_SKIPPABLE_MAX60_SEC (nicht überspringbare In-Stream-Anzeige mit einer Länge von maximal 60,99 Sekunden) 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 soziale Messwerte	Neue Felder / Messwerte	Wir haben videospezifische Social-Media-Messwerte hinzugefügt, damit Werbetreibende das Nutzer-Engagement (Kommentare, Likes und Shares) für Shorts-Anzeigen auf YouTube nachvollziehen können: Metrics.youtube_comments Metrics.youtube_likes Metrics.youtube_shares 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 Breaking Changes.

Version 24.2 (24.06.2026)

Die folgenden neuen Funktionen und Aktualisierungen wurden in der Google Ads API v24.2 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 (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 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	Diese Conversions werden erfasst, 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	Enthalten Bestätigungen für synthetische/KI-generierte Inhalte, aufgeteilt 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 sind diese Felder vollständig veränderbar. Wir empfehlen, die Schnittstelle jetzt zu verwenden, um Ihre interne Logik zu entwickeln und zu testen, damit Ihr System bereit ist, wenn Version 25 eingeführt wird.
Genehmigung durch mehrere Parteien	Neue Funktionen	Beta:Diese Funktion befindet sich derzeit in der Betaphase und kann sich in zukünftigen Releases ändern. Unterstützung für Überprüfungen über eine Autorisierung durch mehrere Parteien hinzugefügt: Die Ressource MultiPartyAuthReview und die entsprechende MultiPartyAuthReviewService wurden hinzugefügt. Die Enum MultiPartyAuthReviewStatus wurde hinzugefügt, um den Überprüfungsstatus zu erfassen. CustomerUserAccess.pending_multi_party_auth_review wurde hinzugefügt, um auf eine ausstehende Rezension zu verweisen. MutateCustomerUserAccessResult.multi_party_auth_review und MutateCustomerUserAccessInvitationResult.multi_party_auth_review wurden hinzugefügt, um den zugehörigen Ressourcennamen der Rezension zurückzugeben. MultiPartyAuthReviewError für Validierungsfehler 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, wird jetzt nicht mehr der Fehler AuthenticationError.INVALID_EMAIL_ADDRESS ausgegeben, sondern stattdessen werden die Standardangebote für Anreize zurückgegeben.
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	InsightsKnowledgeGraphEntityCapabilities wurde 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 in der Antwort zusätzliche Standorte oder Erstellerattribute ausgegeben.
local_creator_insights related_local_creators	Neue Felder	Wird ausgefüllt, wenn supplemental_data die Enumeration LOCAL_CREATOR_DATA enthält. Zeigt lokale Creator an, 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 Trends suchen, indem Sie das Land und untergeordnete Orte angeben.
Berichte
PerformanceMaxPlacementView	Segmenterweiterung	Segmentierbar gemacht von 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, auf eine Sprache auszurichten, die nicht zulässig ist.
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 können, 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	Konfigurationsunterstützung 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 vertikale 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.), Testgruppenwerte (clicks usw.), Punktschätzungen (clicks_point_estimate usw.), Fehlermargen (clicks_margin_of_error usw.) und p-Werte (clicks_p_value usw.) für sieben wichtige Messwertfamilien (Klicks, Impressionen, Kosten, Conversions, Cost-per-Conversion, Conversion-Wert, Conversion-Wert pro Kosten) hinzugefügt.
Messwerte für die absolute Änderung bei Conversions	Neue Felder	Unterstützung für Conversions-Schätzungen der absoluten Differenz mit den Feldern „Punktschätzung“, „Schwankungsintervall“ und „p-Wert“.
Targeting
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS	Neuer Enum-Wert / Fehler	Wird zurückgegeben, wenn versucht wird, alle demografischen Ausrichtungen auszuschließen.
Videos
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR	Neuer Enum-Wert	ZEFR wurde als Drittanbieter-Integrationspartner für Sichtbarkeit 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, 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
Optional videos und logo_images in DemandGenVideoResponsiveAdInfo	Pflichtfelder	Verhaltensänderung	Geben Sie videos und logo_images an, wenn Sie responsive Demand Gen-Videoanzeigen erstellen oder ändern.
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 von typisierten Clientbibliotheken müssen aktualisiert werden, damit die neuen Ressourcennamespaces verwendet werden.
Feld youtube_select_lineups in ReachPlanService.ListPlannableProducts	–	Entfernung	Zu Line-ups 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 verfügbar hat.
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: CampaignToForecast.keyword_plan_network CampaignToForecast.negative_keywords und ForecastAdGroup.negative_keywords ForecastAdGroup.max_cpc_bid_micros BiddableKeyword CriterionBidModifier KeywordForecastMetrics.impressions KeywordForecastMetrics.click_through_rate Integrationen entsprechend aktualisieren
Berichte
ad_sub_network_type-Segment in campaign_budget	–	Entfernung	Das Segment ad_sub_network_type für die Ressource campaign_budget wurde 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 es wird ein Fehler ausgegeben, wenn eine ID darin die Validierung nicht besteht.
ShareablePreviewError-Legacy-Codes: ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER TOO_MANY_ASSET_GROUPS_IN_REQUEST	MutateErrorEnum.RESOURCE_NOT_FOUND ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST	Umbenennung / Verhaltensänderung	Fehlercodes, die für Asset-Gruppen zurückgegeben werden, werden 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 wurde eine Funktion zum Abrufen von Attributen für Reisefeed-Assets (hotel_center_account_id, merchant_center_id, partner_center_id, subset_id, travel_feed_vertical_type) hinzugefügt.
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	Neue GA4-/Firebase-Conversion-Aktionstyp-Enums in ConversionActionType 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	Wir haben ProductCoreAttributes unter ListPlannableProductsResponse eine planbare Produktbeschreibung, ein Marketingziel, ein Kostenmodell und eine Kaufmethode hinzugefügt.
Berichte
CartDataSalesView	Neue Berichtsressource	Hier werden Berichte bereitgestellt, in denen Conversion-Messwerte nach dem verkauften Produkt (Marke usw.) und dem angeklickten Produkt segmentiert sind.
Nicht gebotsfähige Messwerte	Neue Felder	Allen übereinstimmenden Ressourcen wurden nicht gebotsfähige Messwerte (Messwerte für Conversions, für die Kampagnen nicht optimiert werden) hinzugefügt: all_average_cart_size all_average_order_value_micros all_cost_of_goods_sold_micros all_cross_sell_cost_of_goods_sold_micros all_cross_sell_gross_profit_micros all_cross_sell_revenue_micros all_cross_sell_units_sold all_gross_profit_margin all_gross_profit_micros all_lead_cost_of_goods_sold_micros all_lead_gross_profit_micros all_lead_revenue_micros all_lead_units_sold all_orders all_revenue_micros all_units_sold
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 Mengenausdrücken eingeführt: Die Kriterientypen RETAIL_FILTER_BUNDLE und RETAIL_FILTER wurden hinzugefügt. Der Typ des freigegebenen Satzes RETAIL_FILTER wurde hinzugefügt. AdGroupCriterion wurde das Feld retail_filter_bundle hinzugefügt. SharedCriterion wurde das Feld retail_filter hinzugefügt. „RETAIL“ wurde zu ListingGroupFilterListingSource hinzugefügt. Die Dimension RetailFilter wurde AssetGroupListingGroupFilter hinzugefügt. Es wurden zugehörige neue Validierungsfehler in CriterionError und AssetGroupListingGroupFilterError hinzugefügt. 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 sind diese Felder vollständig veränderbar. Wir empfehlen, die Schnittstelle jetzt zu verwenden, um Ihre interne Logik zu entwickeln und zu testen, damit Ihr System bereit ist, wenn Version 25 eingeführt wird.
Genehmigungen durch mehrere Parteien	Neue Funktionen	Beta:Diese Funktion befindet sich derzeit in der Betaphase und kann sich in zukünftigen Releases ändern. Unterstützung für MPA-Prüfungen (Genehmigung durch mehrere Parteien) hinzugefügt: Die Ressource MultiPartyAuthReview und die entsprechende MultiPartyAuthReviewService wurden hinzugefügt. Die Enum MultiPartyAuthReviewStatus wurde hinzugefügt, um den Überprüfungsstatus zu erfassen. CustomerUserAccess.pending_multi_party_auth_review wurde hinzugefügt, um auf eine ausstehende Rezension zu verweisen. MutateCustomerUserAccessResult.multi_party_auth_review und MutateCustomerUserAccessInvitationResult.multi_party_auth_review wurden hinzugefügt, um den zugehörigen Ressourcennamen der Rezension zurückzugeben. MultiPartyAuthReviewError für Validierungsfehler 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 Informationen zu Videoanzeigen, die für die Optimierung spezifisch sind, 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 leistungsstarken 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 hinzugefügt.
Kampagnen
AdGroupAd.start_date_time AdGroupAd.end_date_time	Neue Felder	Detailliertere Planungsbedingungen für die Kampagnenlaufzeit 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 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	Es wurde Unterstützung für benutzerdefinierte UND/ODER-Kombinationen von Entitäten, 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 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 wurde als Option für die Ausrichtung 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, die auf die EU ausgerichtet ist, 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. In text_guidelines können Sie term_exclusions und messaging_restrictions definieren.
CampaignPrimaryStatusReason	Neue Enum-Werte	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 die Kategorie „Unbestimmt“ in demografischen Dimensionen auszurichten.
Incentives
IncentiveErrorEnum	Neue Enum-Werte / Fehler	Zwei neue Fehlercodes 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 BreakdownDefinition hinzugefügt.
ReachPlanService.GenerateReachForecast	Neuer Enum-Wert	GOOGLE_DISPLAY_NETWORK wurde als ausrichtbare Anzeigenumgebung für Demand Gen-Kampagnen mit dem Zielvorhaben „Maximale Anzahl von Conversions“ hinzugefügt.
GenerateTrendingInsights	Neue Felder	Beim Suchen nach Thema wurden in TrendInsightDataPoint die Informationen zur bisherigen Trendlinie für 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 erlaubt	AdGroupAdError.AD_SHARING_NOT_ALLOWED	Verhaltensänderung	Die gemeinsame Nutzung von Anzeigen in mehreren Anzeigengruppen ist nicht mehr zulässig. Bei Anfragen, mit denen versucht wird, 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 die Verweise in Ihrem Code.
Berichte
Messwerte und Enum für das Leistungslabel für Assets zusammenfassen	–	Entfernung	Messwerte für das Leistungslabel „Gesamtleistung von Assets“ entfernt. Die Enumeration für das 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	Neue Formattypen hinzugefügt: TEXT, VERTICAL_ADS_BOOKING_LINK und VERTICAL_ADS_PROMOTION.
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	Die Attribute 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 wurden für Assets hinzugefügt, die als Sitelinks ausgeliefert werden.
BusinessMessageAsset	Neue Funktionen / Unterstützung	Aktualisierte Assets für Nachrichten an das Unternehmen: Unterstützung für Facebook Messenger und Zalo als Anbieter hinzugefügt. FACEBOOK_MESSENGER und ZALO wurden zu BusinessMessageProvider hinzugefügt. Die Felder facebook_messenger_info und zalo_info wurden hinzugefügt. CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS wurde zu AssetError hinzugefügt.
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	Companion-Banner werden jetzt in responsiven Videoanzeigen für Demand Gen-Kampagnen unterstützt.
Incentives
Unterstützung für CYO-Incentives (Choose Your Own) hinzugefügt: Die Methode FetchIncentive wurde hinzugefügt, um verfügbare personalisierte Anreize für einen Nutzer abzurufen. Die Methode ApplyIncentive wurde hinzugefügt, um einen ausgewählten Incentive auf ein Kundenkonto anzuwenden. Die Ressource AppliedIncentive (abfragbar mit Search und SearchStream) wurde hinzugefügt, um Einlösungsdetails bereitzustellen. Neue Fehlercodes in IncentiveError und AuthenticationError.INVALID_EMAIL_ADDRESS hinzugefügt. Um eine detailliertere programmatische Verarbeitung von Fehlern zu ermöglichen, werden wir in zukünftigen Releases 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ächensteuerungen (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 neuer 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. 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 neuer 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 neuer 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
Branchenspezifische 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 in SharedCriterion hinzugefügt, um die Ausrichtung auf 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 Datenfeeddimensionen für vertikale Anzeigen segmentieren.
Videos
AdVideoAssetInfo.ad_video_asset_feature_control	Neues Feld	Es wurden zusätzliche 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 für die Hörbarkeit auf YouTube	Neue Messwerte	Es wurden Messwerte für die Hörbarkeit von Audioanzeigen auf YouTube hinzugefügt. Damit lässt sich nachvollziehen, 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 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 sind diese Felder vollständig veränderbar. Wir empfehlen, die Schnittstelle jetzt zu verwenden, um Ihre interne Logik zu entwickeln und zu testen, damit Ihr System bereit ist, wenn Version 25 eingeführt wird.
Genehmigungen durch mehrere Parteien	Neue Funktionen	Beta:Diese Funktion befindet sich derzeit in der Betaphase und kann sich in zukünftigen Releases ändern. Unterstützung für MPA-Prüfungen (Genehmigung durch mehrere Parteien) hinzugefügt: Die Ressource MultiPartyAuthReview und die entsprechende MultiPartyAuthReviewService wurden hinzugefügt. Die Enum MultiPartyAuthReviewStatus wurde hinzugefügt, um den Überprüfungsstatus zu erfassen. CustomerUserAccess.pending_multi_party_auth_review wurde hinzugefügt, um auf eine ausstehende Rezension zu verweisen. MutateCustomerUserAccessResult.multi_party_auth_review und MutateCustomerUserAccessInvitationResult.multi_party_auth_review wurden hinzugefügt, um den zugehörigen Ressourcennamen der Rezension zurückzugeben. MultiPartyAuthReviewError für Validierungsfehler hinzugefügt.

Version 22.1 (25.02.2026)

In der Google Ads API v22.1 wurde die folgende neue Funktion hinzugefügt. 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, die auf die EU ausgerichtet ist, 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 Angaben dazu gemacht wurden, ob sie politische Werbung enthalten, die auf die EU ausgerichtet ist.

v22 (15.10.2025)

In der Google Ads API v22, 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
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
Leistungslabel für Assets	–	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 sich die Kampagnen ohne Angabe eines Zielwerts optimieren lassen: OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: Mit der Standardstrategie „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 Anteil an Impressionen“ hinzugefügt.
Campaign.feed_types	Neues Feld	Hier sehen Sie die Typen der Feeds, die einer Kampagne zugeordnet 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 war möglich, freigegebene Sets mit auszuschließenden Keywords an mehrere Kanäle (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: Ziel-CPC auf Kampagnenebene mit Campaign.target_cpc festlegen und auf Anzeigengruppenebene mit AdGroup.target_cpc_micros überschreiben.
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 die 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 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 Aktivierungsratenlimit für Zahlungsprofile ü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: Ermöglicht 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. Akzeptanz der Nutzungsbedingungen, 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 aufgenommen, 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 in 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-Ausrichtungskombinationen.
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 neuer 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 explorative Abfragecluster	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. die Erweiterung ohne Keywords für AI Max für Suchkampagnen.
Shopping
Shopping-Bereich korrigieren	Fehlerkorrektur	Der Kampagnen- und Anzeigengruppenbereich von Messwerten in der Ressource ShoppingProduct 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 Wiedergabezeit von Videos	Neue Felder	Es wurden 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.