Versionshinweise

Eine Liste der derzeit und künftig eingestellten Funktionen, die auf dem neuesten Stand ist, finden Sie unter Eingestellte Funktionen.

v26-Hauptversion

Die Google Ads API v26 enthält die folgenden neuen Funktionen, Updates und funktionsgefährdende Änderungen.

v26 (14.10.2026)

Die folgenden neuen Funktionen, Aktualisierungen und funktionsgefährdenden Änderungen wurden in Google Ads API v26 hinzugefügt, einer Hauptversion.

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

Funktionsgefährdende Änderungen

Ausgangszustand	Neuer Status	Art der Änderung	Implementierungsleitfaden
Kampagnen
Optionales country_code-Feld in LocalServicesPmaxCampaignSettings	Pflichtfeld beim Erstellen einer Performance Max-Kampagne für Google Lokale Dienstleistungen (LocalServicesPmaxCampaignSettings.country_code)	Verhaltensänderung	Geben Sie beim Erstellen von Performance Max-Kampagnen für lokale Dienstleistungen country_code (zusammen mit dem neu erforderlichen listing_id) an.
Conversions
Das Feld enhanced_conversions_for_leads_enabled in ConversionTrackingSetting (Customer.conversion_tracking_setting)	–	Entfernung	Verwenden Sie stattdessen ConversionTrackingSetting.enablement_setting für Customer.conversion_tracking_setting, um die Einstellung für erweiterte Conversions auf Kontoebene zu prüfen.
Targeting
Hotelspezifische Kriterienfelder in AdGroupBidModifier: hotel_date_selection_type hotel_advance_booking_window hotel_length_of_stay (min_nights und max_nights) hotel_check_in_day hotel_check_in_date_range	Branchenunabhängige Kriterienfelder in AdGroupBidModifier: user_set_dates vom Typ UserSetDatesInfo advance_booking_window vom Typ AdvanceBookingWindowInfo length_of_booking vom Typ LengthOfBookingInfo (min_days und max_days) start_day_of_week vom Typ StartDayOfWeekInfo start_date_range vom Typ StartDateRangeInfo	Umbenennen / Entfernen	Aktualisieren Sie die Verweise, um die branchenunabhängigen Kriterienfelder zu verwenden, die das Targeting auf andere Reisebranchen als Hotels (z. B. „Mögliche Aktivitäten“) unterstützen. Kriterien-IDs, Ausrichtungsverhalten und vorhandene Gebotsanpassungen bleiben unverändert. Die Werte für min_nights und max_nights werden unverändert in min_days und max_days übernommen.
HotelDateSelectionType und Typ segments.user_set_dates	DateSelectionType	Umbenennen / Typ ändern	Verwenden Sie DateSelectionType anstelle von HotelDateSelectionType.
Hotelspezifische Fehlerursachen in CriterionError: HOTEL_LENGTH_OF_STAY_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_CHECK_IN_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION HOTEL_CHECK_IN_DATE_RANGE_START_DATE_TOO_EARLY HOTEL_CHECK_IN_DATE_RANGE_END_DATE_TOO_LATE HOTEL_CHECK_IN_DATE_RANGE_REVERSED	Branchenunabhängige Fehlerursachen in CriterionError: LENGTH_OF_BOOKING_OVERLAPS_WITH_EXISTING_CRITERION ADVANCE_BOOKING_WINDOW_OVERLAPS_WITH_EXISTING_CRITERION START_DATE_RANGE_OVERLAPS_WITH_EXISTING_CRITERION START_DATE_RANGE_START_DATE_TOO_EARLY START_DATE_RANGE_END_DATE_TOO_LATE START_DATE_RANGE_REVERSED	Umbenennen	Aktualisieren Sie die Fehlerbehandlung, um die neuen vertikalunabhängigen Fehlerursachen zu berücksichtigen.

Funktionen und Updates (nicht funktionsgefährdend)

Funktionen und Updates	Typ	Beschreibung
Assets
Anbieter von LINE- und SMS-Nachrichten an Unternehmen	Neue Felder und Enum-Werte	Unterstützung für LINE und SMS als Nachrichtenanbieter in BusinessMessageAsset hinzugefügt, einschließlich der neuen Felder BusinessMessageAsset.line_info und BusinessMessageAsset.sms_info sowie BusinessMessageProvider.LINE und BusinessMessageProvider.SMS.
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY	Neuer Enum-Wert / Fehler	Wurde AssetGroupError hinzugefügt, um anzugeben, wann eine in GoogleLocalServicesInfo (AssetGroup.google_local_services_info) angegebene Kategorie für Performance Max-Kampagnen für lokale Dienstleistungen nicht unterstützt wird.
Kampagnen
Performance Max-Kampagnen für lokale Dienstleistungen erstellen	Neue Funktionen, Felder und Fehler	PmaxCampaignSettings.local_services_enabled wurde von OUTPUT_ONLY auf IMMUTABLE aktualisiert, sodass externe API-Clients beim Erstellen neuer Performance Max-Kampagnen für Google Lokale Dienstleistungen local_services_enabled = true angeben können. Außerdem wurde LocalServicesPmaxCampaignSettings.listing_id hinzugefügt, um die ID des Google Unternehmensprofil-Eintrags offenzulegen, der mit der Performance Max-Kampagne für lokale Dienstleistungen verknüpft ist (beim Erstellen der Performance Max-Kampagne für lokale Dienstleistungen als ERFORDERLICH gekennzeichnet). Außerdem wurde der Fehlercode CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID hinzugefügt.
Validierungsfehler bei Kampagnen für lokale Dienstleistungen	Neue Enum-Werte und Fehler	Es wurden neue Validierungsfehler für Kampagnen für lokale Dienstleistungen hinzugefügt: CampaignError: LOCAL_SERVICES_MULTIPLE_PERFORMANCE_MAX_CAMPAIGNS_NOT_ALLOWED LOCAL_SERVICES_AGREEMENT_REQUIRED AssetSetLinkError: LOCATION_ASSET_DOES_NOT_MATCH_CAMPAIGN_LISTING_ID CampaignConversionGoalError und CampaignGoalConfigError: CANNOT_UNLINK_LOCAL_SERVICES_GOAL_FROM_LOCAL_SERVICES_CAMPAIGN GOAL_NOT_ALLOWED_FOR_LOCAL_SERVICES_CAMPAIGN LOCAL_SERVICES_GOAL_NOT_ALLOWED_FOR_NON_LOCAL_SERVICES_CAMPAIGN ConversionGoalCampaignConfigError: CANNOT_DISABLE_CAMPAIGN_OVERRIDE_GOALS_FOR_LOCAL_SERVICES_CAMPAIGN
Validierung der Verknüpfung mit dem Hotel Center-Konto	Neuer Enum-Wert / Fehler	Der Fehlercode CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED wurde zu CampaignError hinzugefügt, um anzugeben, dass für die Verknüpfung einer Asset-Sammlung für Hotelunterkünfte (Campaign.hotel_property_asset_set) mit einer Performance Max-Kampagne für die Reisebranche eine aktive Hotel Center-Kontoverknüpfung erforderlich ist.
Mindestbudget pro Tag für Demand Gen-Kampagnen	Neues Feld	Das Feld demand_gen_info.minimum_budget_per_day_micros wurde CurrencyConstant hinzugefügt. Es gibt das erforderliche Mindestbudget pro Tag für Demand Gen-Kampagnen in dieser Währung an. Der Wert dieses Felds wird aktualisiert, wenn sich das von der API erzwungene Mindestbudget ändert.
Konfiguration der Analyse der Anzeigenwirkung für Kampagnen	Neues Feld	Campaign.lift_measurement_config wurde hinzugefügt, um den Ressourcennamen der Konfiguration für die Analyse der Anzeigenwirkung offenzulegen, die mit der Kampagne verknüpft ist.
Validierung von AI Max-Tests	Neuer Enum-Wert / Fehler	Der Fehlercode ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED wurde zu ExperimentArmError hinzugefügt, wenn versucht wird, einen ADOPT_AI_MAX-Test für eine Kampagne zu erstellen, für die AI Max bereits aktiviert ist (oder in derselben Anfrage vor dem Erstellen der Testverzweigung aktiviert wird).
Eintragstyp für Shopping-Kampagnen	Erweiterter Support	Erweiterte Unterstützung von Campaign.listing_type für Shopping-Kampagnen.
Aktualisierungen der Selbstdeklaration für politische Werbung in der EU	Aktualisiertes Verhalten und neue Felder	Campaign.contains_eu_political_advertising ist jetzt für einige Kampagnen optional, die nicht auf die Europäische Union ausgerichtet sind. Mit Ausnahme von DEMAND_GEN-Kampagnen mit aktualisierter Ausrichtung ist das Feld optional, wenn eine Kampagne nach der Ausführung der Anfrage alle folgenden Bedingungen erfüllt: Enthält kein positives Kampagnenkriterium für die Ausrichtung auf Standorte innerhalb der EU Enthält kein Kampagnenkriterium für die Ausrichtung auf die Umgebung oder Standortgruppen Enthält mindestens ein positives Kampagnenkriterium für Standorte außerhalb der EU Bei DEMAND_GEN-Kampagnen mit upgraded_targeting ist das Feld optional, wenn jede aktive Anzeigengruppe in der Kampagne nach Ausführung der Anfrage alle folgenden Bedingungen erfüllt: Enthält kein Kriterium für die Anzeigengruppe mit einzuschließenden Standorten, das sich innerhalb der EU befindet Enthält kein Kriterium für Anzeigengruppen mit positiver Nähe oder Standortgruppe Enthält mindestens ein positives geografisches Anzeigengruppenkriterium, das sich außerhalb der EU befindet Das Feld ist auch für Kampagnen ohne aktive Anzeigengruppen optional. Wenn durch eine Anfrage eine Anzeigengruppe erstellt wird, die diese Bedingungen nicht erfüllt, wird AdGroupError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION zurückgegeben. Diese Änderungen gelten sowohl für neue als auch für bestehende Kampagnen. In einigen Fällen kann eine neue Kampagne nur erstellt werden, wenn in derselben Anfrage Kriterien hinzugefügt werden. Verwenden Sie GoogleAdsService.Mutate, um Mutate-Vorgänge zu gruppieren. Campaign.missing_eu_political_advertising_declaration wurde aktualisiert, um den Änderungen an Campaign.contains_eu_political_advertising zu entsprechen. GeoTargetConstant.require_eu_political_advertising_declaration wurde hinzugefügt, um anzugeben, ob sich ein Standort innerhalb oder außerhalb der EU befindet. CampaignCriterion.require_eu_political_advertising_declaration und AdGroupCriterion.require_eu_political_advertising_declaration wurden hinzugefügt. Campaign.contains_eu_political_advertising ist erforderlich, wenn dieses Feld für ein Kriterium auf Kampagnenebene in der Kampagne (oder für ein aktives Kriterium auf Anzeigengruppenebene in DEMAND_GEN-Kampagnen mit aktualisiertem Targeting) den Wert true hat. Die Felder geben true zurück, wenn das Feld negative des Kriteriums false ist und das Kriterium ein Standort innerhalb der EU, ein Umkreis (unabhängig davon, ob er sich mit EU-Gebiet überschneidet) oder eine Standortgruppe (unabhängig davon, ob sie sich mit EU-Gebiet überschneidet) ist.
Conversions
Einheitliche Konfiguration für erweiterte Conversions	Neue Felder und Enum	ConversionTrackingSetting.enablement_setting und ConversionTrackingSetting.effective_enablement_setting (in Customer.conversion_tracking_setting) wurden hinzugefügt, um die einheitliche Konfiguration für erweiterte Conversions für das Konto offenzulegen, die mit der neuen Aufzählung EnhancedConversionsConfig dargestellt wird.
ConversionActionCategory.MESSAGE_LEAD	Neuer Enum-Wert	Wurde zu ConversionActionCategory hinzugefügt, um Nachrichten- oder Chatinteraktionen zu unterstützen, die auf Interesse am Angebot eines Werbetreibenden hinweisen.
ConversionAttributionEventType.CLICK	Neuer Enum-Wert	Wurde zu ConversionAttributionEventType hinzugefügt, um Conversions darzustellen, die einem Anzeigenklick zugeordnet werden und zuvor im Enum-Wert UNKNOWN enthalten waren.
Allgemein
Aktualisierungen zu Anfragen aus Google Lokale Dienstleistungen	Neues Feld und neuer Enum-Wert	Das Feld LocalServicesLead.campaign wurde der Ressource LocalServicesLead hinzugefügt, um einen Lead mit der zugehörigen Kampagne zu verknüpfen. COUPON wurde zu LocalServicesLeadType hinzugefügt, um Gutschein-Lead-Typen für lokale Dienste zu unterstützen.
Empfehlungen
Empfehlung „Budget erhöhen“ für die Suche	Neue Empfehlung	RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW, Recommendation.raise_budget_performance_too_low_recommendation und ApplyRecommendationOperation.raise_budget_performance_too_low wurden hinzugefügt, um Budgeterhöhungen zu unterstützen, wenn die Tagesbudgets für Suchkampagnen zu niedrig sind.
Berichte
Messungen des Suchanstiegs	Neue Funktionen, Ressourcen, Segmente und Messwerte	Unterstützung für Messungen des Suchanstiegs hinzugefügt: Es wurde eine neue Ressource mit Lesezugriff SearchLiftKeywordBundle hinzugefügt, die ein Keyword-Bundle in einer Suchanstiegsanalyse darstellt. Es wurden neue auswählbare Segmente (segments.search_lift_keyword_bundle und segments.search_property) und 15 neue Messwerte für den Suchanstieg (z. B. relative_search_lift, normalized_incremental_searches, search_lift_cost_micros und search_lift_impressions) hinzugefügt, um die Analyse des Suchanstiegs mit LiftMeasurementConfig (verknüpft mit Kampagnen, die Campaign.lift_measurement_config verwenden) zu unterstützen. Die Enums SearchLiftKeywordBundleStatus, SearchLiftMatchingInfoSource und SearchLiftSearchProperty wurden hinzugefügt.
Asset-Ansicht für die Erweiterung der finalen URL für Shopping-Kampagnen	Erweiterter Support	final_url_expansion_asset_view wurde erweitert, um Shopping-Kampagnen zu unterstützen. ad_group kann jetzt neben final_url_expansion_asset_view.ad_group als zugeordnete Ressource ausgewählt werden.
Videos
Offenlegungspflichten für generative Inhalte auf YouTube	Neue Felder und Enum	Unterstützung für die Offenlegung von generativen Inhalten für YouTube-Uploads hinzugefügt. Das neue Feld YouTubeVideoUpload.video_content_metadata vom Typ VideoContentMetadata wurde zu YouTubeVideoUpload hinzugefügt. Es enthält Offenlegungseinstellungen unter VideoContentMetadata.generative_content_disclosure vom Typ YouTubeVideoUploadGenerativeContentDisclosure.

Haupt- und Nebenversionen von v25

Die Google Ads API v25 enthält die folgenden neuen Funktionen, Updates und funktionsgefährdende Änderungen.

Version 25.2 (23.09.2026)

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

Funktionen und Updates	Typ	Beschreibung
Assets
URL-Optionen für AssetGroup	Neue Felder	URL-Optionen für AssetGroup werden jetzt unterstützt. Werbetreibende können Tracking-Vorlagen, benutzerdefinierte Parameter und Suffixe der finalen 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 bereitgestellt werden.
Kampagnen
Informationen zur automatisierten Videosuche	Neue Felder und Aufzählungen	AutomatedVideoCrawlSetting wurde zu Campaign.AssetAutomationSetting hinzugefügt, zusammen mit AssetAutomationType.AUTOMATED_VIDEO_CRAWL. Damit können Sie die Einstellungen für das automatisierte Crawling von Videos 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, einen source_platform (VideoCrawlSourcePlatform: LANDING_PAGE, SOCIAL oder YOUTUBE) und den Opt-in-Status für enabled konfigurieren.
Fehler beim Wertmultiplikator 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 das Erstellen eines Entwurfs für eine Performance Max-Kampagne aus einer vorhandenen smarten Kampagne zu unterstützen. Der Entwurf 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 die Kampagne als Entwurf zu erstellen. Lassen Sie gbp_enabled und image_enabled nicht festgelegt oder auf false gesetzt. 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 Entitäten (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 verfügbar, sodass Sie diese Conversion-Aktionen abrufen und ändern können. Außerdem wurde die Kategorie IN_APP_AD_REVENUE in ConversionActionCategory verfügbar gemacht, um die Monetarisierungseinnahmen aus In-App-Anzeigen zu erfassen.
Allgemein
BusinessProfileLocationSyncError	Neue Enum und Fehler	Es wurden zusätzliche Gründe für Synchronisierungsfehler bei Unternehmensprofil-Standorten hinzugefügt, wenn Standorte in einem AssetSet vom Typ LOCATION_SYNC synchronisiert werden. Anstelle 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	BenchmarksService.GenerateBenchmarksMetrics wurde aktualisiert, um Messwerte zur Wettbewerbsposition des Kunden im Vergleich zu anderen Werbetreibenden im Perzentilformat bereitzustellen. 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 beide der folgenden Bedingungen in GenerateBenchmarksMetricsRequest 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 Perzentilmesswerte für Daten des aktuellen Quartals innerhalb von ListBenchmarksAvailableDatesResponse.supported_dates (zurückgegeben von BenchmarksService.ListBenchmarksAvailableDates) hinzugefügt. Während aggregierte Kundenmesswerte (CustomerMetrics.aggregate_metrics), Kundenratenmesswerte (CustomerMetrics.average_rate_metrics) und Kundenperzentilmesswerte (CustomerMetrics.percentile_metrics) für alle Daten in supported_dates (einschließlich des aktuellen Quartals) unterstützt werden, werden Kundenanteilsmesswerte (CustomerMetrics.share_metrics) und Ratenmesswerte der Benchmarkquelle (average_benchmarks_metrics, z. B. average_cpm von „/Apparel/Clothing“-Anzeigen) für das aktuelle Quartal nicht unterstützt und aus der Antwort weggelassen, es sei denn, der angeforderte date_range liegt innerhalb des engeren Bereichs ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics. 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
CPA- und ROAS-Gebotsempfehlungen	Neue Empfehlungen	Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) und Recommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW) wurden zusammen mit ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low und ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low hinzugefügt, um die Erhöhung des Ziel-CPA oder die Verringerung des Ziel-ROAS zu unterstützen, wenn die Gebote für Suchkampagnen zu niedrig sind, um an Auktionen teilzunehmen: RaiseTargetCpaPerformanceBidTooLowRecommendation bietet recommended_target_multiplier (ein Faktor größer als 1.0) und current_average_target_cpa_micros. Wenden Sie es mit RaiseTargetCpaPerformanceBidTooLowParameters mit 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 mit 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 vom Nutzer angegebene Daten ausgewählt wurden (HotelDateSelectionType).
Messwerte für vertikale Anzeigen	Neue Messwerte	Metrics wurden die folgenden Messwerte für Berichte zu Anzeigen für die Hotel- und Reisebranche hinzugefügt (auswählbar mit campaign, ad_group und customer): Metrics.vertical_ads_average_booking_value_micros: Klickgewichteter durchschnittlicher Tagespreis in Mikros, einschließlich Steuern und Gebühren, für die gesamte Aufenthaltsdauer bei Hotelbuchungen. Metrics.vertical_ads_potential_impressions: Gesamtzahl der möglichen Impressionen mit Aufruf-Cap, 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	Die folgenden Segmente für Berichte zu Anzeigen für die Hotel- und Reisebranche wurden zu Segments hinzugefügt (auswählbar mit campaign, ad_group und customer): Segments.vertical_ads_price_tier: Die 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: Preistyp (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	Behalte die anstehende automatische Migration zu AI Max im Blick.
Conversions
Analyse der Anzeigenwirkung auf die Markenbekanntheit	Neue Funktionen	Unterstützung für die Analyse der Anzeigenwirkung auf die Markenbekanntheit mit den folgenden Updates hinzugefügt: Neue schreibgeschützte dimensionale Ressourcen für Ergebnisse von Studien zur Anzeigenwirkung auf die Markenbekanntheit 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 mit den folgenden Updates hinzugefügt: Es wurde eine neue schreibgeschützte Ressource LiftMeasurementConfig hinzugefügt, die eine Studie zur Steigerung der Anzeigenwirkung darstellt. Es wurden neue auswählbare Segmente hinzugefügt, um die Steigerungsergebnisse zu segmentieren und zu filtern. Es wurden 24 neue Messwerte für die Conversion-Steigerung und den Gewinner-Score 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	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 zur Markenstimmung in ContentCreatorInsightsService hinzugefügt: Die Nachrichten BrandSentimentInsight, SentimentInsightDistribution und SentimentInsightSummary wurden hinzugefügt. Das Enum 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	Kategorien können jetzt als Filter verwendet werden, um den Umfang einer Benchmarkanalyse einzugrenzen. Außerdem werden zusätzliche geschäftskritische Messwerte unterstützt: Es wurde eine Option hinzugefügt, mit der Sie Ihre Leistung mit der aller 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	Die Ausrichtung auf den Elternstatus wird jetzt bei der Reichweitenplanung unterstützt. Das neue Feld parental_statuses wurde Targeting für den Dienst ReachPlanService.GenerateReachForecast und parental_statusesPlannableTargeting 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 Zielvorhaben in dieser Empfehlung darzustellen.
Berichte
Metrics.original_conversion_value	Neues Feld	Stellt den ursprünglichen Conversion-Wert aus gebotsfähigen Conversion-Typen dar. 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	Unterstützung für die Segmentierung von Statistiken nach dem Status der Mitgliedschaft im Treuepunkteprogramm hinzugefügt und die primäre Dimension „Mitgliedschaft im Treuepunkteprogramm“ für Conversion-Wert-Regeln hinzugefügt: Das Segment Segments.loyalty_membership wurde hinzugefügt, um Berichtsmesswerte nach der Stufe des Treuepunkteprogramms des konvertierenden Nutzers zu segmentieren. 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 Kriterientyp vertical_ads_item_bid wurde AdGroupCriterion.criterion hinzugefügt.

v25 (22.07.2026)

Die folgenden neuen Funktionen, Aktualisierungen und funktionsgefährdenden Änderungen wurden in Google Ads API v25 hinzugefügt, einer Hauptversion.

Weitere Informationen finden Sie unter Upgrade auf die aktuelle Version.

Funktionsgefährdende Änderungen

Ausgangszustand	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 die Verweise auf diese Felder, da sie jetzt Teil von „oneofs“ sind.
Legacy-Ressourcen CustomerLifecycleGoal und CampaignLifecycleGoal, die entsprechenden Dienste CustomerLifecycleGoalService und CampaignLifecycleGoalService sowie Legacy-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 Legacy-Felder type.
Optionale Felder selected_incentive_id und customer_id in ApplyIncentiveRequest	Pflichtfelder	Verhaltensänderung	Achten Sie darauf, beide Felder anzugeben, wenn Sie ApplyIncentive aufrufen.
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 allowed_domain-Feld 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, um den neuen Typ CustomerMetrics zu verwenden, der nur Messwerte zur Anzeigenleistung des Kunden enthält.

Funktionen und Updates (nicht funktionsgefährdend)

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 aus nicht animierten Bildern 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 v25, v24 und v23 jetzt vollständig änderbar.
Kampagnen
Zielvorhaben „Kundentreue und -bindung“	Neue Funktionen / Einstellungen	Unterstützung für das Zielvorhaben „Kundenbindung“ hinzugefügt. Damit können Werbetreibende Kampagnen für die Bindung von Mitgliedern des Treuepunkteprogramms optimieren. 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 über das Feld new_customer_acquisition_goal_settings zu unterstützen. Die Ressource CampaignGoalConfig wurde erweitert, um kampagnenspezifische Überschreibungen für die Kundenakquisition mit dem Feld campaign_new_customer_acquisition_settings zu unterstützen. Das neue Enum CustomerLifecycleOptimizationGoalSubType wurde hinzugefügt, um unterstützte Zieluntertypen zu definieren. NEW_CUSTOMER_ACQUISITION wurde der GoalType-Enumeration hinzugefügt. GoalError wurden neue Gründe für Validierungsfehler hinzugefügt: NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS CampaignGoalConfigError 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 IncompatibleCloGoalsErrorDetails-Struktur für Validierungsfehler bereitzustellen.
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 ist 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 von Prämien aus diesem Angebot eingelöst.) MISMATCHING_BILLING_COUNTRY_CODE (Der in der Anfrage angegebene Ländercode der Rechnungsadresse stimmt nicht mit dem Land des Kundenkontos überein.)
Planung
Details zum YouTube-Kanal in den Trendstatistiken	Neue Felder	Bei der Suche nach Statistiken zu Trends werden jetzt mehr YouTube-Kanaldetails zu ähnlichen Videos unterstützt. 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. In diesem Fall 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 (nicht überspringbare In-Stream-Anzeige mit Standarddauer) 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, 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 Social-Media-Messwerte	Neue Felder / Messwerte	Es wurden videospezifische Messwerte für soziale Medien hinzugefügt, mit denen Werbetreibende die Nutzerinteraktion (Kommentare, „Mag ich“-Bewertungen und geteilte Inhalte) für YouTube Shorts-Anzeigen erfassen können: Metrics.youtube_comments Metrics.youtube_likes Metrics.youtube_shares Sie sind in AdGroup, AdGroupAd, Asset, Campaign, Customer und Video verfügbar.

v24-Haupt- und Nebenversionen

Die Google Ads API v24 enthält die folgenden neuen Funktionen, Updates und funktionsgefährdenden Änderungen.

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. Diese sind ab dieser API-Version standardmäßig aktiviert.
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	Hinzugefügt, um Regeln für Artikelgruppen in vertikalen Anzeigen zu unterstützen, mit denen Artikel aus angehängten vertikalen Feeds in Performance Max-Kampagnen ausgewählt werden können. 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 einer der auswählbaren Kanäle für Demand Gen-Anzeigengruppen.
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	Conversions, 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 Kampagnenmix-Tests und benutzerdefinierte Performance Max-Kampagnentests, 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 mit Textanpassung und 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 (Erklärungen, die direkt vom Werbetreibenden bereitgestellt werden) und system_attestation (Bestätigungen, die automatisch vom System erkannt oder bereitgestellt werden). Diese Funktion wurde auf v23 und v22 zurückportiert. Damit Sie Ihre anstehenden Integrationsarbeiten für v25 besser planen können, wird die Schnittstelle zum Ändern der Felder für die Werbetreibendenbestätigung bereits für v22 und höher eingeführt. Die Schnittstelle 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 v25 sind diese Felder vollständig änderbar. Wir empfehlen, die Schnittstelle jetzt zu verwenden, um Ihre interne Logik zu erstellen und zu testen, damit Ihr System für die vollständigen Schreibfunktionen bereit ist, wenn v25 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 Ressourcenname 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, greift die Methode jetzt auf die Standard-Incentive-Angebote zurück, anstatt den Fehler AuthenticationError.INVALID_EMAIL_ADDRESS auszugeben.
Planung
GenerateCreatorInsightsRequest.search_topics	Neues Feld	Zum Dienst ContentCreatorInsightsService.GenerateCreatorInsights hinzugefügt. Mit dieser Option werden Creator gesucht, die in dem unter country_locations angegebenen Land über ein Thema sprechen. Es kann nur nach einem Land gesucht werden.
CREATOR_TOPIC_INSIGHTS	Neuer Enum-Wert	Zu 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 in der Antwort zusätzliche Standorte oder Erstellerattribute ausgegeben.
local_creator_insights related_local_creators	Neue Felder	Wird ausgefüllt, wenn supplemental_data das Enum 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	Der Funktion ContentCreatorInsightsService.GenerateTrendingInsights hinzugefügt, sodass Sie nach Trends in Ländern und Unterregionen suchen können.
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 Displayanzeigen, die ohne zusätzliche responsive Assets ausgeliefert werden.
Tests
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING	Neue Enum-Werte	Unterstützung für neue ExperimentType-Typen hinzugefügt: ADOPT_AI_MAX: Für Tests, mit denen Sie herausfinden können, ob Sie mit AI Max mehr Nutzer mithilfe von Google AI und weitgehend passenden Keywords ansprechen können. ADOPT_BROAD_MATCH_KEYWORDS: Für Tests, mit denen 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 Experimente, in denen die Kampagnenleistung 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-Einstellungen in Testzweigen werden verfügbar gemacht: asset_testing_info: Details zu Assets, die mit den Testanzeigen verknüpft sind. asset_groups: Liste der Asset-Gruppen in der Testverzweigung für Tests zur Asset-Optimierung. 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, die für vertikale Anzeigen verwendet werden sollen.
user_rating, venue, event_participant_display_name	Neue Filterkriterien	Unterstützte Filterung in VerticalAdsItemGroupRuleInfo für die Ressource SharedCriterion.
Messwerte für Kontroll-/Testgruppe	Neue Felder	Es wurden Kontrollwerte (control_clicks usw.), Behandlungswerte (clicks usw.), Punktschätzungen (clicks_point_estimate usw.), Fehlermargen (clicks_margin_of_error usw.) und p-Werte (clicks_p_value usw.) für sieben wichtigen Messwertfamilien (Klicks, Impressionen, Kosten, Conversions, Cost-per-Conversion, Conversion-Wert, Conversion-Wert pro Kosten) hinzugefügt.
Messwerte für die absolute Änderung der Conversions	Neue Felder	Unterstützung für Conversions-Schätzungen der absoluten Differenz mithilfe der Felder 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-Integrationspartner für die Sichtbarkeitsmessung veröffentlicht.
DataLink.youtube_video.channel_id	Neues Feld	Gibt die YouTube-Kanal-ID zurück, die mit der Datenverknüpfung verknüpft ist.

v24 (22.04.2026)

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

Weitere Informationen finden Sie unter Upgrade auf die aktuelle Version.

Funktionsgefährdende Änderungen

Ausgangszustand	Neuer Status	Art der Änderung	Implementierungsleitfaden
Anzeigen
Optionale videos und logo_images in DemandGenVideoResponsiveAdInfo	Pflichtfelder	Verhaltensänderung	Geben Sie beim Erstellen oder Ändern responsiver Demand Gen-Videoanzeigen videos und logo_images an.
Optionale videos, business_name und logo_images in VideoResponsiveAdInfo	Pflichtfelder	Verhaltensänderung	Geben Sie beim Erstellen oder Ändern von responsiven Videoanzeigen videos, business_name und logo_images an. VideoResponsiveAdInfo ist jetzt änderbar.
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 „Anmeldungen für Treuepunkteprogramm“ 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, um die neuen Ressourcen-Namespaces zu verwenden.
Feld youtube_select_lineups in ReachPlanService.ListPlannableProducts	–	Entfernung	Wechseln Sie zu den Aufstellungen von youtube_select_lineup_targeting.
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-Planer / 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 Aktualisieren Sie die Integrationen entsprechend.
Berichte
ad_sub_network_type-Segment in campaign_budget	–	Entfernung	Das Segment ad_sub_network_type für die Ressource campaign_budget wurde entfernt.
Segment click_type in Asset-Ansichten	–	Entfernung	Segment aus den Ansichten AdGroupAsset, CampaignAsset und CustomerAsset entfernt.
Videos
Teilweiser Fehler 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: 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 funktionsgefährdend)

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) (Standardwert 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 Listen mit ähnlichen Zielgruppen zu erstellen.
Planung
ProductCoreAttributes-Felder in ListPlannableProductsResponse	Neue Felder	Wir haben unter ListPlannableProductsResponse die planbare Produktbeschreibung, das Marketingziel, das Kostenmodell und die Kaufmethode für ProductCoreAttributes hinzugefügt.
Berichte
CartDataSalesView	Neue Berichtsressource	Berichte, in denen Conversion-Messwerte zusätzlich zum angeklickten Produkt nach den Bestimmten Produkten (Marke usw.) segmentiert werden.
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 Ressource ShoppingProduct. Hinweisstatus und Probleme werden nicht unterstützt.
Tag-basierte Produktfilterung	Neue Funktion	Einführung der dynamischen Filterung mithilfe logischer Mengenausdrücke: Die Kriterientypen RETAIL_FILTER_BUNDLE und RETAIL_FILTER wurden hinzugefügt. Der Typ des freigegebenen Satzes RETAIL_FILTER wurde hinzugefügt. Das Feld retail_filter_bundle wurde zu AdGroupCriterion 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 neue zugehörige 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)

Die folgenden neuen Funktionen und Aktualisierungen wurden in Version 23.3 der Google Ads API 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 anstehenden Integrationsarbeiten für v25 besser planen können, wird die Schnittstelle zum Ändern der Felder für die Werbetreibendenbestätigung bereits für v22 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 v25 sind diese Felder vollständig änderbar. Wir empfehlen, die Schnittstelle jetzt zu verwenden, um Ihre interne Logik zu erstellen und zu testen, damit Ihr System für die vollständigen Schreibfunktionen bereit ist, wenn v25 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 die Überprüfung von Genehmigungen durch mehrere Parteien (Multi-Party Approvals, MPA) hinzugefügt: Die Ressource MultiPartyAuthReview und die entsprechende MultiPartyAuthReviewService wurden hinzugefügt. Das Enum MultiPartyAuthReviewStatus wurde hinzugefügt, um den Überprüfungsstatus zu verfolgen. CustomerUserAccess.pending_multi_party_auth_review wurde hinzugefügt, um einen Link zu einer ausstehenden Überprüfung zu erstellen. MutateCustomerUserAccessResult.multi_party_auth_review und MutateCustomerUserAccessInvitationResult.multi_party_auth_review wurden hinzugefügt, um den zugehörigen Ressourcenname der Rezension zurückzugeben. MultiPartyAuthReviewError für Validierungsfehler 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 Informationen zur Optimierung von Videoanzeigen, z. B. ob sie von Google generiert 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 liefert.
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	Sie können detailliertere Zeitplaneinschränkungen für die Kampagnendaten 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	Neue Altersgruppen für das Targeting hinzugefügt, z. B. AGE_RANGE_21_44 oder AGE_RANGE_21_49.
youtube_select_lineup_targeting	Neues Feld	Wurde zu ReachPlanService.ListPlannableProducts hinzugefügt, das youtube_select_lineups ersetzt. 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	Zu 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	Zu 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 es politische Werbung enthält, die auf die EU ausgerichtet ist, und gibt ein EuPoliticalAdvertisingStatus zurück.
Kampagnen
Campaign.text_guidelines	Neues Feld	Unterstützung für Richtlinien für Text hinzugefügt, die mit Performance Max- und Suchkampagnen verwendet werden können, um KI-generierte Text-Assets programmatisch zu steuern. 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 Hauptursachen für den Status von Kampagnen mit der Gebotsstrategie FIXED_CPM anzugeben.
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure Campaign.VideoCampaignSettings.booking_details	Neue Felder	Die Unterstützung für die eigenständige Offenlegung der Reservierungsanzeigenkategorie und schreibgeschützte Buchungsdetails wurde hinzugefügt.
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.
Conversions
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS	Neuer Enum-Wert	Unterstützt das Tracking von Nutzern, die sich eine Anzeige und später ein Video auf demselben Kanal ansehen.
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 bei Anfragen zurückgegeben werden, die am oder nach dem 11. März 2026 gestellt werden.
Planung
GenerateBenchmarksMetrics	Neue Funktion	Unterstützung für Datumsaufschlüsselungen 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 „Conv. maximieren“ 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, die angeben, 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.

v23 (28.01.2026)

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

Weitere Informationen finden Sie unter Upgrade auf die aktuelle Version.

Funktionsgefährdende Änderungen

Ausgangszustand	Neuer Status	Art der Änderung	Implementierungsleitfaden
Anzeigen
Anzeigenteilung zulässig	AdGroupAdError.AD_SHARING_NOT_ALLOWED	Verhaltensänderung	Die Freigabe von Anzeigen für mehrere Anzeigengruppen ist nicht mehr zulässig. Bei Anfragen, mit denen versucht wird, Anzeigen zu teilen, wird ein AD_SHARING_NOT_ALLOWED-Fehler zurückgegeben.
Unterstützung für CallAd und CallAdInfo	–	Entfernung	Anrufanzeigen werden nicht mehr unterstützt. Weitere Informationen finden Sie im Hilfeartikel Anrufanzeigen.
Kampagnen
Campaign.start_date Campaign.end_date	Campaign.start_date_time Campaign.end_date_time	Umbenennung / Ersatz	Verwenden Sie die neuen Datums- und Uhrzeitfelder, um Zeitkomponenten für Kampagnen anzugeben. Die ursprünglichen Felder, die nur das Datum enthalten, werden entfernt.
Demand Gen
DemandGenMultiAssetAdInfo.lead_form_only	–	Entfernung	Das Feld „lead_form_only“ wurde entfernt. Aktualisieren Sie die Referenzen in Ihrem Code.
Berichte
Messwerte und Enum für die aggregierte Asset-Leistung	–	Entfernung	Messwerte für das Label „Gesamtleistung von Assets“ entfernt. Die Enumeration für das Leistungslabel wird für Such- und Displaykampagnen nicht mehr zurückgegeben.

Funktionen und Updates (nicht funktionsgefährdend)

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-Ansicht	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 hinzugefügt, wenn field_type auf HEADLINE und DESCRIPTION festgelegt ist.
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 Nachrichten-Assets für 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 behördlicher 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	Fehlercodes DURATION_TOO_LONG_FOR_TOTAL_BUDGET und END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET 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 Demand Gen-Videoanzeigen unterstützt.
Incentives
Unterstützung für CYO-Anreize (Choose Your Own) hinzugefügt: Die Methode FetchIncentive wurde hinzugefügt, um verfügbare personalisierte Incentives für einen Nutzer abzurufen. Die Methode ApplyIncentive wurde hinzugefügt, um einen ausgewählten Incentive auf ein Kundenkonto anzuwenden. Die Ressource AppliedIncentive wurde hinzugefügt, um Details zur Einlösung bereitzustellen. Sie kann mit Search und SearchStream abgefragt werden. 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 Versionen zusätzliche Fehlercodes zu IncentivesService hinzufügen. Wir empfehlen Ihnen, die kommenden Ankündigungen und Versionshinweise zu diesen neuen Fehlercodes im Auge 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 anhand von 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 zu 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	Wertet aus, 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. Anfänglich 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 Werbenetzwerktyp 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 Ressourcen für Berichte	PerStoreView wurde hinzugefügt, um Details zu Geschäftsstandorten 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
Vertikale Anzeigen
AdGroup.vertical_ads_format_setting	Neues Feld	Damit lässt sich steuern, welche Anzeigenformate in Suchkampagnen mit Reisefeeds ausgeliefert werden können.
AdGroupCriterion SharedCriterion	Neue Felder / Kriterien	Der Kriteriumstyp vertical_ads_item_group_rule_list wurde zu AdGroupCriterion und vertical_ads_item_group_rule zu 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 Datenfeed für Anzeigen für bestimmte Branchen mit einer Suchkampagne verknüpfen, in der AI Max verwendet wird, um neben Textanzeigen auch Anzeigen für Immobilienangebote und Anzeigen mit Buchungslinks zu schalten. Formatieren Sie Steuerelemente mit vertical_ads_format_setting und definieren Sie Regeln mit vertical_ads_item_group_rule. Berichte nach AdFormatType und Dimensionen des Datenfeeds für vertikale Anzeigen 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 zur 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.

Archivierte Versionshinweise

Archivierte Versionshinweise finden Sie unter Eingestellte Versionen.