Informacje o wersjach

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

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 dla grup 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_input (deklaracje dostarczone bezpośrednio przez reklamodawcę) i system_input (atesty wykryte automatycznie lub dostarczone przez system);

Ta funkcja została przeniesiona do wersji 23 i 22.

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.statussynthetic_content_info.advertiser_attestation.source pozostaną w nich niezmienione.

Jeśli spróbujesz wysłać żądanie zmiany 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ę weryfikacji zatwierdzania przez wiele osób (MPA):
Ta funkcja została przeniesiona do wersji v23.3, v22.2v21.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 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 supplemental_data zawiera wyliczenie LOCAL_CREATOR_DATA. Wyświetla lokalnych twórców, którzy są oglądani w wybranym kraju lub 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żliwia segmentowanie według 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 kampaniach produktowych.
Kierowanie
CriterionErrorEnum.CANNOT_TARGET_LANGUAGE Nowa wartość typu wyliczeniowego lub błąd Zwracany, gdy próbujesz kierować reklamy na niedozwolony język.
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 Wyświetlanie przesłanych przez Ciebie obrazów displayowych 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 żądana dzienna, godzinowa lub tygodniowa szczegółowość danych nie jest obsługiwana w przypadku zakresów dat zapytania (dostępna 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.
Dane 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 zewnętrznego partnera integracyjnego w zakresie 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 videoslogo_imagesDemandGenVideoResponsiveAdInfo Pola wymagane Zmiana zachowania Podczas tworzenia lub modyfikowania elastycznych reklam wideo generujących popyt podaj wartości videoslogo_images.
Opcjonalne videos, business_namelogo_imagesVideoResponsiveAdInfo Pola wymagane Zmiana zachowania Podaj videos, business_namelogo_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 marki w zakresie 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_lineupsReachPlanService.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.GenerateCreatorInsightsGenerateTrendingInsights Brak Usunięcie Zamiast tego sprawdź, czy twórca ma CREATOR_PARTNERSHIPS w partnership_opportunities.
geo_modifiersbiddable_keywords w usłudze KeywordPlanIdeaService.GenerateKeywordForecastMetrics geo_target_constantskeywords Zmiana nazwy lub usunięcie Zastąpione przez CampaignToForecast.geo_target_constants[]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_typecampaign_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, CampaignAssetCustomerAsset.
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 generujących potencjalnych klientów Nowe wartości typu wyliczeniowego Dodano nowe wyliczenia typu działania powodującego 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 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 segmentujące dane o konwersjach 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 Wprowadzono 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 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.statussynthetic_content_info.advertiser_attestation.source pozostaną w nich niezmienione.

Jeśli spróbujesz wysłać żądanie zmiany 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ę sprawdzania zatwierdzeń przez wiele osób:

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 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_REACHEDACCOUNT_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 określaniem stawek pod kątem maksymalizacji liczby kliknięć (CPC) w ReachPlanService.GenerateReachForecast.
partnership_opportunities Nowe pole Dodano do folderów ContentCreatorInsightsService.GenerateCreatorInsightsContentCreatorInsightsService.GenerateTrendingInsights.
Raporty
biddable_indirect_install_first_in_app_conversion_micros Nowe pole Dodano do zasobów Campaign, CustomerAdGroup.
Filmy
ShareablePreviewService Nowa funkcja Rozszerzono obsługę podglądów transmisji na żywo w YouTube 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_exclusionsmessaging_restrictions.
CampaignPrimaryStatusReason Nowe wartości typu wyliczeniowego Dodano wartości CAMPAIGN_NOT_BOOKED, BOOKING_HOLD_EXPIRING, BOOKING_HOLD_EXPIREDBOOKING_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_REDEEMEDACCOUNT_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 według daty za pomocą 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_plusunique_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 CallAdCallAdInfo 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 o etykietach skuteczności komponentów 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_LINKVERTICAL_ADS_PROMOTION.
Zasoby
asset_group wyświetleń Nowe pola Dodaliśmy te dane: metrics.engagements, metrics.engagement_ratemetrics.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_viewsmetrics.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 HEADLINEDESCRIPTION.
ServedAssetFieldType Nowe wartości typu wyliczeniowego Dodano HEADLINE_AS_SITELINK_POSITION_ONE, HEADLINE_AS_SITELINK_POSITION_TWO, DESCRIPTION_LINE_HEADLINE_AS_SITELINK_POSITION_ONEDESCRIPTION_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że teraz zwracać bardziej szczegółowe informacje w Invoice, w tym podział kosztów na poziomie kampanii, wyszczególnione koszty regulacyjne i informacje o dostosowaniu, przez ustawienie include_granular_level_invoice_detailsListInvoicesRequest.
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_BUDGETEND_DATE_TIME_REQUIRED_FOR_TOTAL_BUDGET.
Konwersje
ConversionActionCategory Nowa wartość typu wyliczeniowego Dodaliśmy 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, GenerateInsightsFinderReportGenerateCreatorInsights.

Kierowanie na zdarzenia z życia nie jest obsługiwane w przypadku innych metod AudienceInsightsService, takich jak AudienceInsightsService.GenerateAudienceOverlapAudienceInsightsService.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 branżowymi analizami porównawczymi.
AudienceInsightsService.GenerateAudienceDefinition Nowa metoda Tłumaczy opis tekstowy odbiorców docelowych 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 Przedstawia procentową zmianę wartości trendu w okresie porównawczym.
Rekomendacje
GenerateRecommendationsRequest Nowe pole Dodano: is_new_customer. Gdy w przypadku CAMPAIGN_BUDGET rekomendacji ustawisz wartość true, będzie używany model zoptymalizowany pod kątem nowych klientów (zalecany 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 Zawiera szczegółowe dane o skuteczności w ramach sieci reklamowej. Początkowo dostępny 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_datecross_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_accountvertical_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 Obsługuje teraz 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_datevalue_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_sharesearch_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 AdGroupCriterionvertical_ads_item_group_rule do SharedCriterion, aby umożliwić kierowanie na grupy produktów w kampaniach w sieci wyszukiwania z plikami danych o podróżach.
Integracja pliku danych reklam pionowych Nowa funkcja Możesz teraz połączyć plik danych o reklamach wertykalnych 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ą symbolu vertical_ads_format_setting i definiuj reguły za pomocą symbolu vertical_ads_item_group_rule. Raportowanie podziału na segmenty 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.statussynthetic_content_info.advertiser_attestation.source pozostaną w nich niezmienione.

Jeśli spróbujesz wysłać żądanie zmiany 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ę sprawdzania zatwierdzeń przez wiele osób:

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 z nimi wyliczenia etykiet skuteczności. Zaktualizuj odpowiednio 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_viewsReachPlanService.
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 zdjęć 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 współczynnikach proporcji (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łączone).
Ogólne
ListBatchJobResultsRequest rozmiar strony Zmiana zachowania Jeśli wartość page_size nie jest ustawiona lub wynosi 0, domyślnie jest to maksymalna wartość 1000 (wcześniej zwracano 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 kampaniach 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 jest to ustawienie dynamicznego rozszerzenia graficznego na koncie.
Segmenty raportowania kampanii 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 usługi, brak linku itp.).
Dane twórcy transmisji na żywo Nowe pole Dodano wartość YouTubeMetrics.is_active_live_stream_creator, która jest zwracana 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 PlannableUserListMetadataPlannableUserList 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_videosrelated_creatorsTrendInsight oraz właściwości zegarka w video_propertiespublish_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_CLICKCLICK_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_nameconversion_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 dotyczących klastrów zapytań w eksploracji Obsługa nowych segmentów Dane clicks_unique_query_clusters, conversions_unique_query_clustersimpressions_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 dopasowania w stosunku do kierowania ręcznego, np. poszerzenia zakresu dopasowania bez słów kluczowych w przypadku 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_optionTARGET_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).

Wersje główne i podrzędne v21

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

wersja 21.2 (24.06.2026)

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

Funkcje i aktualizacje Typ Opis
Ogólne
Zatwierdzenia przez wiele osób Nowe funkcje Dodano obsługę sprawdzania zatwierdzeń przez wiele osób:

wersja 21.1 (25.02.2026)

W wersji 21.1 interfejsu Google Ads API dodaliśmy te nowe funkcje i aktualizacje: Wersje pomocnicze, takie jak 21.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ść EuPoliticalAdvertisingStatusEnum.
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 21 (06.08.2025)

W wersji 21 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
Zwroty CriterionError.INVALID_LISTING_GROUP_HIERARCHY Zwroty CriterionError.LISTING_GROUP_ERROR_IN_ANOTHER_OPERATION Zmiana kodu błędu W przypadku żądań z włączonym częściowym błędem obsługuj nowy kod błędu zamiast oryginalnego kodu błędu hierarchii.
Konwersje
Dostęp do trybu debug_enabled w usłudze ConversionUploadService Brak Usunięcie Pole debug_enabled zostanie usunięte. Zaktualizuj kod, który się do niego odwołuje, aby nie ustawiał tego parametru ani nie wysyłał do niego zapytań.
Zmiany w reklamach politycznych w UE
Opcjonalne deklaracje dotyczące kampanii w przypadku reklam politycznych w UE Wymagane pole contains_eu_political_advertising w przypadku nowych kampanii Reguła weryfikacji / zmiana zachowania Wywołania interfejsu API w celu utworzenia nowych kampanii zakończą się niepowodzeniem i wyświetli się błąd FieldError.REQUIRED, jeśli to pole nie zostanie ustawione. Od 22 września 2025 r. kampanie oznaczone jako CONTAINS_EU_POLITICAL_ADVERTISING nie będą już wyświetlać reklam w UE.
Kryteria, które można modyfikować bez samodzielnej deklaracji Nie udało się zaktualizować instancji CriterionError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION Reguła weryfikacji / zmiana zachowania Przed próbą utworzenia lub zaktualizowania kryteriów kierowania na bliskość, lokalizację lub grupę lokalizacji na poziomie kampanii lub grupy reklam w przypadku istniejących kampanii ustaw stan deklaracji własnej.
Eksperymenty bez wymagań dotyczących samodzielnej deklaracji Nie udało się zaktualizować instancji ExperimentError.MISSING_EU_POLITICAL_ADVERTISING_SELF_DECLARATION Reguła weryfikacji / zmiana zachowania Upewnij się, że w kampaniach objętych eksperymentem zostały wypełnione deklaracje własne.
Performance Max
brand_guidelines_enabled ma domyślnie wartość false. Domyślna wartość to true Zmiana zachowania W przypadku nowych kampanii Performance Max wskazówki dotyczące marki są domyślnie włączone. Jeśli mają być wyłączone, ustaw w tym polu wartość false.
Planowanie
Pierwotny typ argumentu wejściowego dla funkcji AudienceInsightsService.GenerateTargetingSuggestionMetrics Dane wejściowe typu InsightsAudience Zmiana typu Zaktualizuj implementacje, aby przekazywać nowy typ danych wejściowych, który obsługuje kombinację zainteresowań użytkowników typu AND-of-ORs, co umożliwia uzyskiwanie potencjalnych danych o zasięgu w przypadku definicji odbiorców niestandardowych.

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

Funkcje i aktualizacje Typ Opis
AI Max w kampaniach w sieci wyszukiwania
ai_max_setting.enable_ai_max w: Campaign Nowe pole Umożliwia AI Max rozszerzenie dopasowywania wyszukiwanych słów (z uwzględnieniem poprzedniej automatyzacji komponentów tekstowych i list marek do momentu wyłączenia). Pole Campaign.ai_max_setting.bundling_required wskazuje, czy aby uwzględniać lub modyfikować te ustawienia, należy włączyć AI Max, a pole AdGroup.ai_max_ad_group_setting.disable_search_term_matching umożliwia wyłączenie dopasowywania na poziomie grupy reklam. Zobacz Osiągaj jeszcze lepsze wyniki dzięki AI Max w kampaniach w sieci wyszukiwania.
CampaignError.AI_MAX_MUST_BE_ENABLED Nowa wartość typu wyliczeniowego lub błąd Występuje, gdy w kampaniach w sieci wyszukiwania włączysz automatyzację komponentów tekstowych z rozwinięciem adresu URL bez włączania funkcji AI Max.
Kierowanie na poziomie grupy reklam Nowa funkcja W kampaniach AI Max w sieci wyszukiwania dodaliśmy obsługę list marek, lokalizacji i stron internetowych (reguł dotyczących adresów URL) na poziomie grupy reklam.
ai_max_search_term_ad_combination_view Nowy zasób raportowania Raportuje skuteczność kombinacji wyszukiwanych haseł, nagłówków i stron docelowych.
search_term_match_type segment Nowa wartość typu wyliczeniowego Dodaliśmy AI_MAX jako opcję typu dopasowania wyszukiwanego hasła.
Zasoby
PromotionAsset Nowe pola Dodano opcje terms_and_conditions_text, terms_and_conditions_uri i oneof promotion_trigger (promotion_barcode_info, promotion_qr_code_info). Więcej informacji znajdziesz w artykule Komponenty z promocją.
AssetAutomationType.FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION Nowa wartość typu wyliczeniowego Dodano do AssetAutomationType, aby kontrolować automatyczne generowanie tekstu i strony docelowej na podstawie końcowych adresów URL w kampaniach w sieci wyszukiwania.
AutomaticallyCreatedAssetRemovalService.RemoveCampaignAutomaticallyCreatedAsset Nowa usługa / metoda Umożliwia usuwanie z kampanii komponentów rozwinięcia końcowego adresu URL tworzonych automatycznie.
ServedAssetFieldType.DESCRIPTION_PREFIX Nowa wartość typu wyliczeniowego Dodano, aby rozwiązać problem z raportowaniem, w którym typ był zwracany jako UNKNOWNad_group_ad_asset_combination_view.
Kampanie
CampaignPrimaryStatusReason.MISSING_LOCATION_TARGETING Nowa wartość typu wyliczeniowego Zwracany, gdy kampanie z ograniczeniami dotyczącymi lokalizacji nie mają kierowania na lokalizację (co teraz powoduje błąd LOCATION_TARGETING_NOT_ELIGIBLE_FOR_RESTRICTED_CAMPAIGN, jeśli kierowanie jest ustawione poza dozwolonym obszarem).
Integracja z analityką aplikacji innych firm Nowe pola Dodaliśmy obsługę VideoCustomer.third_party_integration_partnersCampaign.third_party_integration_partners. Zobacz Śledzenie konwersji z aplikacji za pomocą analityki aplikacji innej firmy.
Campaign.advertising_partner_ids Obsługa nowych pól To pole można teraz ustawić w przypadku istniejących kampanii (po ustawieniu pozostaje niezmienne).
Wykluczające miejsca docelowe na poziomie konta menedżera Nowa funkcja Umożliwia wykluczanie list miejsc docelowych na poszczególnych kontach reklamodawców za pomocą symbolu CustomerNegativeCriterion.
Konfiguracje tolerancji w strategiach Docelowy ROAS Nowe pola Dodano obsługę TargetRoas.target_roas_tolerance_percent_millis (w przypadku strategii portfolio kampanii w sieci wyszukiwania) w MaximizeConversionValueTargetRoas.
LocationInterestView Nowy zasób raportowania Podsumowuje skuteczność kryteriów lokalizacji interesujących użytkowników w grupie reklam.
Konwersje
conversion_attribution_event_type segment Nowa wartość typu wyliczeniowego Dodano ENGAGED_VIEW do opcji typu atrybucji konwersji.
Kreowanie popytu
CampaignBudgetError.BUDGET_BELOW_DAILY_MINIMUM Nowa wartość typu wyliczeniowego lub błąd Dodano w ramach przygotowań do egzekwowania minimalnych budżetów dziennych w przypadku kampanii generujących popyt. Szczegóły są udostępniane za pomocą budgetDailyMinimumErrorDetails.
Performance Max
campaign_search_term_view Nowy zasób raportowania Zbiera dane o wyszukiwanych hasłach na poziomie kampanii, umożliwiając analizę wyszukiwanych haseł i raportowanie w przypadku kampanii Performance Max.
Planowanie
ReachPlanService.ListPlannableUserInterests Nowa metoda Umożliwia odkrywanie możliwych do zaplanowania podobnych zainteresowań i zainteresowań na rynku w przypadku generateReachForecast.
AdditionalApplicationInfo Nowe pole Dodano jako opcjonalne dane wejściowe w ReachPlanService.ListPlannableUserLists.
Lista atrybutów Audience Insights Nowa funkcja AudienceInsightsService.ListAudienceInsightsAttributes pobiera teraz dostępne listy użytkowników własnych.
Kierowanie na listy CRM w raportach AudienceCompositionInsights Nowa funkcja AudienceInsightsService.GenerateAudienceCompositionInsights zwraca teraz szczegóły indeksu listy użytkowników w przypadku wymiarów AudienceInsightsDimension: AGE_RANGE, GENDER, AFFINITY_USER_INTERESTIN_MARKET_USER_INTEREST.
TrendInsightMetrics udział odbiorców, Nowe pole Reprezentuje udział odbiorców w trendzie.
KnowledgeGraphAttributeMetadata kategorii, Nowe pola Filtruje atrybuty Grafu wiedzy według pasujących kategorii.
Raporty
Dane wyświetleń komponentów Nowe funkcje i dane Dodaliśmy kilka nowych rodzajów danych do usług AssetGroupAsset, ChannelAggregateAssetViewCampaignAggregateAssetView. Kampanie Performance Max raportują teraz też rzeczywiste wartości impressions.
Rozszerzenia selektora Nowa funkcja Umożliwia wspólne wykonywanie zapytań dotyczących AssetSetCampaignAssetSetChangeStatus.
search_term_targeting_status Nowy segment Segment, który można wybrać w widoku wyszukiwanych haseł kampanii.
final_url_expansion_asset_view Nowy zasób raportowania Raportuje szczegóły skuteczności komponentów z rozwinięciem końcowego adresu URL.
Dostosowania wartości AssetGroup Nowe pola Dodano obsługę danych value_adjustmentall_value_adjustment w raporcie AssetGroup.
landing_page_source Nowy segment Zawiera segment źródła strony docelowej w formacie landing_page_view.
search_term_match_source Nowy segment Segment, który można wybrać w widokach wyszukiwanych słów i wyszukiwanych słów w kampanii.
match_type Nowy segment W widoku słów kluczowych można wybrać klucz segmentu.
Raportowanie klastrów niepowtarzalnych wyszukiwań z zamiarami Nowe pola Dodaliśmy do raportu klastry unikalnych intencji zapytań clicks_unique_query_clusters, conversions_unique_query_clustersimpressions_unique_query_clusters.
ClickType.VEHICLE_ASSETS Nowa wartość typu wyliczeniowego Śledź i raportuj kliknięcia związane konkretnie z formatami reklam pojazdów w click_view.
Eksploracyjne inteligentne określanie stawek
konfiguracje tolerancji w strategiach wyszukiwania, Nowe pola i ustawienia Umożliwia włączenie eksploracji inteligentnego określania stawek w kampaniach w sieci wyszukiwania przez ustawienie wartości target_roas_tolerance_percent_millis w zakresie od 10 000 (10%) do 30 000 (30%) włącznie (strategia Maksymalizacja liczby konwersji wymaga ustawienia wartości target_roas). Przeczytaj nasz post na blogu o eksploracji inteligentnego określania stawek oraz artykuł w Centrum pomocy.
zgodność z raportowaniem różnorodności, Nowa funkcja W przypadku klastrów unikalnych intencji zapytań obsługiwane jest teraz zbiorcze raportowanie dotyczące różnorodności w odniesieniu do tych danych: W interfejsie Google Ads dostępny jest widok podzielony na segmenty czasowe:
  • clicks_unique_query_clusters
  • conversions_unique_query_clusters
  • impressions_unique_query_clusters
Filmy
YouTubeVideoListAsset Nowy zasób lub pole Umożliwia tworzenie połączeń między kampaniami a zasobami list wideo za pomocą Asset.youtube_video_list_asset. Zobacz Podobne filmy.
Rozszerzenia metadanych statystyk Nowe pola Dodaliśmy nowe metadane do YouTubeChannelInsightsYouTubeVideoAttributeMetadata.
Typy kliknięć interaktywnych Nowe wartości typu wyliczeniowego Dodane typy kliknięć: VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICKPRODUCT_ASSETS.
VideoAdInventoryControl.allow_non_skippable_in_stream Nowe pole Umożliwia wyświetlanie elastycznych reklam wideo jako reklam In-Stream niemożliwych do pominięcia w kampaniach, które łączą formaty możliwe i niemożliwe do pominięcia.
Ustawienia sekwencjonowania reklam wideo Nowe pola Dodano konfiguracje sekwencjonowania tylko do odczytu: Campaign.VideoCampaignSettings.video_ad_sequenceVideoAdSequenceStepSetting. Więcej informacji znajdziesz w artykule Sekwencjonowanie reklam wideo.
Kierowanie na lineup wideo Nowy typ kryterium lub pole Dodano typ kryterium VIDEO_LINEUP i odpowiednie pole w elementach CampaignCriterionAdGroupCriterion. Ta funkcja jest dostępna tylko na kontach znajdujących się na liście dozwolonych.
Wyświetlenia miejsc docelowych w ramach dopasowania treści Nowe zasoby do raportowania Dodaliśmy raport Dopasowanie treści na poziomie szczegółowym (detail_content_suitability_placement_view) i grupowym (group_content_suitability_placement_view). Więcej informacji znajdziesz w artykule Raport „Dopasowanie treści”.

Zarchiwizowane informacje o wersji

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