Informacje o wersjach

Aktualną listę obecnych i planowanych wycofań funkcji znajdziesz w artykule Wycofanie funkcji.

Wersja główna v26

Wersja 26 interfejsu Google Ads API zawiera te nowe funkcje, aktualizacje i istotne zmiany.

wersja 26 (14.10.2026)

W interfejsie Google Ads API w wersji 26, która jest wersją główną, dodaliśmy te nowe funkcje, aktualizacje i zmiany powodujące niezgodność.

Więcej informacji znajdziesz w artykule Uaktualnianie do najnowszej wersji.

Zmiany powodujące niezgodność

Stan początkowy	Nowy stan	Typ zmiany	Wskazówki dotyczące implementacji
Kampanie
Pole opcjonalne country_code w LocalServicesPmaxCampaignSettings	Pole wymagane podczas tworzenia kampanii Performance Max na usługi lokalne (LocalServicesPmaxCampaignSettings.country_code)	Zmiana zachowania	Podczas tworzenia kampanii Performance Max dla Usług Lokalnych pamiętaj, aby podać country_code (oraz nowo wymagany parametr listing_id).
Konwersje
Pole enhanced_conversions_for_leads_enabled w ConversionTrackingSetting (Customer.conversion_tracking_setting)	Brak	Usunięcie	Zamiast tego użyj ConversionTrackingSetting.enablement_setting na Customer.conversion_tracking_setting, aby sprawdzić ustawienie konwersji rozszerzonych na poziomie konta.
Kierowanie
Pola kryteriów dotyczące hoteli w AdGroupBidModifier: hotel_date_selection_type hotel_advance_booking_window hotel_length_of_stay (min_nights i max_nights) hotel_check_in_day hotel_check_in_date_range	Pola kryteriów niezależne od branży w AdGroupBidModifier: user_set_dates typu UserSetDatesInfo advance_booking_window typu AdvanceBookingWindowInfo length_of_booking typu LengthOfBookingInfo (min_days i max_days) start_day_of_week typu StartDayOfWeekInfo start_date_range typu StartDateRangeInfo	Zmiana nazwy lub usunięcie	Zaktualizuj odwołania, aby używać pól kryteriów niezależnych od branży, które obsługują kierowanie w różnych branżach turystycznych poza hotelami (np. atrakcje). Identyfikatory kryteriów, zachowanie kierowania i dotychczasowe modyfikatory stawek pozostają bez zmian. Wartości min_nights i max_nights są przenoszone do min_days i max_days w niezmienionej postaci.
HotelDateSelectionType i typ segments.user_set_dates	DateSelectionType	Zmiana nazwy lub typu	Użyj DateSelectionType zamiast HotelDateSelectionType.
Przyczyny błędów dotyczące hoteli w 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	Przyczyny błędów niezależne od branży w 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	Zmień nazwę	Zaktualizuj obsługę błędów, aby sprawdzać nowe przyczyny błędów niezależne od branży.

Funkcje i aktualizacje (niepowodujące przerw w działaniu)

Funkcje i aktualizacje	Typ	Opis
Zasoby
Dostawcy wiadomości biznesowych LINE i SMS	Nowe pola i wartości typu wyliczeniowego	Dodaliśmy obsługę LINE i SMS-ów jako dostawców wiadomości w BusinessMessageAsset, w tym nowe pola BusinessMessageAsset.line_info i BusinessMessageAsset.sms_info oraz BusinessMessageProvider.LINE i BusinessMessageProvider.SMS.
AssetGroupError.UNSUPPORTED_LOCAL_SERVICES_CATEGORY	Nowa wartość typu wyliczeniowego lub błąd	Dodano do AssetGroupError, aby wskazać, kiedy kategoria określona w GoogleLocalServicesInfo (AssetGroup.google_local_services_info) nie jest obsługiwana w kampaniach Performance Max dla Usług Lokalnych.
Kampanie
Tworzenie kampanii Performance Max w Usługach Lokalnych	Nowe funkcje, pola i błędy	Zaktualizowano PmaxCampaignSettings.local_services_enabled z OUTPUT_ONLY na IMMUTABLE, co umożliwia zewnętrznym klientom interfejsu API określanie local_services_enabled = true podczas tworzenia nowych kampanii Performance Max w Usługach Lokalnych. Dodaliśmy też LocalServicesPmaxCampaignSettings.listing_id, aby udostępnić identyfikator wizytówki w Profilu Firmy w Google powiązanej z kampanią Performance Max Reklam Usług Lokalnych (oznaczony jako WYMAGANY podczas tworzenia kampanii Performance Max Reklam Usług Lokalnych), oraz dodaliśmy kod błędu CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID.
Błędy weryfikacji kampanii w Usługach Lokalnych	Nowe wartości typu wyliczeniowego i błędy	Dodaliśmy nowe błędy weryfikacji w kampaniach Usług Lokalnych: CampaignError: LOCAL_SERVICES_MULTIPLE_PERFORMANCE_MAX_CAMPAIGNS_NOT_ALLOWED LOCAL_SERVICES_AGREEMENT_REQUIRED AssetSetLinkError: LOCATION_ASSET_DOES_NOT_MATCH_CAMPAIGN_LISTING_ID CampaignConversionGoalError i 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
Weryfikacja połączenia z kontem Hotel Center	Nowa wartość typu wyliczeniowego / błąd	Dodaliśmy do CampaignError kod błędu CampaignError.HOTEL_PROPERTY_ASSET_SET_HOTEL_CENTER_LINK_REQUIRED, aby wskazać, że połączenie zestawu komponentów z obiektem hotelowym (Campaign.hotel_property_asset_set) z kampanią Performance Max do celów związanych z podróżami wymaga aktywnego połączenia z kontem Hotel Center.
Minimalny budżet dzienny w kampanii generującej popyt	Nowe pole	Do zasobu CurrencyConstant dodaliśmy pole demand_gen_info.minimum_budget_per_day_micros, które określa minimalny wymagany budżet dzienny kampanii generujących popyt w danej walucie. Wartość tego pola jest aktualizowana, gdy zmienia się minimalny budżet wymuszany przez interfejs API.
Konfiguracja pomiaru wyników w kampaniach	Nowe pole	Dodaliśmy pole Campaign.lift_measurement_config, aby udostępniać nazwę zasobu konfiguracji pomiaru wzrostu połączonej z kampanią.
Weryfikacja eksperymentu AI Max	Nowa wartość typu wyliczeniowego / błąd	Dodaliśmy kod błędu ExperimentArmError.ADOPT_AI_MAX_CAMPAIGN_ALREADY_ENABLED do kodu ExperimentArmError podczas próby utworzenia eksperymentu ADOPT_AI_MAX w przypadku kampanii, która ma już włączone funkcje AI Max (lub włączone w ramach tego samego żądania przed utworzeniem grupy eksperymentalnej).
Typ informacji o produkcie w kampanii produktowej	Rozszerzona pomoc	Rozszerzona obsługa Campaign.listing_type w kampaniach produktowych.
Aktualizacje dotyczące samodzielnej deklaracji w przypadku reklam politycznych w UE	Zaktualizowane zachowanie i nowe pola	Atrybut Campaign.contains_eu_political_advertising jest teraz opcjonalny w przypadku niektórych kampanii, które nie są kierowane na Unię Europejską. Z wyjątkiem kampanii DEMAND_GEN z uaktualnionym kierowaniem to pole jest opcjonalne, jeśli po wykonaniu żądania kampania spełnia wszystkie te warunki: Nie zawiera kryterium kampanii dotyczącego niewykluczającej lokalizacji w UE. Nie zawiera kryterium kampanii dotyczącego kierowania na zbliżony obszar ani grupy lokalizacji zawiera co najmniej 1 kryterium kampanii dotyczące lokalizacji uwzględniającej, która znajduje się poza UE; W przypadku kampanii DEMAND_GEN z upgraded_targeting to pole jest opcjonalne, jeśli po wykonaniu żądania każda aktywna grupa reklam w kampanii spełnia wszystkie te warunki: Nie zawiera kryterium grupy reklam dotyczącego lokalizacji w UE Nie zawiera kryterium grupy reklam dotyczącego niewykluczającej bliskości ani grupy lokalizacji. zawiera co najmniej 1 kryterium grupy reklam dotyczące lokalizacji niewykluczającej, która znajduje się poza UE; To pole jest też opcjonalne w przypadku kampanii, które nie zawierają aktywnych grup reklam. Jeśli żądanie utworzy grupę reklam, która nie spełnia tych warunków, zwracany jest błąd AdGroupError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION. Te zmiany będą miały zastosowanie zarówno do nowych, jak i do dotychczasowych kampanii. W niektórych przypadkach nową kampanię można utworzyć tylko wtedy, gdy kryteria zostaną dodane w tym samym żądaniu. Aby pogrupować mutacje, użyj GoogleAdsService.Mutate. Zaktualizowano Campaign.missing_eu_political_advertising_declaration, aby odzwierciedlić zmiany w Campaign.contains_eu_political_advertising. Dodaliśmy parametr GeoTargetConstant.require_eu_political_advertising_declaration, aby wskazać, czy lokalizacja znajduje się w UE czy poza nią. Dodano: CampaignCriterion.require_eu_political_advertising_declaration i AdGroupCriterion.require_eu_political_advertising_declaration. Pole Campaign.contains_eu_political_advertising jest wymagane, jeśli to pole ma wartość true w przypadku dowolnego kryterium na poziomie kampanii w kampanii (lub dowolnego aktywnego kryterium na poziomie grupy reklam w kampaniach DEMAND_GEN z ulepszonym kierowaniem). Pola zwracają wartość true, jeśli pole negative kryterium ma wartość false, a kryterium to lokalizacja w UE, bliskość (niezależnie od tego, czy pokrywa się z terytorium UE) lub grupa lokalizacji (niezależnie od tego, czy pokrywa się z terytorium UE).
Konwersje
Ujednolicona konfiguracja konwersji rozszerzonych	Nowe pola i typ wyliczeniowy	Dodano ConversionTrackingSetting.enablement_setting i ConversionTrackingSetting.effective_enablement_setting (w Customer.conversion_tracking_setting), aby udostępnić ujednoliconą konfigurację konwersji rozszerzonych na koncie, reprezentowaną przez nowy typ wyliczeniowy EnhancedConversionsConfig.
ConversionActionCategory.MESSAGE_LEAD	Nowa wartość typu wyliczeniowego	Dodano do ConversionActionCategory, aby obsługiwać interakcje związane z wiadomościami lub czatem, które wskazują na zainteresowanie ofertą reklamodawcy.
ConversionAttributionEventType.CLICK	Nowa wartość typu wyliczeniowego	Dodano do ConversionAttributionEventType, aby reprezentować konwersje przypisane do kliknięcia reklamy, które wcześniej były uwzględniane w wartości wyliczeniowej UNKNOWN.
Ogólne
Aktualizacje dotyczące potencjalnych klientów z Usług Lokalnych	Nowe pole i wartość typu wyliczeniowego	Dodaliśmy pole LocalServicesLead.campaign do zasobu LocalServicesLead, aby połączyć potencjalnego klienta z powiązaną z nim kampanią. Dodaliśmy COUPON do LocalServicesLeadType, aby obsługiwać typy potencjalnych klientów z kuponami w przypadku Reklam Usług Lokalnych.
Rekomendacje
Rekomendacja dotycząca zwiększenia budżetu na potrzeby wyszukiwania	Nowa rekomendacja	Dodaliśmy RecommendationType.RAISE_BUDGET_PERFORMANCE_TOO_LOW, Recommendation.raise_budget_performance_too_low_recommendation i ApplyRecommendationOperation.raise_budget_performance_too_low, aby umożliwić zwiększanie budżetów, gdy budżety dzienne są zbyt niskie w przypadku kampanii w sieci wyszukiwania.
Raporty
Pomiary wzrostu liczby wyszukiwań	Nowe funkcje, zasoby, segmenty i dane	Dodaliśmy obsługę pomiarów wzrostu liczby wyszukiwań: Dodaliśmy nowy zasób tylko do odczytu SearchLiftKeywordBundle, który reprezentuje pakiet słów kluczowych w badaniu wzrostu liczby wyszukiwań. Dodaliśmy nowe segmenty do wyboru (segments.search_lift_keyword_bundle i segments.search_property) oraz 15 nowych danych dotyczących wzrostu liczby wyszukiwań (takich jak relative_search_lift, normalized_incremental_searches, search_lift_cost_micros i search_lift_impressions), aby umożliwić analizę wzrostu liczby wyszukiwań za pomocą LiftMeasurementConfig (połączonego z kampaniami korzystającymi z Campaign.lift_measurement_config). Dodaliśmy typy wyliczeniowe SearchLiftKeywordBundleStatus, SearchLiftMatchingInfoSource i SearchLiftSearchProperty.
Widok komponentów z rozwinięciem końcowego adresu URL w kampaniach produktowych	Rozszerzona pomoc	Rozwinięto final_url_expansion_asset_view, aby obsługiwać kampanie produktowe (z ad_group jako zasobem przypisanym, który można wybrać obok final_url_expansion_asset_view.ad_group).
Filmy
Oświadczenia dotyczące treści generowanych przez AI na YouTube	Nowe pola i typ wyliczeniowy	Dodaliśmy obsługę oświadczeń o treściach generowanych przez AI w przypadku filmów przesyłanych na YouTube. Do YouTubeVideoUpload dodano nowe pole YouTubeVideoUpload.video_content_metadata typu VideoContentMetadata, które zawiera ustawienia ujawniania w VideoContentMetadata.generative_content_disclosure typu YouTubeVideoUploadGenerativeContentDisclosure.

Wersje główne i podrzędne v25

Interfejs Google Ads API w wersji 25 zawiera te nowe funkcje, aktualizacje i zmiany powodujące niezgodność.

wersja 25.2 (23.09.2026)

W interfejsie Google Ads API w wersji 25.2 dodaliśmy te nowe funkcje i aktualizacje. Wersje podrzędne, takie jak v25.2, nie zawierają zmian powodujących niezgodność.

Funkcje i aktualizacje	Typ	Opis
Zasoby
Opcje adresów URL dla AssetGroup	Nowe pola	Dodaliśmy obsługę opcji adresów URL w AssetGroup, co umożliwia reklamodawcom określanie szablonów śledzenia, parametrów niestandardowych i sufiksów końcowego adresu URL na poziomie grupy plików: AssetGroup.tracking_url_template: szablon URL do tworzenia linku monitorującego. AssetGroup.url_custom_parameters: lista mapowań, które mają być używane do zastępowania tagów parametrów niestandardowych adresu URL w tracking_url_template, final_urls lub final_mobile_urls. AssetGroup.final_url_suffix: szablon URL do dodawania parametrów do adresów URL stron docelowych wyświetlanych w ramach śledzenia równoległego.
Kampanie
Informacje o automatycznym indeksowaniu filmów	Nowe pola i wyliczenia	Do Campaign.AssetAutomationSetting dodano AutomatedVideoCrawlSetting wraz z AssetAutomationType.AUTOMATED_VIDEO_CRAWL, co umożliwia określanie ustawień automatycznego indeksowania filmów w kampanii Performance Max. AutomatedVideoCrawlSetting.automated_video_crawl_infos zawiera listę wpisów AutomatedVideoCrawlInfo, z których każdy konfiguruje indeksowanie url, source_platform (VideoCrawlSourcePlatform: LANDING_PAGE, SOCIAL lub YOUTUBE) i stan zgody enabled.
Błędy mnożnika wartości optymalizacji cyklu życia klienta	Nowe wartości typu wyliczeniowego i błędy	Dodano nowe przyczyny błędów weryfikacji podczas konfigurowania mnożników wartości (value_multiplier i high_lifetime_value_multiplier) na potrzeby optymalizacji cyklu życia klienta: 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	Nowa funkcja	Dodano SmartCampaignSettingService.GeneratePMaxDraftCampaign, aby umożliwić generowanie wersji roboczej kampanii Performance Max na podstawie istniejącej kampanii inteligentnej, zainicjowanej ze stanem CampaignStatus.PAUSED i stanem tworzenia CampaignCreationStatus.INCOMPLETE (patrz Przekształcanie kampanii inteligentnych w kampanie Performance Max): Ustaw wartość GeneratePMaxDraftCampaignRequest.validate_only na true, aby sprawdzić konwersję i otrzymywać ostrzeżenia dotyczące weryfikacji lub problemy z konwersją w GeneratePMaxDraftCampaignResponse.validated_info bez tworzenia kampanii w wersji roboczej. (Pozostaw pola gbp_enabled i image_enabled nieskonfigurowane lub ustaw wartość false. Ustawienie wartości true nie jest jeszcze obsługiwane i zwraca błąd SmartCampaignError.GBP_ENABLED_GENERATE_PMAX_NOT_SUPPORTED lub SmartCampaignError.IMAGE_ENABLED_GENERATE_PMAX_NOT_SUPPORTED). GeneratePMaxDraftCampaignResponse zwraca nazwy zasobów wygenerowanych elementów (pmax_campaign, campaign_budget, asset_group i assets) oraz validated_info.
Konwersje
Wyświetlenia reklam w Firebase	Nowe typy i kategorie działań powodujących konwersję	Udostępniliśmy typy działań powodujących konwersję FIREBASE_ANDROID_APP_AD_IMPRESSION i FIREBASE_IOS_APP_AD_IMPRESSION, dzięki czemu możesz pobierać i modyfikować te działania. W sekcji ConversionActionCategory udostępniliśmy też kategorię IN_APP_AD_REVENUE, aby śledzić przychody z reklam w aplikacji.
Ogólne
BusinessProfileLocationSyncError	Nowy typ wyliczeniowy i błędy	Dodano przyczyny błędów synchronizacji lokalizacji w Profilu Firmy podczas synchronizowania lokalizacji w LOCATION_SYNC-typie AssetSet. Zamiast ogólnego błędu UNKNOWN interfejs API zwraca teraz błąd BusinessProfileLocationSyncError z konkretnymi przyczynami (EMAIL_INVALID, OAUTH_TOKEN_INVALID, ACCOUNT_REMOVED i NO_PERMISSION_TO_ACCESS_LOCATION_ACCOUNT).
Planowanie
Dane centylowe BenchmarksService.GenerateBenchmarksMetrics	Nowe funkcje	Zaktualizowaliśmy BenchmarksService.GenerateBenchmarksMetrics, aby udostępniać dane dotyczące pozycji konkurencyjnej klienta wśród innych reklamodawców w formacie percentyli. Rodzaje danych są zwracane w PercentileMetrics w nowym polu CustomerMetrics.percentile_metrics (w przypadku GenerateBenchmarksMetricsResponse.customer_metrics i BreakdownMetrics.customer_metrics) i są reprezentowane za pomocą BenchmarksCustomerPercentileTier. Pole CustomerMetrics.percentile_metrics jest wypełniane tylko wtedy, gdy w GenerateBenchmarksMetricsRequest spełnione są oba te warunki: PERCENTILE_DATA jest wymagany w: supplemental_data. BenchmarksSource.all_advertisers jest ustawiony na benchmarks_source (co wymaga również określenia category_filter). Dodaliśmy obsługę danych percentylowych dla dat otwartego kwartału w ramach ListBenchmarksAvailableDatesResponse.supported_dates (zwracanych przez BenchmarksService.ListBenchmarksAvailableDates). Dane zbiorcze klientów (CustomerMetrics.aggregate_metrics), dane o współczynnikach klientów (CustomerMetrics.average_rate_metrics) i dane percentylowe klientów (CustomerMetrics.percentile_metrics) są obsługiwane we wszystkich datach w ramach supported_dates (w tym w otwartych kwartałach), ale dane o udziałach klientów (CustomerMetrics.share_metrics) i dane o współczynnikach źródła analizy porównawczej (average_benchmarks_metrics, np. average_cpm reklam „/Apparel/Clothing”) nie są obsługiwane w przypadku otwartych kwartałów i są pomijane w odpowiedzi, chyba że żądany date_range mieści się w węższym zakresie ListBenchmarksAvailableDatesResponse.supported_dates_for_all_metrics. Dodano niestandardowy błąd BenchmarksError.NO_METRICS_FOUND, który wskazuje, że dla wybranej kombinacji danych wejściowych nie znaleziono żadnych danych, aby zwiększyć użyteczność.
Niki kanałów w YouTube w statystykach twórcy	Nowa funkcja	Zaktualizowano ContentCreatorInsightsService.GenerateCreatorInsights, aby obsługiwać wyszukiwanie za pomocą nicków kanałów w YouTube przy użyciu YouTubeChannels.youtube_channel_handles (prawidłowe nicki kanałów muszą zaczynać się od @, np. @channel_handle). Ta opcja jest podobna do wyszukiwania według identyfikatorów kanałów w YouTube. Odpowiedź zawiera statystyki dotyczące wybranych twórców YouTube.
Rekomendacje
Rekomendacje dotyczące stawek CPA i ROAS	Nowe rekomendacje	Dodaliśmy symbole Recommendation.raise_target_cpa_performance_bid_too_low_recommendation (RAISE_TARGET_CPA_PERFORMANCE_BID_TOO_LOW) i Recommendation.lower_target_roas_performance_bid_too_low_recommendation (LOWER_TARGET_ROAS_PERFORMANCE_BID_TOO_LOW) oraz ApplyRecommendationOperation.raise_target_cpa_performance_bid_too_low i ApplyRecommendationOperation.lower_target_roas_performance_bid_too_low, aby umożliwić podwyższanie docelowego CPA lub obniżanie docelowego ROAS, gdy stawki są zbyt niskie, aby kampanie w sieci wyszukiwania mogły brać udział w aukcjach: RaiseTargetCpaPerformanceBidTooLowRecommendation zapewnia recommended_target_multiplier (czynnik większy niż 1.0) i current_average_target_cpa_micros; zastosuj go za pomocą RaiseTargetCpaPerformanceBidTooLowParameters z target_cpa_multiplier. LowerTargetRoasPerformanceBidTooLowRecommendation zapewnia recommended_target_multiplier (współczynnik mniejszy niż 1.0) i current_average_target_roas. Zastosuj go za pomocą LowerTargetRoasPerformanceBidTooLowParameters z target_roas_multiplier.
Raporty
Segmenty wymiarów planu podróży do hotelu	Nowe segmenty	Dodaliśmy do Segments te segmenty wymiarów planu podróży i rezerwacji hotelu (do wyboru za pomocą campaign, ad_group i customer): Segments.advance_booking_window: okres rezerwacji z wyprzedzeniem w przypadku planu podróży (w dniach). Segments.length_of_booking: długość rezerwacji w dniach. Segments.start_date: data rozpoczęcia rezerwacji w formacie yyyy-MM-dd. Segments.start_day_of_week: dzień tygodnia (DayOfWeek), w którym rozpoczyna się rezerwacja. Segments.user_set_dates: wskazuje, czy wybrano daty określone przez użytkownika (HotelDateSelectionType).
Dane reklam pionowych	Nowe dane	Dodaliśmy do Metrics te dane na potrzeby raportowania reklam z branży hotelarskiej i turystycznej (można je wybrać za pomocą campaign, ad_group i customer): Metrics.vertical_ads_average_booking_value_micros: średnia stawka dzienna ważona kliknięciami w mikrogroszach, z uwzględnieniem podatków i opłat, za cały okres pobytu w przypadku rezerwacji hotelowych. Metrics.vertical_ads_potential_impressions: łączna liczba zakwalifikowanych wyświetleń z ograniczeniem liczby wyświetleń dostępnych w kontekście zapytania. Metrics.vertical_ads_price_difference_percentage: procentowa różnica między ceną oferowaną przez reklamodawcę a najniższą ceną konkurencji za tę samą usługę.
Segmenty reklam pionowych	Nowe segmenty	Dodaliśmy do metody Segments te segmenty na potrzeby raportowania reklam branżowych dotyczących hoteli i podróży (można je wybierać za pomocą pól campaign, ad_group i customer): Segments.vertical_ads_price_tier: przedział cenowy reklamodawcy (HotelPriceBucket) w porównaniu z konkurentami w aukcji. Segments.vertical_ads_rate_rule_id: identyfikator reguły dotyczącej ceny powiązany z regułą dotyczącą ceny reklamodawcy. Segments.vertical_ads_rate_type: typ stawki (HotelRateType) rezerwacji hotelu.

wersja 25.1 (19.08.2026)

W interfejsie Google Ads API w wersji 25.1 dodaliśmy te nowe funkcje i aktualizacje: Wersje pomocnicze, takie jak 25.1, nie zawierają zmian powodujących niezgodność.

Funkcje i aktualizacje	Typ	Opis
Zasoby
AssetFieldType.TEXT_DISCLAIMER ServedAssetFieldType.TEXT_DISCLAIMER	Nowe wartości typu wyliczeniowego	Dodaliśmy obsługę komponentów z tekstem wyłączenia odpowiedzialności.
Kampanie
Campaign.aca_migration_date_time Campaign.broad_match_migration_date_time	Nowe pola	Śledź nadchodzącą automatyczną migrację do funkcji AI Max.
Konwersje
Pomiary wyników marki	Nowe funkcje	Dodaliśmy obsługę pomiarów wyników marki i wprowadziliśmy te zmiany: Dodaliśmy nowe zasoby wymiarowe tylko do odczytu na potrzeby wyników badania wzrostu: LiftMeasurementAgeRange, LiftMeasurementCampaign, LiftMeasurementDevice, LiftMeasurementGender i LiftMeasurementVideo. Dodaliśmy nowe segmenty i dane, aby obsługiwać analizę wyników marki za pomocą LiftMeasurementConfig i nowych zasobów wymiarowych. Dodano te wyliczenia: BrandLiftMeasurementType, LiftMeasurementFlightStatus, SurveyIntendedAction, SurveyLiftFlightTargetResponseMode i SurveySubjectType.
Pomiary Zwiększenia liczby konwersji	Nowe funkcje	Dodaliśmy obsługę pomiarów zwiększenia liczby konwersji z tymi aktualizacjami: Dodano nowy zasób tylko do odczytu LiftMeasurementConfig reprezentujący badanie wyników. Dodaliśmy nowe segmenty, które można wybrać, aby dzielić na segmenty i filtrować wyniki dotyczące wzrostu. Dodaliśmy 24 nowe dane dotyczące wzrostu liczby konwersji i wyników zwycięzcy, które umożliwiają szczegółową analizę statystyczną skuteczności wzrostu. Dodano obsługę pobierania szczegółów kampanii i celów konwersji. Dodaliśmy nowe pole opcjonalne Experiment.lift_measurement_config. Dodano wyliczenie ConversionLiftIncludedConversionActionTypes.
LiftMeasurementFlight	Nowy zasób	Nowy zasób tylko do odczytu, który reprezentuje szczegóły okresu pomiaru w konfiguracji pomiaru wyników, w tym daty rozpoczęcia i zakończenia okresu pomiaru (start_date i end_date).
Ogólne
SmartCampaignError	Nowe wartości typu wyliczeniowego	Dodaliśmy nowe kody błędów dotyczące ograniczeń generowania kampanii Performance Max: 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	Nowa wartość typu wyliczeniowego lub błąd	Zwracany, gdy projekt w chmurze Google z poziomem dostępu TEST próbuje wysyłać żądania do konta innego niż testowe.
Planowanie
Statystyki dotyczące nastawienia do marki	Nowe funkcje	Dodaliśmy obsługę statystyk dotyczących nastawienia do marki w ContentCreatorInsightsService: Dodaliśmy komunikaty BrandSentimentInsight, SentimentInsightDistribution i SentimentInsightSummary. Dodano wyliczenie Sentiment. Dodano wartość BRAND_SENTIMENT_DATA do typu wyliczeniowego ContentCreatorInsightsSupplementalData. Dodano wartość BRAND do wyliczenia InsightsKnowledgeGraphEntityCapabilities.
BenchmarksService ulepszenia,	Nowe funkcje	Dodaliśmy obsługę kategorii jako filtrów do określania zakresu analizy porównawczej. Obsługiwane są też dodatkowe dane o kluczowym znaczeniu dla firmy: Dodaliśmy opcję porównywania z wszystkimi reklamodawcami, którzy wyświetlają reklamy w co najmniej jednej kategorii produktów i usług, za pomocą BenchmarksService.GenerateBenchmarksMetrics i category_filter. Wyświetlamy więcej danych o reklamach klientów, takich jak łączny koszt i liczba wyświetleń, oraz dane dotyczące udostępniania, np. share_of_voice. Dane są zwracane za pomocą AggregateMetrics i ShareMetrics. Listę obsługiwanych kategorii można pobrać za pomocą metody BenchmarksService.ListBenchmarksSources z typem źródła CATEGORY.
status rodzicielski,	Nowa funkcja	Dodaliśmy obsługę kierowania na status rodzicielski w planowaniu zasięgu. Dodano nowe pole parental_statuses do Targeting w przypadku usługi ReachPlanService.GenerateReachForecast oraz parental_statuses do PlannableTargeting w przypadku usługi ReachPlanService.ListPlannableProducts.
Rekomendacje
Recommendation.campaign_specific_app_goal_recommendation	Nowa rekomendacja	Sugeruje dodanie celu konwersji z aplikacji na poziomie kampanii. Nowy zasób EffectiveAutomaticGoal służy do reprezentowania bieżących celów w ramach tej rekomendacji.
Raporty
Metrics.original_conversion_value	Nowe pole	Reprezentuje pierwotną wartość konwersji z konwersji z możliwością określenia stawki. Jest to wartość konwersji bez korekt przed zastosowaniem jakichkolwiek dostosowań reguł wartości, takich jak reguły wartości konwersji lub dostosowania celów związanych z cyklem życia.
Statystyki dotyczące członkostwa w programie lojalnościowym	Nowe funkcje	Dodaliśmy obsługę segmentowania statystyk według stanu uczestnictwa użytkownika w programie lojalnościowym oraz dodaliśmy podstawowy wymiar uczestnictwa w programie lojalnościowym w przypadku reguł wartości konwersji: Dodaliśmy segment Segments.loyalty_membership, aby umożliwić segmentowanie danych raportu według poziomu programu lojalnościowego użytkownika, który dokonał konwersji. Dodaliśmy wymiar podstawowy LOYALTY_MEMBERSHIP, aby określać, kiedy warunek członkostwa w programie lojalnościowym został spełniony w przypadku reguły wartości konwersji.
Kierowanie
vertical_ads_item_bid	Nowy typ kryterium	Dodaliśmy nowy typ kryterium vertical_ads_item_bid do AdGroupCriterion.criterion.

wersja 25 (22.07.2026)

W interfejsie Google Ads API w wersji 25, która jest wersją główną, dodaliśmy te nowe funkcje, aktualizacje i zmiany powodujące brak zgodności.

Więcej informacji znajdziesz w artykule Uaktualnianie do najnowszej wersji.

Zmiany powodujące niezgodność

Stan początkowy	Nowy stan	Typ zmiany	Wskazówki dotyczące implementacji
Kampanie
Pola samodzielne additional_value i additional_high_lifetime_value w CustomerLifecycleOptimizationValueSettings	odpowiednio części pól oneof value_adjustment i high_lifetime_value_adjustment, obok nowych pól value_multiplier i high_lifetime_value_multiplier;	Zmiana strukturalna	Zaktualizuj odwołania do tych pól, ponieważ są one teraz częścią typu oneof.
Starsze wersje zasobów CustomerLifecycleGoal i CampaignLifecycleGoal, odpowiadające im usługi CustomerLifecycleGoalService i CampaignLifecycleGoalService oraz starsze wersje ustawień i typów wyliczeniowych (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings)	Brak	Usunięcie	Użyj ulepszonego schematu ujednoliconych celów: Użyj pola new_customer_acquisition_goal_settings w zasobie Goal. Aby skonfigurować zastąpienia na poziomie kampanii, użyj pola campaign_new_customer_acquisition_settings w zasobie CampaignGoalConfig.
Ogólne
Zagnieżdżone pola typu wyliczeniowego w komunikatach żądań i odpowiedzi usługi zachęt: FetchIncentiveRequest.type Incentive.type IncentiveOffer.type	Samodzielne pola typu wyliczeniowego: FetchIncentiveRequest.incentive_type Incentive.incentive_type IncentiveOffer.offer_type	Zmiana nazwy lub usunięcie	Zamiast starszych pól type używaj nowych samodzielnych pól typu wyliczeniowego.
Pola opcjonalne selected_incentive_id i customer_id w ApplyIncentiveRequest	Pola wymagane	Zmiana zachowania	Podczas wywoływania funkcji ApplyIncentive podaj oba pola.
Pole adresu e-mail klienta ContactDetails.email w zasobie LocalServicesLead.	Brak	Usunięcie	Usuń odwołania do tego pola, ponieważ nie jest ono już obsługiwane.
Opcjonalne pole allowed_domain w AdvertisingPartnerLinkInvitationProperties	Pole wymagane podczas wywoływania funkcji CreateProductLinkInvitation w przypadku partnera reklamowego	Zmiana zachowania	Podczas tworzenia zaproszenia do połączenia usług dla partnera reklamowego podaj allowed_domain.
Planowanie
Pole search_brand w GenerateCreatorInsightsRequest	Brak	Usunięcie	Zamiast tego użyj search_topics.
Pole plannable_location_id w Targeting i pole cookie_frequency_cap w GenerateReachForecastRequest	Brak	Usunięcie	Przejdź na plannable_location_ids i cookie_frequency_cap_setting.
Raporty
Pole customer_metrics w GenerateBenchmarksMetricsResponse i BreakdownMetrics typu Metrics	Pole typu CustomerMetrics	Zmiana typu lub zmiana zachowania	Zaktualizuj integracje, aby używać nowego typu CustomerMetrics, który zawiera tylko dane o skuteczności reklam klienta.

Funkcje i aktualizacje (niepowodujące przerw w działaniu)

Funkcje i aktualizacje	Typ	Opis
Reklamy
AssetAutomationType.GENERATE_ANIMATED_IMAGES_FROM_OTHER_ASSETS	Nowa wartość typu wyliczeniowego / nowe działanie	Dostępne dla dostawcy DemandGenMultiAssetAds. Jeśli ta opcja jest włączona, generuje animowane obrazy na podstawie obrazów nieanimowanych. Nowe DemandGenMultiAssetAds są domyślnie włączone od tej wersji interfejsu API.
Możliwość zmiany informacji o treściach syntetycznych	Zmiana zachowania	Parametry Asset.synthetic_content_info i Ad.synthetic_content_info są teraz w pełni modyfikowalne w wersjach 25, 24 i 23.
Kampanie
Cel dotyczący utrzymania lojalnych klientów	Nowe funkcje i ustawienia	Dodano obsługę celu utrzymania klientów w programie lojalnościowym, który umożliwia reklamodawcom optymalizowanie kampanii pod kątem zatrzymywania uczestników programu lojalnościowego. Dodano wartość LOYALTY_RETENTION do typu wyliczeniowego GoalType. Dodaliśmy parametr CampaignGoalConfig.campaign_loyalty_retention_settings, aby umożliwić konfigurowanie ustawień utrzymania lojalności w kampanii, w tym dostosowań stawek i wyświetlania korzyści dla uczestników w formacie PLA. Dodaliśmy Goal.loyalty_retention_goal_settings, aby umożliwić konfigurowanie ustawień celu dotyczącego utrzymania lojalnych klientów na poziomie konta. Dodaliśmy nowe kody błędów: LOYALTY_RETENTION_GOAL_INVALID_MODE CANNOT_USE_INCOMPATIBLE_CLO_GOALS LOYALTY_RETENTION_GOAL_ALREADY_EXISTS
Cel dotyczący pozyskiwania nowych klientów	Nowe funkcje i ustawienia	Zaktualizowaliśmy obsługę celu „Pozyskiwanie nowych klientów” w interfejsie Google Ads API, aby odzwierciedlała ona zmieniony ujednolicony schemat celów: Rozszerzyliśmy zasób Goal, aby obsługiwał ustawienia pozyskiwania nowych klientów za pomocą pola new_customer_acquisition_goal_settings. Rozszerzyliśmy zasób CampaignGoalConfig, aby obsługiwał zastąpienia na poziomie kampanii w przypadku pozyskiwania nowych klientów za pomocą pola campaign_new_customer_acquisition_settings. Dodano nowy typ wyliczeniowy CustomerLifecycleOptimizationGoalSubType, aby zdefiniować obsługiwane podtypy celów. Dodano wartość NEW_CUSTOMER_ACQUISITION do typu wyliczeniowego GoalType. Dodaliśmy nowe przyczyny błędów weryfikacji do GoalError: NEW_CUSTOMER_ACQUISITION_GOAL_ALREADY_EXISTS Dodaliśmy nowe przyczyny błędów weryfikacji do CampaignGoalConfigError: 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 Dodano ErrorDetails.incompatible_clo_goal_error_details, aby udostępnić nową strukturę IncompatibleCloGoalsErrorDetails na potrzeby błędów weryfikacji.
Konwersje
Atrybucja konwersji w YouTube przez firmy zewnętrzne	Nowe pola	Dodano obsługę weryfikacji atrybucji konwersji w YouTube za pomocą partnerów zewnętrznych: Dodano CustomerThirdPartyIntegrationPartners.conversion_attribution_integration_partners, aby umożliwić konfigurowanie partnerów integracyjnych na poziomie klienta. Dodano parametr CampaignThirdPartyIntegrationPartners.conversion_attribution_integration_partners, który umożliwia konfigurowanie partnerów integracyjnych na poziomie kampanii. Więcej informacji znajdziesz w artykule w Centrum pomocy.
Ogólne
ContactDetails.phone_number_extension	Nowe pole	Dodano do zasobu LocalServicesLead.
IncentiveError	Nowe wartości typu wyliczeniowego i błędy	Dodaliśmy nowe kody błędów dotyczące niepowodzeń przy wykorzystywaniu zachęt: BILLING_COUNTRY_NOT_ELIGIBLE (kraj rozliczenia klienta nie kwalifikuje się do otrzymania zachęty) USER_IS_MCC_MANAGER (użytkownik jest właścicielem konta menedżera i nie może wykorzystać zachęty) USER_SUSPENDED (konto klienta jest zawieszone) MAX_PENDING_INCENTIVES (klient osiągnął maksymalną liczbę oczekujących zachęt) ACCOUNT_HAD_RECENT_SPEND (na koncie odnotowano ostatnio wydatki i nie kwalifikuje się ono do usunięcia) MAX_INCENTIVES_REDEEMED_FROM_OFFER (klient wykorzystał już maksymalną liczbę zachęt w ramach tej oferty). MISMATCHING_BILLING_COUNTRY_CODE (kod kraju rozliczenia podany w żądaniu nie pasuje do kraju konta klienta)
Planowanie
Szczegóły kanału YouTube w statystykach trendów	Nowe pola	Dodaliśmy obsługę większej liczby szczegółów kanału na YouTube dotyczących podobnych filmów podczas wyszukiwania statystyk trendów wyszukiwania. Dodaliśmy nowe pola channel_id, channel_name i channel_url do YouTubeVideoAttributeMetadata.
YouTubeChannelInsights.data_sharing_consent_given	Nowe pole	Dodany do: YouTubeChannelInsights. Dotyczy to sytuacji, gdy twórca wyraził zgodę na udostępnianie danych niepublicznych. Jeśli tak, zostaną wypełnione te pola: average_views_per_video average_likes_per_video average_comments_per_video engagement_rate channel_audience_attributes
Raporty
ad_sub_format_type	Nowy segment	Zawiera podział reklam In-Stream w YouTube niemożliwych do pominięcia według czasu trwania: INSTREAM_NON_SKIPPABLE_STANDARD (reklama In-Stream niemożliwa do pominięcia o standardowym czasie trwania) INSTREAM_NON_SKIPPABLE_MAX30_SEC (reklama In-Stream niemożliwa do pominięcia, która trwa nie dłużej niż 30,99 sekundy) INSTREAM_NON_SKIPPABLE_MAX60_SEC (reklama In-Stream niemożliwa do pominięcia, która trwa nie dłużej niż 60,99 sekundy) Ten segment musi być zawsze wybierany razem z segmentem ad_format_type. Można go wybrać za pomocą tych parametrów: AdGroup, AdGroupAd, Campaign, Customer, Video i VideoEnhancement.
Dane społecznościowe dotyczące filmów	Nowe pola / dane	Dodaliśmy dane społecznościowe dotyczące filmów, aby pomóc reklamodawcom śledzić zaangażowanie użytkowników (komentarze, polubienia i udostępnienia) w przypadku reklam w Shorts na YouTube: Metrics.youtube_comments Metrics.youtube_likes Metrics.youtube_shares Są one dostępne w AdGroup, AdGroupAd, Asset, Campaign, Customer i Video.

Wersje główne i podrzędne v24

Interfejs Google Ads API w wersji 24 zawiera te nowe funkcje, aktualizacje i zmiany powodujące niezgodność.

Wersja 24.2 (24.06.2026)

W interfejsie Google Ads API w wersji 24.2 dodaliśmy te nowe funkcje i aktualizacje: Wersje podrzędne, takie jak v24.2, nie zawierają zmian powodujących niezgodność.

Funkcje i aktualizacje	Typ	Opis
Reklamy
AssetAutomationType.GENERATE_LANDING_PAGE_TEXT	Nowa wartość typu wyliczeniowego	Generuje informacje tekstowe ze strony docelowej, które mają być wyświetlane w panelu zaangażowania w przypadku wystąpień DemandGenVideoResponsiveAd (które są domyślnie włączone od tej wersji interfejsu API).
Zasoby
AssetGroup.google_local_services_info	Nowe pole	Dodano, aby obsługiwać informacje o Reklamach Usług Lokalnych (identyfikator kategorii i objaśnienia) w kampaniach Performance Max.
AssetGroupSignal.local_services_id	Nowe pole	Dodaliśmy obsługę sygnałów identyfikatora usługi Reklam Usług Lokalnych w kampaniach Performance Max.
AssetGroupSignal.vertical_ads_item_group_rule_list	Nowe pole	Dodano obsługę reguł grupy produktów w reklamach w branżach, które umożliwiają wybieranie produktów z dołączonych plików danych o branżach w kampaniach Performance Max. Ta funkcja jest dostępna tylko na kontach znajdujących się na liście dozwolonych.
AssetGroupErrorEnum.CANNOT_REMOVE_ALL_ASSET_GROUPS_FROM_CAMPAIGN	Nowa wartość typu wyliczeniowego / błąd	Zwracany podczas próby usunięcia wszystkich grup plików z kampanii.
AssetGroupSignalErrorEnum.CANNOT_REMOVE_ALL_SIGNALS	Nowa wartość typu wyliczeniowego lub błąd	Zwracany podczas próby usunięcia wszystkich sygnałów z grupy plików.
Kampanie
Campaign.PmaxCampaignSettings.local_services_pmax_campaign_settings Campaign.PmaxCampaignSettings.local_services_enabled	Nowe pola	Obsługa identyfikacji kampanii Performance Max dla Usług lokalnych.
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps	Nowe pole	Uwzględnia Mapy Google w kanałach, które można wybrać w grupach reklam w kampaniach generujących popyt.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN	Nowa wartość typu wyliczeniowego / błąd	Zwracany podczas próby usunięcia wszystkich lokalizacji z kampanii Performance Max usług lokalnych.
SmartCampaignErrorEnum.CREATION_FAILED	Nowa wartość typu wyliczeniowego / błąd	Zwracany podczas próby utworzenia nowych kampanii inteligentnych.
Konwersje
ConversionOrigin.LOCAL_SERVICES_ADS ConversionActionType.LOCAL_SERVICES_ADS	Nowe wartości typu wyliczeniowego	Reprezentują konwersje, które występują, gdy użytkownik kliknie reklamę usług lokalnych i zadzwoni do reklamodawcy, wyśle do niego wiadomość lub dokona rezerwacji.
Eksperymenty
COMPARE_CAMPAIGNS PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION	Nowe wartości typu wyliczeniowego	Dodaliśmy obsługę nowych typów ExperimentType: COMPARE_CAMPAIGNS: w przypadku eksperymentów z różnymi typami kampanii i niestandardowych eksperymentów z kampaniami Performance Max, które porównują w ramach jednego eksperymentu kilka kampanii tego samego typu lub różnych typów. PMAX_TEXT_CUSTOMIZATION_FINAL_URL_EXPANSION: w przypadku eksperymentów z optymalizacją kampanii Performance Max dotyczących dostosowywania tekstu i rozwinięcia końcowego adresu URL.
Ogólne
Asset.synthetic_content_info Ad.synthetic_content_info	Nowe pola	zawierać atesty dotyczące treści syntetycznych lub treści generowanych przez AI, podzielone na advertiser_attestation (deklaracje dostarczone bezpośrednio przez reklamodawcę) i system_attestation (atesty wykryte automatycznie lub dostarczone przez system); Ta funkcja została przeniesiona do wersji 23 i 22. Aby ułatwić Ci planowanie przyszłych prac związanych z integracją w przypadku wersji 25, interfejs do modyfikowania pól atestu reklamodawcy jest wprowadzany wcześniej w przypadku wersji 22 i nowszych. Interfejs jest widoczny w tych wersjach, ale synthetic_content_info.advertiser_attestation.status i synthetic_content_info.advertiser_attestation.source pozostaną niezmienne w tych wersjach. Jeśli spróbujesz wysłać żądanie modyfikacji w przypadku któregoś z tych pól, pojawi się jeden z tych błędów: „The field attempted to be mutated is immutable” (Pole, które próbowano zmienić, jest niezmienne) lub „Field cannot be set” (Nie można ustawić pola). Od wersji 25 te pola będą w pełni modyfikowalne. Zalecamy używanie interfejsu już teraz do tworzenia i testowania logiki wewnętrznej, aby system był gotowy do pełnego zapisu po wprowadzeniu wersji 25.
zatwierdzenie przez wiele osób	Nowe funkcje	Wersja beta: ta funkcja jest obecnie w wersji beta i może ulec zmianie w przyszłych wersjach. Dodaliśmy obsługę sprawdzania zatwierdzeń przez wiele osób (MPA): Dodano zasób MultiPartyAuthReview i odpowiadający mu MultiPartyAuthReviewService. Dodano typ wyliczeniowy MultiPartyAuthReviewStatus, aby śledzić stan sprawdzania. Dodano CustomerUserAccess.pending_multi_party_auth_review, aby połączyć się z oczekującą opinią. Dodano parametry MutateCustomerUserAccessResult.multi_party_auth_review i MutateCustomerUserAccessInvitationResult.multi_party_auth_review, aby zwracać nazwę powiązanego zasobu opinii. Dodano MultiPartyAuthReviewError w przypadku błędów weryfikacji. Ta funkcja została przeniesiona do wersji v23.3, v22.2 i v21.2.
IncentiveService.FetchIncentive	Zmiana zachowania	Gdy w żądaniu podano nieprawidłowy adres e-mail, metoda zamiast zwracać błąd AuthenticationError.INVALID_EMAIL_ADDRESS, będzie teraz zwracać domyślne oferty zachęt.
Planowanie
GenerateCreatorInsightsRequest.search_topics	Nowe pole	Dodano do usługi ContentCreatorInsightsService.GenerateCreatorInsights. Ta opcja wyszukuje twórców, którzy omawiają dany temat w kraju określonym w polu country_locations (obsługuje wyszukiwanie tylko w 1 kraju).
CREATOR_TOPIC_INSIGHTS	Nowa wartość typu wyliczeniowego	Dodano do InsightsKnowledgeGraphEntityCapabilities, aby oznaczać podmioty do wyszukiwania twórców, którzy mówią o danym temacie. Te elementy powinny być używane w polu search_topics. Pobrano za pomocą AudienceInsightsService.ListAudienceInsightsAttributes.
KnowledgeGraphEntitySearchOptions	Nowy typ / opcje	Zawiera dodatkowe opcje wyszukiwania tematów w ListAudienceInsightsAttributes, w tym opcje pobierania wszystkich tematów obsługiwanych jako atrybuty twórcy i filtrowania według możliwości.
GenerateCreatorInsightsRequest.supplemental_data GenerateTrendingInsightsRequest.supplemental_data	Nowe pola	Opcjonalne dane wejściowe metod ContentCreatorInsightsService. Wypełnienie tego pola powoduje dodanie do odpowiedzi dodatkowych lokalizacji lub atrybutów twórcy.
local_creator_insights related_local_creators	Nowe pola	Wypełniane, gdy supplemental_data zawiera typ wyliczeniowy LOCAL_CREATOR_DATA. Wyświetla lokalnych twórców, których treści były oglądane w wybranym kraju lub którzy w nim mieszkają i wyrazili zgodę na udostępnianie danych o lokalizacji.
GenerateTrendingInsightsRequest.sub_country_locations	Nowe pole	Dodano do ContentCreatorInsightsService.GenerateTrendingInsights, co umożliwia wyszukiwanie popularnych statystyk z użyciem lokalizacji kraju i podlokalizacji.
Raporty
PerformanceMaxPlacementView	Rozszerzenie segmentów	Umożliwia segmentowanie przez ad_network_type.
Zakupy
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads	Nowe pole	Jeśli ma wartość „true”, wykluczenia marek są ignorowane w przypadku reklam produktowych. Obsługiwane tylko w kampaniach produktowych.
Kierowanie
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE	Nowa wartość typu wyliczeniowego / błąd	Zwracany, gdy próbujesz kierować reklamy na niedozwolony język.
Filmy
DataLink.youtube_link_metadata	Nowe pole	Zawiera element brand_channel_id, który określa identyfikator połączonego kanału firmowego w YouTube.

wersja 24.1 (13.05.2026)

W interfejsie Google Ads API w wersji 24.1 dodaliśmy te nowe funkcje i aktualizacje: Wersje podrzędne, takie jak v24.1, nie zawierają zmian powodujących niezgodność.

Funkcje i aktualizacje	Typ	Opis
Reklamy
DemandGenMultiAssetAdInfo.classic_display_images	Nowe pole	Przesłane niestandardowe obrazy wyświetlane bez konieczności stosowania dodatkowych komponentów elastycznych.
Eksperymenty
ADOPT_AI_MAX ADOPT_BROAD_MATCH_KEYWORDS OPTIMIZE_ASSETS PMAX_REPLACEMENT_SHOPPING	Nowe wartości typu wyliczeniowego	Dodaliśmy obsługę nowych typów ExperimentType: ADOPT_AI_MAX: w przypadku eksperymentów, które sprawdzają, jak funkcje AI Max mogą Ci pomóc w pozyskiwaniu większej liczby klientów dzięki sztucznej inteligencji Google i słowom kluczowym w dopasowaniu przybliżonym. ADOPT_BROAD_MATCH_KEYWORDS: w przypadku eksperymentów, które testują, jak słowa kluczowe w dopasowaniu przybliżonym mogą wpływać na liczbę wyszukiwań, w których wyświetlają się Twoje reklamy. OPTIMIZE_ASSETS: w przypadku eksperymentów niestandardowych służących do optymalizacji komponentów. PMAX_REPLACEMENT_SHOPPING: w przypadku eksperymentów, które testują skuteczność Twoich kampanii produktowych w porównaniu z kampanią Performance Max.
Experiment.video_experiment	Nowe pole	Obsługa konfiguracji dotychczasowych eksperymentów YOUTUBE_CUSTOM obejmujących kampanie wideo.
ExperimentArm.asset_testing_info ExperimentArm.asset_groups ExperimentArm.performance_max_experiment_arm_info	Nowe pola	Udostępnia pola do obsługi testowania komponentów, grup plików i ustawień kampanii Performance Max w grupach eksperymentalnych: asset_testing_info: szczegóły komponentów powiązanych z eksperymentalnymi kopiami reklam. asset_groups: lista grup plików w grupie eksperymentalnej w przypadku eksperymentów dotyczących optymalizacji komponentów. performance_max_experiment_arm_info: ustawienia kampanii Performance Max w eksperymentach PMAX_REPLACEMENT_SHOPPING.
Ogólne
CustomerUserAccess.passkey_enabled	Nowe pole	Pole tylko do odczytu wskazujące, czy użytkownik ma włączony klucz dostępu.
Raporty
mobile_device_platform	Nowy segment	Umożliwia segmentowanie raportów według platformy urządzenia użytkownika (np. iOS lub Android).
REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED	Nowa wartość typu wyliczeniowego / błąd	Zwracany, gdy żądany dzienny, godzinowy lub tygodniowy stopień szczegółowości czasu nie jest obsługiwany w przypadku zakresów dat zapytania (dostępny tylko w przypadku ostatnich 37 miesięcy).
vertical_ads_listing_user_rating vertical_ads_listing_venue	Nowe segmenty	Nowe segmenty do wykorzystania w reklamach pionowych.
user_rating, venue, event_participant_display_name	Nowe kryteria filtra	Obsługiwane filtrowanie w VerticalAdsItemGroupRuleInfo w przypadku zasobu SharedCriterion.
Dane eksperymentu z grupą kontrolną i eksperymentalną	Nowe pola	Dodano wartości kontrolne (control_clicks itd.), wartości eksperymentalne (clicks itd.), szacunki punktowe (clicks_point_estimate itd.), marginesy błędu (clicks_margin_of_error itd.) i wartości p (clicks_p_value itd.) w 7 głównych rodzinach danych (kliknięcia, wyświetlenia, koszt, konwersje, koszt konwersji, wartość konwersji, wartość konwersji na koszt).
Dane o bezwzględnej zmianie liczby konwersji	Nowe pola	Obsługa Conversionsszacowania różnic bezwzględnych za pomocą pól szacowania punktowego, zakresu błędu i wartości p.
Kierowanie
CriterionErrorEnum.CANNOT_EXCLUDE_ALL_TARGETS	Nowa wartość typu wyliczeniowego / błąd	Zwracany podczas próby wykluczenia wszystkich typów kierowania demograficznego.
Filmy
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR	Nowa wartość typu wyliczeniowego	Opublikowaliśmy ZEFR jako zewnętrznego partnera integracyjnego ds. widoczności.
DataLink.youtube_video.channel_id	Nowe pole	Udostępnia identyfikator kanału YouTube powiązany z połączeniem danych.

Wersja 24 (22.04.2026)

W wersji 24 interfejsu Google Ads API, która jest wersją główną, dodaliśmy te nowe funkcje, aktualizacje i zmiany powodujące niezgodność.

Więcej informacji znajdziesz w artykule Uaktualnianie do najnowszej wersji.

Zmiany powodujące niezgodność

Stan początkowy	Nowy stan	Typ zmiany	Wskazówki dotyczące implementacji
Reklamy
Opcjonalne: videos i logo_images w DemandGenVideoResponsiveAdInfo	Pola wymagane	Zmiana zachowania	Podczas tworzenia lub modyfikowania elastycznych reklam wideo generujących popyt podaj videos i logo_images.
Opcjonalne: videos, business_name i logo_images w VideoResponsiveAdInfo	Pola wymagane	Zmiana zachowania	Podaj wartości videos, business_name i logo_images podczas tworzenia lub modyfikowania elastycznych reklam wideo. Pamiętaj, że VideoResponsiveAdInfo można teraz zmieniać.
Kampanie
Campaign.video_brand_safety_suitability	Brak	Usunięcie	Ustawienie dopasowania na poziomie kampanii zostało usunięte. Dopasowanie do marki pod kątem bezpieczeństwa marki jest nadal dostępne na poziomie klienta. Zamiast niej używaj Customer.video_brand_safety_suitability.
Konwersje
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	Brak	Usunięcie	Kategoria użytkowników „Rejestracje w programie lojalnościowym” została usunięta. Usuń odwołania do niego w kodzie.
Planowanie
Typ InsightsAudienceAttributeGroup dla topic_audience_combinations	Typ: common.InsightsAudienceAttributeGroup	Zmiana zachowania lub typu	Integracje z typowanymi bibliotekami klienta muszą zostać zaktualizowane, aby korzystały z nowych przestrzeni nazw zasobów.
Pole youtube_select_lineups w ReachPlanService.ListPlannableProducts	Brak	Usunięcie	Przełącz na korzystanie z lineupów z: youtube_select_lineup_targeting.
Pole is_brand_connect_creator w usługach ContentCreatorInsightsService.GenerateCreatorInsights i GenerateTrendingInsights	Brak	Usunięcie	Zamiast tego sprawdź, czy twórca ma CREATOR_PARTNERSHIPS dostępne w partnership_opportunities.
geo_modifiers i biddable_keywords w: KeywordPlanIdeaService.GenerateKeywordForecastMetrics	geo_target_constants i keywords	Zmiana nazwy lub usunięcie	Zastąpione przez: CampaignToForecast.geo_target_constants[] i ForecastAdGroup.keywords[].
Wycofane pola planu / prognozy słów kluczowych w wersji GenerateKeywordForecastMetrics	Brak	Usunięcie	Usunęliśmy te pola i typy planów / prognoz: CampaignToForecast.keyword_plan_network CampaignToForecast.negative_keywords i ForecastAdGroup.negative_keywords ForecastAdGroup.max_cpc_bid_micros BiddableKeyword CriterionBidModifier KeywordForecastMetrics.impressions KeywordForecastMetrics.click_through_rate Odpowiednio zaktualizuj integracje.
Raporty
Segment ad_sub_network_type w campaign_budget	Brak	Usunięcie	Usunięto segment ad_sub_network_type z zasobu campaign_budget.
click_type segment w widokach komponentów,	Brak	Usunięcie	Usunięto segment z widoków AdGroupAsset, CampaignAsset i CustomerAsset.
Filmy
Częściowe niepowodzenie dozwolone w ShareablePreviewService.GenerateShareablePreviews	Brak częściowego niepowodzenia	Zmiana zachowania	Żądania zakończą się niepowodzeniem i wyświetlą błąd, jeśli którykolwiek z identyfikatorów nie przejdzie weryfikacji.
ShareablePreviewError – kody starszego typu: ASSET_GROUP_DOES_NOT_EXIST_UNDER_THIS_CUSTOMER TOO_MANY_ASSET_GROUPS_IN_REQUEST	MutateErrorEnum.RESOURCE_NOT_FOUND ShareablePreviewError.TOO_MANY_RESOURCES_IN_REQUEST	Zmiana nazwy / zmiana zachowania	Kody błędów zwracane w przypadku grup plików zostały zmodyfikowane, aby były zgodne z błędami reklam w grupach reklam. Zaktualizuj logikę przechwytywania walidacji.

Funkcje i aktualizacje (niepowodujące błędów)

Funkcje i aktualizacje	Typ	Opis
Reklamy
Zmienność: VideoResponsiveAdInfo	Zmiana zachowania	Obiekty informacyjne elastycznych reklam wideo można teraz modyfikować.
Zasoby
travel_feed_data w: AssetSet	Nowe pole	Dodano, aby pobierać atrybuty komponentów pliku danych o podróżach (hotel_center_account_id, merchant_center_id, partner_center_id, subset_id, travel_feed_vertical_type).
Kampanie
Campaign.view_through_conversion_optimization_enabled	Nowe pole	Umożliwia włączenie optymalizacji konwersji po wyświetleniu (VTC) (domyślnie false) w kampaniach generujących popyt i kampaniach promujących aplikacje.
CampaignCriterion.gender	Nowa funkcja	Włączyliśmy wykluczenia płci w kampaniach Performance Max we wszystkich wersjach interfejsu Google Ads API.
Konwersje
Typy konwersji związanych ze zdobywaniem potencjalnych klientów	Nowe wartości typu wyliczeniowego	Dodano nowe wyliczenia typów działań powodujących konwersję w GA4/Firebase w ConversionActionType: 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
Ogólne
UserListErrorEnum.DUPLICATE_LOOKALIKE	Nowa wartość typu wyliczeniowego / błąd	Zwracany, gdy próbujesz utworzyć wiele identycznych list podobnych odbiorców.
Planowanie
Pola: ProductCoreAttributes w ListPlannableProductsResponse	Nowe pola	Dodano opis produktu, który można zaplanować, cel marketingowy, model kosztów i metodę zakupu do ProductCoreAttributes w ListPlannableProductsResponse.
Raporty
CartDataSalesView	Nowy zasób raportowania	Udostępnia raporty, które dzielą dane o konwersjach na segmenty według konkretnych produktów sprzedanych (marki itp.) oraz klikniętego produktu.
Wskaźniki nieużywane do określania stawek	Nowe pola	Dodaliśmy do wszystkich pasujących zasobów dane, za które nie można ustalać stawek (dane pokazujące konwersje, pod kątem których kampanie nie są optymalizowane): 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	Nowy segment	Dodany do: ShoppingPerformanceView.
Zakupy
Kampanie promujące aplikacje w: ShoppingProduct	Nowa funkcja	Obsługiwane kampanie promujące aplikacje w zasobie ShoppingProduct. Stan notatki i problemy nie są obsługiwane.
Filtrowanie produktów na podstawie tagów	Nowa funkcja	Wprowadzono dynamiczne filtrowanie za pomocą wyrażeń logicznych: Dodaliśmy typy kryteriów RETAIL_FILTER_BUNDLE i RETAIL_FILTER. Dodaliśmy rodzaj wspólnego zestawu RETAIL_FILTER. Dodano pole retail_filter_bundle do AdGroupCriterion. Dodano pole retail_filter do SharedCriterion. Dodano RETAIL do ListingGroupFilterListingSource. Dodano wymiar RetailFilter do: AssetGroupListingGroupFilter. Dodaliśmy powiązane nowe błędy weryfikacji w CriterionError i AssetGroupListingGroupFilterError. Ta funkcja jest dostępna tylko na kontach znajdujących się na liście dozwolonych.

Wersje główne i podrzędne v23

Wersja 23 interfejsu Google Ads API zawiera te nowe funkcje, aktualizacje i zmiany powodujące niezgodność.

wersja 23.3 (24.06.2026)

W interfejsie Google Ads API w wersji 23.3 dodaliśmy te nowe funkcje i aktualizacje: Wersje pomocnicze, takie jak 23.3, nie zawierają zmian powodujących niezgodność.

Funkcje i aktualizacje	Typ	Opis
Ogólne
Asset.synthetic_content_info Ad.synthetic_content_info	Nowe pola	Zawierają atesty dotyczące treści syntetycznych lub wygenerowanych przez AI, podzielone na advertiser_attestation (deklaracje dostarczone bezpośrednio przez reklamodawcę) i system_attestation (atesty automatycznie wykryte lub dostarczone przez systemy Google). Aby ułatwić Ci planowanie przyszłych prac związanych z integracją wersji 25, interfejs do modyfikowania pól atestu reklamodawcy jest wprowadzany wcześniej w przypadku wersji 22 i nowszych. Interfejs jest widoczny w tych wersjach, ale synthetic_content_info.advertiser_attestation.status i synthetic_content_info.advertiser_attestation.source pozostaną niezmienne w tych wersjach. Jeśli spróbujesz wysłać żądanie modyfikacji w przypadku któregoś z tych pól, pojawi się jeden z tych błędów: „The field attempted to be mutated is immutable” (Pole, które próbowano zmienić, jest niezmienne) lub „Field cannot be set” (Nie można ustawić pola). Od wersji 25 te pola będą w pełni modyfikowalne. Zalecamy korzystanie z interfejsu już teraz, aby tworzyć i testować logikę wewnętrzną, dzięki czemu Twój system będzie gotowy na pełne możliwości zapisu po wprowadzeniu wersji 25.
Zatwierdzenia przez wiele osób	Nowe funkcje	Wersja beta: ta funkcja jest obecnie w wersji beta i może ulec zmianie w przyszłych wersjach. Dodano obsługę sprawdzania zatwierdzeń przez wiele osób (MPA): Dodano zasób MultiPartyAuthReview i odpowiadający mu MultiPartyAuthReviewService. Dodano wyliczenie MultiPartyAuthReviewStatus do śledzenia stanu opinii. Dodano CustomerUserAccess.pending_multi_party_auth_review, aby utworzyć link do oczekującej opinii. Dodano parametry MutateCustomerUserAccessResult.multi_party_auth_review i MutateCustomerUserAccessInvitationResult.multi_party_auth_review, aby zwracać nazwę powiązanego zasobu opinii. Dodano MultiPartyAuthReviewError w przypadku błędów weryfikacji.

wersja 23.2 (25.03.2026)

W interfejsie Google Ads API w wersji 23.2 dodaliśmy te nowe funkcje i aktualizacje. Wersje pomocnicze, takie jak v23.2, nie zawierają zmian powodujących niezgodność.

Funkcje i aktualizacje	Typ	Opis
Zasoby
VideoEnhancement	Nowy zasób	Zawiera informacje o ulepszeniach reklam wideo, np. czy zostały wygenerowane przez Google czy dostarczone przez reklamodawcę. Więcej informacji znajdziesz w artykule Ulepszenia filmów.
AppTopCombinationView	Nowy zasób	Zasób tylko do odczytu, który dostarcza statystyk dotyczących najskuteczniejszych kombinacji komponentów w kampaniach promujących aplikacje.
CustomerAsset	Nowa funkcja	Dodaliśmy obsługę pobierania CustomerAsset z parametrem field_type ustawionym na BUSINESS_LOGO.
Kampanie
AdGroupAd.start_date_time AdGroupAd.end_date_time	Nowe pola	Określaj bardziej szczegółowe ograniczenia harmonogramu w zakresie dat kampanii. Ta funkcja jest obsługiwana tylko w przypadku niektórych typów grup reklam.
HotelSettingInfo.disable_hotel_setting	Nowe pole	Umożliwia wyłączenie pliku danych o hotelach w kampaniach generujących popyt.
Ogólne
CustomerClientLinkError	Nowe wartości typu wyliczeniowego lub błędy	Dodaliśmy 2 nowe kody błędów: MAX_CUSTOMER_LIMIT_REACHED i ACCOUNT_CREATION_POLICY_VIOLATION.
UserListCustomerTypeCategoryEnum.LOYALTY_SIGN_UPS	Zmiana zachowania	Podczas próby użycia tej wycofanej kategorii typu klienta na liście użytkowników występuje teraz błąd.
Planowanie
GenerateTrendingInsights GenerateCreatorInsights	Nowe funkcje	Dodaliśmy obsługę niestandardowych kombinacji encji, tematów i odbiorców z użyciem operatorów AND/OR.
ReachPlanService.GenerateReachForecast	Nowe wartości typu wyliczeniowego	Dodaliśmy nowe przedziały wiekowe, na które można kierować reklamy, np. AGE_RANGE_21_44 lub AGE_RANGE_21_49.
youtube_select_lineup_targeting	Nowe pole	Dodano do ReachPlanService.ListPlannableProducts, który zastąpi youtube_select_lineups. Oba pola są obecnie wypełnione.
ReachPlanSurface	Nowa wartość typu wyliczeniowego	Dodaliśmy IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS jako opcję platformy.
Forecast	Nowe pole	Dodano clicks w przypadku kampanii generujących popyt z określaniem stawek pod kątem maksymalizacji liczby kliknięć (CPC) w sekcji ReachPlanService.GenerateReachForecast.
partnership_opportunities	Nowe pole	Dodano do folderów ContentCreatorInsightsService.GenerateCreatorInsights i ContentCreatorInsightsService.GenerateTrendingInsights.
Raporty
biddable_indirect_install_first_in_app_conversion_micros	Nowe pole	Dodano do zasobów Campaign, Customer i AdGroup.
Filmy
ShareablePreviewService	Nowa funkcja	Rozszerzono obsługę podglądów transmisji na żywo w YouTube przez ustawienie parametru preview_type na YOUTUBE_LIVE_PREVIEW. Dodano użytkowników UNSUPPORTED_AD_TYPE i TOO_MANY_RESOURCES_IN_REQUEST do ShareablePreviewError. Jest to obsługiwane tylko w przypadku niektórych typów reklam.

Wersja 23.1 (25.02.2026)

W interfejsie Google Ads API w wersji 23.1 dodaliśmy te nowe funkcje i aktualizacje: Wersje podrzędne, takie jak v23.1, nie zawierają zmian powodujących niezgodność.

Funkcje i aktualizacje	Typ	Opis
Zarządzanie kontem
advertising_partner_properties.allowed_domain	Nowe pole	Dodano do zasobów ProductLinkInvitation i ProductLink. Partner reklamowy będzie mógł wyświetlać reklamy tylko w tej domenie.
Customer.contains_eu_political_advertising	Nowe pole	Pobiera stan deklaracji na poziomie konta, czy zawiera reklamy polityczne kierowane na UE, i zwraca wartość EuPoliticalAdvertisingStatus.
Kampanie
Campaign.text_guidelines	Nowe pole	Dodaliśmy obsługę wskazówek dotyczących tekstu, których można używać w kampaniach Performance Max i kampaniach w sieci wyszukiwania do automatycznego kontrolowania komponentów tekstowych generowanych przez AI. W text_guidelines możesz zdefiniować term_exclusions i messaging_restrictions.
CampaignPrimaryStatusReason	Nowe wartości typu wyliczeniowego	Dodaliśmy pola CAMPAIGN_NOT_BOOKED, BOOKING_HOLD_EXPIRING, BOOKING_HOLD_EXPIRED i BOOKING_CANCELLED, aby podawać przyczyny stanu podstawowego w przypadku kampanii ze strategią ustalania stawek FIXED_CPM.
Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure Campaign.VideoCampaignSettings.booking_details	Nowe pola	Dodaliśmy obsługę samodzielnie zadeklarowanej kategorii reklamy z rezerwacją i szczegółów rezerwacji tylko do odczytu.
Campaign.missing_eu_political_advertising_declaration	Nowe pole	Umożliwia wysyłanie zapytań i filtrowanie kampanii, w których brakuje deklaracji dotyczących tego, czy zawierają reklamy polityczne kierowane na UE.
Konwersje
ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS	Nowa wartość typu wyliczeniowego	Umożliwia śledzenie użytkowników, którzy oglądają reklamę, a następnie film z tego samego kanału.
Ogólne
CriterionErrorEnum.CANNOT_TARGET_ONLY_UNDETERMINED	Nowa wartość typu wyliczeniowego lub błąd	Zwracany, gdy próbujesz kierować reklamy tylko na nieokreśloną kategorię w wymiarach demograficznych.
Zachęty
IncentiveErrorEnum	Nowe wartości typu wyliczeniowego lub błędy	Dodaliśmy 2 nowe kody błędów: MAX_INCENTIVES_REDEEMED i ACCOUNT_TOO_OLD. Te błędy mogą być zwracane w przypadku żądań wysyłanych 11 marca 2026 r. lub później.
Planowanie
GenerateBenchmarksMetrics	Nowa funkcja	Dodaliśmy obsługę podziału według daty za pomocą BreakdownDefinition.
ReachPlanService.GenerateReachForecast	Nowa wartość typu wyliczeniowego	Dodano GOOGLE_DISPLAY_NETWORK jako platformę, na którą można kierować reklamy w kampaniach generujących popyt ze strategią Maks. liczby konwersji.
GenerateTrendingInsights	Nowe pola	Dodaliśmy informacje o linii trendu historycznego w TrendInsightDataPoint do TrendInsights podczas wyszukiwania według tematu.
Raporty
Dane dotyczące częstotliwości wśród unikalnych użytkowników	Nowe pola	Dodaliśmy nowe dane, które pokazują, ilu użytkowników widziało Twoją reklamę co najmniej 2, 3, 4, 5 lub 10 razy: unique_users_two_plus, unique_users_three_plus, unique_users_four_plus, unique_users_five_plus i unique_users_ten_plus.
SearchTermMatchSource	Nowa wartość typu wyliczeniowego	Dodano VERTICAL_ADS_DATA_FEED, aby obsługiwać pliki danych reklam w branżach, np. kierowanie na podmioty w reklamach podróży.
YouTubeVideoUpload
YouTubeVideoUpload	Nowa usługa lub zasób	Dodaliśmy usługę YouTubeVideoUpload, która umożliwia przesyłanie filmów do YouTube i zarządzanie nimi, oraz zasób YouTubeVideoUpload, który umożliwia pobieranie stanu przesyłania i metadanych. Ta funkcja jest obsługiwana tylko w przypadku REST i biblioteki klienta Pythona.

Wersja 23 (28.01.2026)

W wersji 23 interfejsu Google Ads API, która jest wersją główną, dodaliśmy te nowe funkcje, aktualizacje i zmiany powodujące niezgodność:

Więcej informacji znajdziesz w artykule Uaktualnianie do najnowszej wersji.

Zmiany powodujące niezgodność

Stan początkowy	Nowy stan	Typ zmiany	Wskazówki dotyczące implementacji
Reklamy
Udostępnianie reklam jest dozwolone	AdGroupAdError.AD_SHARING_NOT_ALLOWED	Zmiana zachowania	Udostępnianie reklam w wielu grupach reklam nie jest już dozwolone. Żądania próby udostępnienia reklam będą zwracać błąd AD_SHARING_NOT_ALLOWED.
Pomoc dotycząca CallAd i CallAdInfo	Brak	Usunięcie	Usunęliśmy obsługę reklam generujących połączenia. Więcej informacji znajdziesz w artykule w Centrum pomocy Reklamy generujące połączenia.
Kampanie
Campaign.start_date Campaign.end_date	Campaign.start_date_time Campaign.end_date_time	Zmiana nazwy / wymiana	Użyj nowych pól daty i godziny, aby określić komponenty czasu dla kampanii. Oryginalne pola zawierające tylko datę zostaną usunięte.
Kreowanie popytu
DemandGenMultiAssetAdInfo.lead_form_only	Brak	Usunięcie	Pole lead_form_only zostało usunięte. Zaktualizuj odwołania w kodzie.
Raporty
Zbiorcze dane i wyliczenia etykiet skuteczności komponentów	Brak	Usunięcie	Usunięto zbiorcze dane dotyczące skuteczności komponentów. W przypadku sieci wyszukiwania i sieci reklamowej nie jest już zwracany typ wyliczeniowy etykiety skuteczności.

Funkcje i aktualizacje (niepowodujące błędów)

Funkcje i aktualizacje	Typ	Opis
Reklamy
AdFormatType	Nowe wartości typu wyliczeniowego	Dodaliśmy nowe typy formatów: TEXT, VERTICAL_ADS_BOOKING_LINK i VERTICAL_ADS_PROMOTION.
Zasoby
asset_group wyświetlenie	Nowe pola	Dodaliśmy te dane: metrics.engagements, metrics.engagement_rate i metrics.average_cpe.
asset_group_asset wyświetlenie	Nowe pola	Dodaliśmy te dane: metrics.average_cpe, metrics.average_cpm, metrics.trueview_average_cpv, metrics.video_trueview_view_rate, metrics.video_trueview_views i metrics.interaction_event_types.
Asset.orientation	Nowe pole	Do komponentów z obrazem i komponentów wideo dodaliśmy pole orientacji tylko do odczytu.
CampaignAsset	Nowa funkcja	Dodano obsługę pobierania komponentów kampanii z parametrem field_type ustawionym na HEADLINE i DESCRIPTION.
ServedAssetFieldType	Nowe wartości typu wyliczeniowego	Dodano pola HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONE i DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_TWO w przypadku komponentów wyświetlanych jako linki do podstron.
BusinessMessageAsset	Nowe funkcje / pomoc	Zaktualizowane komponenty do wysyłania wiadomości do firmy: Dodaliśmy obsługę Facebook Messengera i Zalo jako dostawców. Dodano: FACEBOOK_MESSENGER i ZALO do: BusinessMessageProvider. Dodano pola facebook_messenger_info i zalo_info. Dodano CUSTOMER_NOT_ON_ALLOWLIST_FOR_MESSAGE_ASSETS do: AssetError.
Płatności
InvoiceService.ListInvoices	Nowe opcje	Może teraz zwracać bardziej szczegółowe informacje w Invoice, w tym zestawienie kosztów na poziomie kampanii, szczegółowe koszty regulacyjne i informacje o korektach, po ustawieniu include_granular_level_invoice_details w ListInvoicesRequest.
RegulatoryFeeType UnitOfMeasure	Nowe typy wyliczeniowe	Dodano pomocnicze typy wyliczeniowe dotyczące opłat administracyjnych i jednostek miary.
Kampanie
CampaignError	Nowe wartości typu wyliczeniowego / błędy	Dodano kody błędów DURATION_TOO_LONG_FOR_TOTAL_BUDGET i END_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET.
Konwersje
ConversionActionCategory	Nowa wartość typu wyliczeniowego	Dodaliśmy kolumnę YOUTUBE_FOLLOW_ON_VIEWS, aby umożliwić śledzenie użytkowników, którzy obejrzeli reklamę, a później film z tego samego kanału.
Kreowanie popytu
DemandGenVideoResponsiveAdInfo.companion_banner	Nowe pole	Dodaliśmy obsługę banerów towarzyszących w elastycznych reklamach wideo generujących popyt.
Zachęty
Dodano obsługę zachęt „Wybierz własną” (CYO): Dodaliśmy metodę FetchIncentive, która umożliwia pobieranie dostępnych dla użytkownika spersonalizowanych zachęt. Dodaliśmy metodę ApplyIncentive, która umożliwia zastosowanie wybranej zachęty na koncie klienta. Dodaliśmy zasób AppliedIncentive (można go wyszukiwać za pomocą Search i SearchStream), aby podawać szczegóły wykorzystania. Dodano nowe kody błędów w IncentiveError i AuthenticationError.INVALID_EMAIL_ADDRESS. Aby ułatwić bardziej szczegółowe programowe rozwiązywanie problemów, w przyszłych wersjach dodamy do IncentivesService dodatkowe kody błędów. Zalecamy śledzenie nadchodzących ogłoszeń i informacji o wersji dotyczących tych nowych kodów błędów, aby mieć pewność, że Twoje aplikacje będą mogły obsługiwać te nowe tryby awarii.
Planowanie
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST	Nowa wartość typu wyliczeniowego	Umożliwia tworzenie list odbiorców na podstawie ważnych wydarzeń życiowych w GenerateAudienceCompositionInsights, GenerateSuggestedTargetingInsights, GenerateInsightsFinderReport i GenerateCreatorInsights. Ważne wydarzenia życiowe nie są obsługiwane w przypadku innych metod AudienceInsightsService, takich jak AudienceInsightsService.GenerateAudienceOverlap i AudienceInsightsService.GenerateTargetingSuggestionMetrics.
ReachPlanService.GenerateConversionRates	Nowe pola / opcje	Odpowiedź zawiera teraz platformy, które obsługują sugestie dotyczące współczynnika konwersji na podstawie ustawień platformy (np. Gmail, Shorts). Ta funkcja jest obsługiwana tylko w kampaniach generujących popyt.
LanguageDistribution	Nowe pole / typ	Dodano do YouTubeChannelInsights, aby podawać szczegóły dotyczące dystrybucji języków w treściach na kanale w YouTube.
BenchmarksService	Nowa usługa	Porównuje dane reklam na YouTube z branżowymi analizami porównawczymi.
AudienceInsightsService.GenerateAudienceDefinition	Nowa metoda	Przekształca opis docelowych odbiorców w formie tekstu swobodnego na pasujące atrybuty odbiorców za pomocą generatywnej AI.
YouTubeChannelInsights.relevance_score	Nowe pole	Ocenia, jak bardzo twórca jest odpowiedni do danego tematu, z uwzględnieniem liczby wyświetleń.
TrendInsightMetrics.trend_change_percent	Nowe pole	Przedstawia procentową zmianę wartości trendu w okresie porównawczym.
Rekomendacje
GenerateRecommendationsRequest	Nowe pole	Dodano: is_new_customer. Jeśli w przypadku rekomendacji CAMPAIGN_BUDGET ustawisz wartość true, będzie używany model zoptymalizowany pod kątem nowych klientów (zalecany tylko dla klientów, którzy nie mają kampanii).
Raporty
AdGroupAdAssetView	Obsługa nowych funkcji i danych	Obecnie obsługuje dane o wyświetleniach, skuteczności i konwersjach w przypadku RESPONSIVE_DISPLAY_AD.
ad_sub_network_type segment	Nowy segment	Zapewnia szczegółowe zestawienie skuteczności w ramach sieci reklamowej. Początkowo dostępna w kampaniach generujących popyt w YouTube (reklamy In-Stream, In-Feed i filmy Short). Należy wybrać razem z atrybutem ad_network_type.
Raportowanie w przypadku kampanii Performance Max	Nowa funkcja	Włączyliśmy podział według typu sieci reklamowej w kampaniach Performance Max.
UserLocationView GeographicView	Obsługa nowych segmentów	Dane pomocy podzielone na segmenty według daty konwersji: 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 i cross_device_conversions_value_by_conversion_date.
Segmenty reklam pionowych	Nowe segmenty	Dodano te segmenty: 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 i vertical_ads_vertical.
PerStoreView MatchedLocationInterestView	Nowe zasoby do raportowania	Dodaliśmy PerStoreView, aby umożliwić wysyłanie zapytań o szczegóły lokalizacji sklepu, oraz MatchedLocationInterestView (w przypadku kampanii AI Max), aby udostępniać wskaźniki skuteczności według interesujących użytkowników położeń geograficznych.
Zakupy
ShoppingPerformanceView	Obsługa nowych danych	Teraz obsługuje te dane podzielone według daty konwersji: conversions_by_conversion_date, all_conversions_by_conversion_date, conversions_value_by_conversion_date, value_per_conversions_by_conversion_date i value_per_all_conversions_by_conversion_date.
ShoppingPerformanceView	Obsługa nowych danych	Dodano obsługę tych języków: search_budget_lost_impression_share, search_rank_lost_impression_share, search_budget_lost_absolute_top_impression_share i search_rank_lost_absolute_top_impression_share.
ShoppingProduct.product_image_uri	Nowe pole	Dodany do: ShoppingProduct.
Reklamy pionowe
AdGroup.vertical_ads_format_setting	Nowe pole	Umożliwia kontrolowanie, które formaty reklam mogą wyświetlać się w kampaniach w sieci wyszukiwania korzystających z plików danych o podróżach.
AdGroupCriterion SharedCriterion	Nowe pola lub kryteria	Dodano typ kryterium vertical_ads_item_group_rule_list do AdGroupCriterion i vertical_ads_item_group_rule do SharedCriterion, aby umożliwić kierowanie na grupy produktów w kampaniach w sieci wyszukiwania z plikami danych o miejscach noclegowych.
Integracja pliku danych z reklamami pionowymi	Nowa funkcja	Możesz teraz połączyć plik danych reklam branżowych z kampanią w sieci wyszukiwania korzystającą z funkcji AI Max, aby wyświetlać reklamy promujące obiekty i reklamy z linkiem do rezerwacji obok reklam tekstowych. Kontroluj formaty za pomocą vertical_ads_format_setting i definiuj reguły za pomocą vertical_ads_item_group_rule. Podział raportów na segmenty według wymiarów AdFormatType i wymiarów pliku danych reklam pionowych.
Filmy
AdVideoAssetInfo.ad_video_asset_feature_control	Nowe pole	Dodano opcje sterowania funkcjami komponentów reklam wideo.
CampaignCriterionError	Nowa wartość typu wyliczeniowego / błąd	Dodano kod błędu INVALID_VIDEO_LINEUP_ID.
Dane dotyczące słyszalności w YouTube	Nowe dane	Dodaliśmy dane o słyszalności reklam audio w YouTube, które informują, czy reklama była słyszalna i w przypadku ilu wyświetleń można było zmierzyć słyszalność.

Zarchiwizowane informacje o wersjach

Informacje o wersjach archiwalnych znajdziesz w sekcji Wycofane wersje.