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:
|
| 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 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.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 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:
|
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:
|
| 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 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 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_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 w partnership_opportunities. |
geo_modifiers i biddable_keywords w usłudze 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 generujących potencjalnych klientów | Nowe wartości typu wyliczeniowego | Dodano nowe wyliczenia typu działania powodującego konwersję w GA4/Firebase w ConversionActionType:
|
| 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:
|
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 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_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 określaniem 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 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_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 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_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 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_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ż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_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 | 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 |
||
| 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 |
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_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 | 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_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 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 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_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:
|
| 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:
|
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:
|
| 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 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 dotyczących klastrów zapytań w eksploracji | 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 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_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). |
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 UNKNOWN w ad_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_partners i Campaign.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 MaximizeConversionValue i TargetRoas. |
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_INTEREST i IN_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, ChannelAggregateAssetView i CampaignAggregateAssetView. Kampanie Performance Max raportują teraz też rzeczywiste wartości impressions. |
| Rozszerzenia selektora | Nowa funkcja | Umożliwia wspólne wykonywanie zapytań dotyczących AssetSet i CampaignAssetSet w ChangeStatus. |
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_adjustment i all_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_clusters i impressions_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:
|
| 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 YouTubeChannelInsights i YouTubeVideoAttributeMetadata. |
| Typy kliknięć interaktywnych | Nowe wartości typu wyliczeniowego | Dodane typy kliknięć: VIDEO_RELATED_VIDEOS_CLICK, VIDEO_CHANNEL_CLICK i PRODUCT_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_sequence i VideoAdSequenceStepSetting. 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 CampaignCriterion i AdGroupCriterion. 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.