Informacje o wersjach

Aktualną listę wycofanych i planowanych do wycofania funkcji znajdziesz w sekcji Wycofane funkcje.

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.1 (19.08.2026)

W interfejsie Google Ads API w wersji 25.1 dodaliśmy te nowe funkcje i aktualizacje: Wersje pomocnicze, takie jak v25.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ź zbliżającą się automatyczną migrację do AI Max.
Konwersje
Pomiary wyników marki Nowe funkcje Dodaliśmy obsługę pomiarów wyników marki, wprowadzając te zmiany:
Pomiary Zwiększenia liczby konwersji Nowe funkcje Dodaliśmy obsługę pomiarów Zwiększenia liczby konwersji dzięki tym aktualizacjom:
  • Dodano nowy zasób tylko do odczytu LiftMeasurementConfig reprezentujący badanie wzrostu.
  • Dodaliśmy nowe segmenty, które można wybierać do segmentowania i filtrowania wyników wzrostu.
  • Dodaliśmy 24 nowe dane dotyczące Zwiększenia liczby konwersji i dane dotyczące wyniku zwycięzcy, które umożliwiają szczegółową analizę statystyczną skuteczności zwiększenia.
  • 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 reprezentujący szczegóły wyświetlania reklam w konfiguracji pomiaru wyników marki, w tym daty rozpoczęcia i zakończenia pomiaru wyświetlania reklam (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:
AuthorizationErrorEnum.CLOUD_PROJECT_NOT_APPROVED_FOR_PRODUCTION Nowa wartość typu wyliczeniowego lub błąd Zwracany, gdy projekt Google Cloud z poziomem dostępu TEST próbuje wysyłać żądania do konta testowego.
Planowanie
Statystyki dotyczące przywiązania do marki Nowe funkcje Dodaliśmy obsługę statystyk dotyczących opinii o marce w ContentCreatorInsightsService:
Ulepszenia BenchmarksService Nowe funkcje Dodaliśmy obsługę kategorii jako filtrów do określania zakresu analizy porównawczej. Obsługiwane są też dodatkowe kluczowe dane biznesowe:
Kierowanie według statusu rodzicielskiego Nowa funkcja Dodaliśmy obsługę kierowania na status rodzicielski w planowaniu zasięgu. Do usługi ReachPlanService.GenerateReachForecast dodano nowe pole parental_statuses w Targeting, a do usługi ReachPlanService.ListPlannableProducts dodano parental_statuses w PlannableTargeting.
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 pochodzących z konwersji podlegających określaniu stawek. 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 uczestnictwa 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 wersji 25 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
Kampanie
Pola samodzielne additional_value i additional_high_lifetime_value w CustomerLifecycleOptimizationValueSettings Część odpowiednio pól value_adjustment i high_lifetime_value_adjustment typu oneof, wraz z nowymi polami value_multiplier i high_lifetime_value_multiplier Zmiana strukturalna Zaktualizuj odwołania do tych pól, ponieważ są one teraz częścią pól typu oneof.
Starsze zasoby CustomerLifecycleGoal i CampaignLifecycleGoal, odpowiadające im usługi CustomerLifecycleGoalService i CampaignLifecycleGoalService oraz starsze ustawienia/wyliczenia (CustomerAcquisitionGoalSettings, CustomerAcquisitionOptimizationModeEnum, LifecycleGoalValueSettings) Brak Usunięcie Użyj ulepszonego schematu celów ujednoliconych:
Ogólne
Zagnieżdżone pola typu wyliczeniowego w wiadomościach z zapytaniami o usługę i odpowiedziami usługi Incentive Service:
  • FetchIncentiveRequest.type
  • Incentive.type
  • IncentiveOffer.type
 Samodzielne pola wyliczeniowe: Zmiana nazwy lub usunięcie Zamiast starszych pól type używaj nowych, samodzielnych pól wyliczeniowych.
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 konsumenta 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 konta produktu dla partnera reklamowego podaj allowed_domain.
Planowanie
Pole search_brand w GenerateCreatorInsightsRequest Brak Usunięcie Zamiast niej używaj search_topics.
Pole plannable_location_id w Targeting i pole cookie_frequency_cap w GenerateReachForecastRequest Brak Usunięcie Przejdź na używanie plannable_location_ids i cookie_frequency_cap_setting.
Raporty
Pole customer_metrics w usługach 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 lub nowe działanie Dostępne w terminie DemandGenMultiAssetAds. Po włączeniu generuje animowane obrazy na podstawie obrazów nieanimowanych. Nowe DemandGenMultiAssetAds są domyślnie włączone w tej wersji interfejsu API.
Możliwość zmiany informacji o treściach syntetycznych Zmiana zachowania W wersjach 25, 24 i 23 parametry Asset.synthetic_content_info i Ad.synthetic_content_info można teraz w pełni modyfikować.
Kampanie
Cel dotyczący utrzymania klientów w programie lojalnościowym Nowe funkcje i ustawienia Dodaliśmy obsługę celu „Utrzymanie klientów w programie lojalnościowym”, który umożliwia reklamodawcom optymalizowanie kampanii pod kątem utrzymania uczestników programu lojalnościowego.
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:
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: Więcej informacji znajdziesz w tym artykule w Centrum pomocy.
Ogólne
ContactDetails.phone_number_extension Nowe pole Dodano do zasobu LocalServicesLead.
IncentiveError Nowe wartości typu wyliczeniowego lub błędy Dodaliśmy nowe kody błędów dotyczące nieudanych prób wykorzystania zachęt:
Planowanie
Szczegóły kanału w YouTube w statystykach dotyczących trendów Nowe pola Dodaliśmy obsługę większej liczby szczegółów kanału YouTube dotyczących powiązanych filmów podczas wyszukiwania popularnych statystyk. Do tabeli YouTubeVideoAttributeMetadata dodaliśmy nowe pola channel_id, channel_name i channel_url.
YouTubeChannelInsights.data_sharing_consent_given Nowe pole Dodany do: YouTubeChannelInsights. Dotyczy to sytuacji, w której twórca wyraził zgodę na udostępnianie niepublicznych danych. Jeśli tak, zostaną wypełnione te pola:
Raporty
ad_sub_format_type Nowy segment Zawiera podział reklam In-Stream w YouTube niemożliwych do pominięcia według czasu trwania:Ten segment musi być zawsze wybrany razem z segmentem ad_format_type. Można go wybrać za pomocą klawiszy AdGroup, AdGroupAd, Campaign, Customer, Video i VideoEnhancement.
Dane społecznościowe dotyczące filmów Nowe pola i 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 YouTube Shorts: 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 pomocnicze, takie jak 24.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 instancji DemandGenVideoResponsiveAd (które są domyślnie włączone od tej wersji interfejsu API).
Zasoby
AssetGroup.google_local_services_info Nowe pole Dodaliśmy obsługę informacji o Reklamach Usług Lokalnych (identyfikator kategorii i wywołania) 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 plików reklam w branżach, które umożliwiają wybieranie plikó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 lub 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 Pomoc w identyfikowaniu kampanii Performance Max na usługi lokalne.
AdGroup.DemandGenAdGroupSettings.DemandGenChannelControls.DemandGenSelectedChannels.maps Nowe pole Obejmuje Mapy Google w wybieranych kanałach w grupach reklam w kampaniach generujących popyt.
CampaignCriterionErrorEnum.CANNOT_REMOVE_ALL_LOCATIONS_FROM_LOCAL_SERVICES_PMAX_CAMPAIGN Nowa wartość typu wyliczeniowego lub błąd Zwracany podczas próby usunięcia wszystkich lokalizacji z kampanii Performance Max na potrzeby usług lokalnych.
SmartCampaignErrorEnum.CREATION_FAILED Nowa wartość typu wyliczeniowego lub 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 SMS-a 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 dotyczących kampanii Performance Max, które porównują w ramach jednego eksperymentu kilka kampanii tego samego 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 wersji 25, interfejs do modyfikowania pól atestu reklamodawcy jest wprowadzany wcześniej w 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ą w nich niezmienne.

Jeśli spróbujesz wysłać żądanie modyfikacji w przypadku jednego z tych pól, zostanie zwrócony 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ędzie można w pełni modyfikować. 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.
Autoryzacja przez wiele osób Nowe funkcje Dodano obsługę sprawdzania autoryzacji przez wiele osób (MPA):
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, zwraca teraz 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 mówią o danym temacie w kraju określonym w parametrze country_locations (obsługuje wyszukiwanie tylko w jednym kraju).
CREATOR_TOPIC_INSIGHTS Nowa wartość typu wyliczeniowego Dodano do InsightsKnowledgeGraphEntityCapabilities, aby oznaczyć podmioty do wyszukiwania twórców, którzy mówią o danym temacie. Te elementy powinny być używane w polu search_topics. Pobrane 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 do 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 pole supplemental_data zawiera wyliczenie LOCAL_CREATOR_DATA. Wyświetla lokalnych twórców, których filmy 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 informacji na podstawie lokalizacji kraju i podlokalizacji.
Raporty
PerformanceMaxPlacementView Rozszerzenie segmentów Umożliwiono segmentowanie przez ad_network_type.
Zakupy
Campaign.ShoppingSetting.ignore_brand_exclusion_in_shopping_ads Nowe pole Jeśli wartość to „true”, wykluczenia marek są ignorowane w reklamach produktowych. Obsługiwane tylko w przypadku kampanii produktowych.
Kierowanie
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE Nowa wartość typu wyliczeniowego lub błąd Zwracany, gdy próbujesz kierować reklamy na język, który nie jest dozwolony.
Filmy
DataLink.youtube_link_metadata Nowe pole Zawiera brand_channel_id, aby określić identyfikator połączonego kanału marki w YouTube.

wersja 24.1 (13.05.2026)

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

Funkcje i aktualizacje Typ Opis
Reklamy
DemandGenMultiAssetAdInfo.classic_display_images Nowe pole Niestandardowe przesłane obrazy displayowe 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 dotyczących 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 PMAX_REPLACEMENT_SHOPPING eksperymentach.
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 lub błąd Zwracany, gdy żądany stopień szczegółowości czasu (dzienny, godzinowy lub tygodniowy) 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 wertykalnych.
user_rating, venue, event_participant_display_name Nowe kryteria filtra Obsługiwane filtrowanie w VerticalAdsItemGroupRuleInfo w przypadku zasobu SharedCriterion.
Wskaźniki eksperymentu w grupie kontrolnej i eksperymentalnej Nowe pola Dodaliśmy wartości kontrolne (control_clicks itp.), wartości eksperymentalne (clicks itp.), szacunki punktowe (clicks_point_estimate itp.), marginesy błędu (clicks_margin_of_error itp.) i wartości p (clicks_p_value itp.) w 7 głównych grupach danych (Kliknięcia, Wyświetlenia, Koszt, Konwersje, Koszt konwersji, Wartość konwersji, Wartość konwersji na koszt).
Dane bezwzględnej zmiany 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 lub błąd Zwracany podczas próby wykluczenia wszystkich typów kierowania na dane demograficzne.
Filmy
ThirdPartyViewabilityIntegrationPartnerEnum.ZEFR Nowa wartość typu wyliczeniowego Opublikowaliśmy ZEFR jako partnera integracyjnego w zakresie pomiaru widoczności.
DataLink.youtube_video.channel_id Nowe pole Udostępnia identyfikator kanału w 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 wartości videos i logo_images.
Opcjonalne videos, business_name i logo_images w VideoResponsiveAdInfo Pola wymagane Zmiana zachowania Podaj 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 Usunięto ustawienie odpowiedniości na poziomie kampanii. Dopasowanie do 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 rejestrujących się 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 bibliotek klienta z określonym typem muszą zostać zaktualizowane, aby korzystać z nowych przestrzeni nazw zasobów.
Pole youtube_select_lineups w ReachPlanService.ListPlannableProducts Brak Usunięcie Przełącz na korzystanie z składó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: 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 przypadku ShareablePreviewService.GenerateShareablePreviews Brak częściowych niepowodzeń Zmiana zachowania Jeśli w żądaniu nie uda się zweryfikować żadnego identyfikatora, żądanie zakończy się niepowodzeniem i zostanie zgłoszony błąd.
ShareablePreviewError starsze kody: 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ę wyłapywania weryfikacji.

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

Funkcje i aktualizacje Typ Opis
Reklamy
Zmienność VideoResponsiveAdInfo zmiana zachowania, Obiekty informacji o elastycznych reklamach wideo można teraz zmieniać.
Zasoby
travel_feed_data w: AssetSet Nowe pole Dodano możliwość pobierania atrybutów zasobó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 pod kątem 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 ze względu na płeć w kampaniach Performance Max we wszystkich wersjach interfejsu Google Ads API.
Konwersje
Typy konwersji związanych z generowaniem potencjalnych klientów Nowe wartości typu wyliczeniowego Dodano nowe wyliczenia typu działania powodującego konwersję 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 lub błąd Zwracany podczas próby utworzenia wielu identycznych list podobnych odbiorców.
Planowanie
ProductCoreAttributes pól w tym kraju: ListPlannableProductsResponse Nowe pola Dodano opis produktu, cel marketingowy, model kosztów i metodę zakupu, które można zaplanować, do sekcji ProductCoreAttributes w obszarze ListPlannableProductsResponse.
Raporty
CartDataSalesView Nowy zasób raportowania Udostępnia raporty dzielące dane o konwersjach na segmenty według konkretnego sprzedanego produktu (marki itp.) oprócz klikniętego produktu.
Dane nieużywane do określania stawek Nowe pola Dodaliśmy nieużywane do określania stawek dane (dane pokazujące konwersje, pod kątem których kampanie nie są optymalizowane) do wszystkich pasujących zasobów:
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 Wprowadziliśmy dynamiczne filtrowanie za pomocą wyrażeń logicznych: Ta funkcja jest dostępna tylko na kontach znajdujących się na liście dozwolonych.

Wersje główne i podrzędne v23

Interfejs Google Ads API w wersji 23 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 treści generowanych przez AI, podzielone na advertiser_attestation (deklaracje przekazane bezpośrednio przez reklamodawcę) i system_attestation (atesty wykryte automatycznie lub przekazane przez systemy Google);

Aby ułatwić Ci planowanie przyszłych prac związanych z integracją w wersji 25, interfejs do modyfikowania pól atestu reklamodawcy jest wprowadzany wcześniej w 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ą w nich niezmienne.

Jeśli spróbujesz wysłać żądanie modyfikacji w przypadku jednego z tych pól, zostanie zwrócony 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ędzie można w pełni modyfikować. 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 Dodano obsługę opinii dotyczących zatwierdzania przez wiele osób (MPA):

wersja 23.2 (25.03.2026)

W wersji 23.2 interfejsu Google Ads API 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 reklamie wideo dotyczące ulepszeń, np. czy została wygenerowana przez Google czy dostarczona przez reklamodawcę. Więcej informacji znajdziesz w sekcji 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 wartości CustomerAsset, gdy parametr field_type ma wartość BUSINESS_LOGO.
Kampanie
AdGroupAd.start_date_time
AdGroupAd.end_date_time		 Nowe pola zapewniać bardziej szczegółowe ograniczenia harmonogramu w zakresie dat kampanii; Jest to obsługiwane 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 Dodano 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 listy użytkowników jest teraz zgłaszany 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óre zastąpi youtube_select_lineups. Oba pola są obecnie wypełnione.
ReachPlanSurface Nowa wartość typu wyliczeniowego Dodano IN_STREAM_NON_SKIPPABLE_THIRTY_SECONDS jako opcję platformy.
Forecast Nowe pole Dodano clicks w przypadku kampanii generujących popyt z ustalaniem stawek pod kątem maksymalizacji liczby kliknięć (CPC) w 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 YouTube na żywo przez ustawienie wartości 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 pomocnicze, 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, aby programowo kontrolować komponenty tekstowe generowane przez AI. W sekcji text_guidelines możesz zdefiniować term_exclusions i messaging_restrictions.
CampaignPrimaryStatusReason Nowe wartości typu wyliczeniowego Dodano wartości CAMPAIGN_NOT_BOOKED, BOOKING_HOLD_EXPIRING, BOOKING_HOLD_EXPIRED i BOOKING_CANCELLED, aby podawać główne przyczyny stanu 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 podczas próby kierowania reklam tylko na kategorię „Nieokreślone” w wymiarach demograficznych.
Zachęty
IncentiveErrorEnum Nowe wartości typu wyliczeniowego lub błędy Dodano 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łów dat za pomocą znaku BreakdownDefinition.
ReachPlanService.GenerateReachForecast Nowa wartość typu wyliczeniowego Dodaliśmy GOOGLE_DISPLAY_NETWORK jako platformę, na której można wyświetlać reklamy w kampaniach generujących popyt z ustawieniem Maksymalizacja liczby konwersji.
GenerateTrendingInsights Nowe pola Dodaliśmy informacje o historycznej linii trendu 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 informują, ilu użytkowników zobaczył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 Dodaliśmy 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 interfejsu REST API i biblioteki klienta Python.

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 dozwolone AdGroupAdError.AD_SHARING_NOT_ALLOWED Zmiana zachowania Udostępnianie reklam w wielu grupach reklam nie jest już dozwolone. Żądania udostępnienia reklam będą zwracać błąd AD_SHARING_NOT_ALLOWED.
Obsługa CallAd i CallAdInfo Brak Usunięcie Obsługa reklam generujących połączenia została usunięta. Przeczytaj artykuł w Centrum pomocy Informacje o reklamach generujących połączenia.
Kampanie
Campaign.start_date
Campaign.end_date		 Campaign.start_date_time
Campaign.end_date_time		 Zmiana nazwy lub zastąpienie Użyj nowych pól daty i godziny, aby określić komponenty czasowe 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 etykiety skuteczności komponentu i wyliczenie Brak Usunięcie Usunięto dane dotyczące zbiorczych etykiet skuteczności komponentów. W przypadku sieci wyszukiwania i sieci reklamowej wyliczenie etykiety skuteczności nie jest już zwracane.

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

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świetleń Nowe pola Dodaliśmy te dane: metrics.engagements, metrics.engagement_rate i metrics.average_cpe.
asset_group_asset wyświetleń Nowe pola Dodano 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 Dodaliśmy do komponentów z obrazem i wideo 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 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 i obsługa Zaktualizowane komponenty do wysyłania wiadomości do firmy:
Płatności
InvoiceService.ListInvoices Nowe opcje Możesz teraz uzyskać bardziej szczegółowe informacje w Invoice, w tym zestawienie kosztów na poziomie kampanii, wyszczególnione koszty regulacyjne i informacje o korekcie, ustawiając include_granular_level_invoice_details w ListInvoicesRequest.
RegulatoryFeeType
UnitOfMeasure		 Nowe wyliczenia Dodano pomocnicze typy wyliczeniowe dla opłat administracyjnych i jednostek miary.
Kampanie
CampaignError Nowe wartości typu wyliczeniowego lub 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 Dodano YOUTUBE_FOLLOW_ON_VIEWS, aby obsługiwać śledzenie użytkowników, którzy oglądają reklamę, a następnie 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 kampanii generujących popyt.
Zachęty
Dodano obsługę zachęt „Wybierz własną” (CYO):

Aby umożliwić bardziej szczegółową obsługę błędów w ramach automatyzacji, w przyszłych wersjach dodamy do IncentivesService kolejne kody błędów. Zalecamy śledzenie nadchodzących ogłoszeń i informacji o wersji, aby być na bieżąco z nowymi kodami błędów i mieć pewność, że Twoje aplikacje będą w stanie obsługiwać te nowe tryby awarii.
Planowanie
AudienceInsightsDimension.LIFE_EVENT_USER_INTEREST Nowa wartość typu wyliczeniowego Umożliwia tworzenie list odbiorców na podstawie zdarzeń z życia w strumieniach GenerateAudienceCompositionInsights, GenerateSuggestedTargetingInsights, GenerateInsightsFinderReport i GenerateCreatorInsights.

Kierowanie na zdarzenia z życia nie jest obsługiwane w przypadku innych metod AudienceInsightsService, takich jak AudienceInsightsService.GenerateAudienceOverlap i AudienceInsightsService.GenerateTargetingSuggestionMetrics.
ReachPlanService.GenerateConversionRates Nowe pola i opcje Odpowiedź zawiera teraz platformy, które obsługują sugestie dotyczące współczynnika konwersji na podstawie ustawień platformy (np. Gmail, Shorts). Obsługiwane tylko w kampaniach generujących popyt.
LanguageDistribution Nowe pole / typ Dodano do YouTubeChannelInsights, aby podawać szczegóły dotyczące dystrybucji językowej w treściach na kanale w YouTube.
BenchmarksService Nowa usługa Porównuje dane reklam w YouTube z analizami porównawczymi w branży.
AudienceInsightsService.GenerateAudienceDefinition Nowa metoda Tłumaczy opis docelowych odbiorców w formie tekstu swobodnego na pasujące atrybuty odbiorców za pomocą generatywnej AI.
YouTubeChannelInsights.relevance_score Nowe pole Ocenia, na ile dany twórca jest odpowiedni w przypadku danego tematu, z uwzględnieniem liczby wyświetleń.
TrendInsightMetrics.trend_change_percent Nowe pole Oznacza procentową zmianę wartości trendu w okresie porównawczym.
Rekomendacje
GenerateRecommendationsRequest Nowe pole Dodano: is_new_customer. Gdy ta opcja jest ustawiona na true w przypadku CAMPAIGN_BUDGET rekomendacji, używa modelu zoptymalizowanego pod kątem nowych klientów (zalecane tylko w przypadku 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 Umożliwia szczegółowe analizowanie 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). Musi być wybrany razem z atrybutem ad_network_type.
Raportowanie w kampaniach Performance Max Nowa funkcja Podział włączonych typów sieci reklamowych w kampaniach Performance Max.
UserLocationView
GeographicView		 Obsługa nowych segmentów Dane pomocnicze 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 Dodano PerStoreView do wysyłania zapytań o szczegóły lokalizacji sklepu i MatchedLocationInterestView (w przypadku kampanii AI Max) do podawania danych o skuteczności według lokalizacji geograficznych, które interesują użytkowników.
Zakupy
ShoppingPerformanceView Obsługa nowych danych Obecnie obsługuje te dane podzielone na segmenty 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ę: 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ą się wyświetlać 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 reklam pionowych Nowa funkcja Możesz teraz połączyć plik danych o reklamach w branży z kampanią w sieci wyszukiwania korzystającą z AI Max, aby wyświetlać reklamy promujące obiekty i reklamy z linkiem do rezerwacji obok reklam tekstowych. Kontroluj formaty za pomocą symbolu vertical_ads_format_setting i definiuj reguły za pomocą symbolu vertical_ads_item_group_rule. Raportowanie segmentów według AdFormatType i wymiarów pliku danych reklam w branżach.
Filmy
AdVideoAssetInfo.ad_video_asset_feature_control Nowe pole Dodano opcje sterowania funkcjami komponentów reklam wideo.
CampaignCriterionError Nowa wartość typu wyliczeniowego lub 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ść.

Wersje główne i podrzędne v22

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

wersja 22.2 (24.06.2026)

W interfejsie Google Ads API w wersji 22.2 dodaliśmy te nowe funkcje i aktualizacje: Wersje pomocnicze, takie jak v22.2, 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 treści generowanych przez AI, podzielone na advertiser_attestation (deklaracje przekazane bezpośrednio przez reklamodawcę) i system_attestation (atesty wykryte automatycznie lub przekazane przez systemy Google).

Aby ułatwić Ci planowanie 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ą w nich niezmienne.

Jeśli spróbujesz wysłać żądanie modyfikacji w przypadku jednego z tych pól, zostanie zwrócony 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ędzie można w pełni modyfikować. 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 Dodano obsługę opinii dotyczących zatwierdzania przez wiele osób (MPA):

wersja 22.1 (25.02.2026)

W interfejsie Google Ads API w wersji 22.1 dodaliśmy tę nową funkcję: Wersje podrzędne, np. 22.1, nie zawierają zmian powodujących niezgodność.

Funkcje i aktualizacje Typ Opis
Zarządzanie kontem
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.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.

wersja 22 (15.10.2025)

W wersji 22 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
Kreowanie popytu
BudgetPerDayMinimumErrorDetails.minimum_bugdet_amount_micros minimum_budget_amount_micros Zmiana nazwy lub poprawa pisowni Zmień nazwy odwołań, aby używać poprawionej nazwy pola.
Ogólne
Brak limitu operacji w AddBatchJobOperations Limit 10 000 operacji na żądanie Zmiana zachowania Upewnij się,że pojedyncze żądanie AddBatchJobOperations nie zawiera więcej niż 10 tys. operacji.
Cichy limit rozmiaru strony do 1000 w ListBatchJobResultsRequest Zwraca błąd INVALID_PAGE_SIZE Zmiana zachowania Upewnij się,że wartość ListBatchJobResultsRequest.page_size jest ustawiona na 1000 lub mniej, ponieważ żądanie większego rozmiaru strony spowoduje teraz błąd.
Performance Max
Etykiety skuteczności komponentów Brak Usunięcie W przypadku kampanii Performance Max usunęliśmy obsługę etykiet skuteczności komponentów i powiązanego wyliczenia etykiet skuteczności. Odpowiednio zaktualizuj integracje.
Campaign.url_expansion_opt_out FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION w AssetAutomationSetting Usunięcie lub zastąpienie Używaj ustawienia automatyzacji komponentów tekstowych z rozwinięciem końcowego adresu URL. Pole rezygnacji z rozwijania adresów URL na poziomie kampanii zostało usunięte.
Planowanie
views trueview_views Usunięcie lub zastąpienie Zastąp odwołania do pola views nowym polem trueview_views w ReachPlanService.
Filmy
average_cpv
video_view_rate
video_views
video_view_rate_in_feed
video_view_rate_in_stream
video_view_rate_shorts		 trueview_average_cpv
video_trueview_view_rate
video_trueview_views
video_trueview_view_rate_in_feed
video_trueview_view_rate_in_stream
video_trueview_view_rate_shorts		 Zmiana nazwy Zaktualizuj ciągi zapytań i integracje, aby używać nowych nazw danych reprezentujących wyświetlenia reklam wideo TrueView.

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

Funkcje i aktualizacje Typ Opis
Zasoby
AssetFieldType.LANDING_PAGE_PREVIEW Nowa wartość typu wyliczeniowego Dodano jako nowy typ pola komponentu z obrazem.
AssetGenerationService Nowa usługa (beta) Umożliwia generowanie komponentów tekstowych i komponentów z obrazem za pomocą generatywnej AI:
  • GenerateText: generuje tekst na podstawie końcowego adresu URL, promptów, słów kluczowych itp.
  • GenerateImages: generuje obrazy na podstawie końcowego adresu URL, promptów lub zmiany kontekstu obrazów produktów.
  • Błędy są zwracane z kodami z zakresu AssetGenerationError.
Początkowo dostępna tylko dla ograniczonej liczby uczestników zamkniętych testów beta.
Kampanie
AppCampaignBiddingStrategyGoalType Nowe wartości typu wyliczeniowego Dodaliśmy nowe cele kampanii promujących instalacje aplikacji, które umożliwiają optymalizację bez określania wartości docelowej:
  • OPTIMIZE_IN_APP_CONVERSIONS_WITHOUT_TARGET_CPA: używaj ze standardową strategią Maksymalizacja liczby konwersji.
  • OPTIMIZE_TOTAL_VALUE_WITHOUT_TARGET_ROAS: używaj ze standardową strategią Maksymalizacja wartości konwersji.
BiddingStrategyType Nowa funkcja Dodano obsługę typu strategii ustalania stawek „Stały udział w odsłonach”.
Campaign.feed_types Nowe pole Wyświetla typy plików danych dołączonych do kampanii. W przypadku kampanii Performance Max może to być branża, np. MERCHANT_CENTER_FEED w przypadku handlu detalicznego.
Kierowanie na wspólne zestawy Nowa funkcja Umożliwiliśmy dołączanie udostępnionych zestawów wykluczających słów kluczowych do kampanii wielokanałowych (w przypadku kampanii promujących aplikacje) i kampanii lokalnych.
Kreowanie popytu
Określanie docelowych stawek CPC Nowa funkcja Dodano strategię ustalania stawek, która pozwala maksymalizować liczbę kliknięć przy docelowym CPC: ustaw docelowy CPC na poziomie kampanii za pomocą funkcji Campaign.target_cpc i zastąp go na poziomie grupy reklam za pomocą funkcji AdGroup.target_cpc_micros.
AssetAutomationType.GENERATE_DESIGN_VERSIONS_FOR_IMAGES Nowa wartość typu wyliczeniowego Jeśli ta funkcja jest włączona w przypadku DemandGenMultiAssetAdInfo, dodaje ona elementy projektu i osadza komponenty tekstowe w komponentach z obrazem, aby tworzyć nowe komponenty z obrazem o różnych formatach obrazu (domyślnie włączona).
AssetAutomationType.GENERATE_VIDEOS_FROM_OTHER_ASSETS Nowa wartość typu wyliczeniowego Jeśli jest włączona w przypadku DemandGenMultiAssetAdInfo, generuje filmy przy użyciu innych komponentów, takich jak obrazy i tekst, które można następnie wykorzystać do tworzenia nowych instancji DemandGenVideoResponsiveAdInfo (domyślnie włączonych).
Ogólne
ListBatchJobResultsRequest rozmiar strony zmiana zachowania, Jeśli parametr page_size nie jest ustawiony lub ma wartość 0, domyślnie przyjmuje wartość maksymalną 1000 (wcześniej zwracał wartość INVALID_PAGE_SIZE).
QuotaError Nowa wartość typu wyliczeniowego lub błąd Dodano PAYMENTS_PROFILE_ACTIVATION_RATE_LIMIT_EXCEEDED, aby wskazać, kiedy limit szybkości aktywacji profilu płatności zostanie przekroczony.
Performance Max
Ustawienia automatyzacji komponentów Nowe wartości typu wyliczeniowego Dodaliśmy nowe opcje automatyzacji komponentów w kampanii Performance Max:
  • GENERATE_IMAGE_ENHANCEMENT: włącza automatyczne tworzenie ulepszonych obrazów (automatyczne przycinanie). Ta opcja jest domyślnie włączona.
  • GENERATE_IMAGE_EXTRACTION: Obrazy pochodzą z końcowych adresów URL. Domyślnie stosowane jest ustawienie dynamicznego rozszerzenia graficznego na koncie.
Segmenty raportowania w kampaniach Performance Max Nowe segmenty Dodaliśmy nowe segmenty dostępne tylko w kampaniach Performance Max:
Planowanie
Listy danych partnerów CRM Nowa funkcja lub wartość typu wyliczeniowego Dodano THIRD_PARTY_PARTNER_DATA do źródeł danych CRM wraz z kodami błędów weryfikacji odbiorców partnera (np. akceptacja warunków korzystania z usługi, brak linku itp.).
Dane twórcy transmisji na żywo Nowe pole Dodano parametr YouTubeMetrics.is_active_live_stream_creator, który jest zwracany przez statystyki twórcy, aby wskazać, czy twórca opublikował transmisję na żywo w ciągu ostatnich 90 dni.
Metadane źródłowe systemu CRM, które można zaplanować Nowa wiadomość Dodaliśmy PlannableUserListMetadata w PlannableUserList zwracanym przez ReachPlanService.ListPlannableUserLists, aby wyświetlać typy źródeł danych CRM.
Obsługa powiązanych filmów i twórców w TrendInsight Nowe pola Dodaliśmy obsługę właściwości related_videos i related_creators w TrendInsight oraz właściwości zegarka w video_properties i publish_date.
Ulepszenia narzędzia InsightsFinder Nowa funkcja GenerateInsightsFinderReport obsługuje teraz parental_status, income_ranges i bardziej złożone kombinacje kierowania za pomocą operatorów LUB/I.
Raporty
Nowe typy kliknięć Nowe wartości typu wyliczeniowego Dodano CLICK_TO_MESSAGE_THIRD_PARTY_CLICK i CLICK_TO_MESSAGE_LANDING_PAGE_CLICK.
Segmentacja komponentów w grupie plików Obsługa nowych segmentów Dane AssetGroupAsset można teraz segmentować według device, conversion_action, conversion_action_name i conversion_action_category.
Elastyczne reklamy w wyszukiwarce w widoku AdGroupAdAssetView Obsługa nowych funkcji i danych AdGroupAdAssetView w pełni obsługuje teraz dane o skuteczności i konwersjach w przypadku RESPONSIVE_SEARCH_AD (wcześniej zwracane były tylko wyświetlenia).
Segmentacja danych klastrów zapytań eksploracyjnych Obsługa nowych segmentów Dane clicks_unique_query_clusters, conversions_unique_query_clusters i impressions_unique_query_clusters można teraz segmentować według pól daty.
TargetingExpansionView Nowy zasób raportowania Dodaliśmy TargetingExpansionView do danych raportu dotyczących poszerzeń zakresu kierowania ręcznego, np. poszerzenia zakresu dopasowania bez słów kluczowych w przypadku funkcji AI Max w kampaniach w sieci wyszukiwania.
Zakupy
Poprawka zakresu Zakupów Google Poprawka Poprawiliśmy zakres kampanii i grup reklam w przypadku danych w zasobie ShoppingProduct.
Cele ujednolicone
Cele dotyczące utrzymania klientów Nowa funkcja Dodaliśmy obsługę celów związanych z utrzymaniem klientów, aby optymalizować kampanie pod kątem ponownego zaangażowania obecnych klientów (np. za pomocą target_option z TARGET_SPECIFIC lub TARGET_ALL).
Filmy
Dane o czasie oglądania filmu Nowe pola Dodane dane dotyczące czasu oglądania: video_watch_time_duration_millis (łączny czas) i average_video_watch_time_duration_millis (średni czas na wyświetlenie).

Zarchiwizowane informacje o wersji

Informacje o wersjach, które zostały wycofane, znajdziesz w sekcji Wycofane wersje.