Ogłoszone wycofania

Na tej stronie znajdziesz daty wycofania i zakończenia obsługi wersji interfejsu API oraz poszczególnych funkcji w interfejsie Display & Video 360 API.

Informacje o wycofywaniu i datach wyłączenia interfejsu API będą też ogłaszane na blogu dla programistów Google Ads.

Wycofane wersje

Wersje interfejsu Display & Video 360 API są regularnie publikowane, wycofywane i wyłączane. Te kroki są zdefiniowane w następujący sposób:

• Wersja: wersja nie jest już wersją alfa ani beta i jest uważana za stabilną. W przypadku tej wersji mogą być nadal udostępniane dodatkowe funkcje.
• Wycofanie: wersja jest wycofywana i ogłaszana jest data zakończenia wsparcia (wyłączenia). Użytkownicy muszą przejść na nowszą wersję przed datą wycofania. W przypadku tej wersji nie będą już udostępniane nowe funkcje.
• Wyłączona: wersja nie jest już obsługiwana. Żądania wysyłane do tej wersji zwracają błąd.

Ta tabela zawiera listę wszystkich istniejących podstawowych wersji interfejsu Display & Video 360 API, daty ich wydania oraz daty ich wycofania i wyłączenia, jeśli zostały ogłoszone.

Wersja interfejsu API	Data wydania	Data wycofania	Data wycofania	Przewodnik po migracji
v4	27 marca 2025 r.
v3	31 października 2023 r.	2 kwietnia 2025 roku	7 października 2025 r.	Migracja z wersji 3 na wersję 4
v2	6 grudnia 2022 r.	15 lutego 2024 r.	3 września 2024 r.	Migracja z wersji 2 na wersję 3
v1	9 marca 2020 r.	13 marca 2023 r.	14 września 2023 r.	Migracja z wersji 1 do wersji 2

Wycofane funkcje

Obserwuj nasz blog dla programistów Google Ads, aby dowiadywać się o planowanym wycofywaniu ważnych funkcji.

W tej tabeli znajdziesz listę wszystkich ogłoszonych wycofań funkcji, które mają wpływ na wersje opublikowane, wraz z początkową datą wejścia w życie i opisem wycofania, zalecanymi działaniami i linkami do odpowiedniej dokumentacji:

Funkcja	Data wejścia w życie	Opis
Wartości nazwy i logo firmy wymagane w przypadku elastycznych reklam w YouTube Zaktualizowano datę wejścia w życie	Styczeń 2027 r.	W styczniu 2027 r. komponenty z nazwą i logo firmy będą wymagane w reklamach elastycznych na YouTube, jeśli reklamodawca nie ma ustawionej wartości domyślnej. W efekcie w plikach SDF Reklama trzeba będzie ustawić kolumny Business Name i Logo Asset IDs w przypadku reklam typu „Elastyczna”, jeśli do reklamodawcy nadrzędnego nie są przypisane wartości domyślne. Jeśli przypisana jest wartość domyślna, a kolumna pozostanie pusta, po zapisaniu reklama odziedziczy wartości domyślne na poziomie reklamodawcy.
Wycofanie wykluczenia kategorii o charakterze kontrowersyjnym	1 października 2026 r.	Od 1 października 2026 r. nie będzie już można wykluczać większości kategorii reklam o charakterze kontrowersyjnym podczas przypisywania kierowania elementów zamówienia. W związku z tym w interfejsie Display & Video 360 API i plikach uporządkowanych danych zostaną wprowadzone te zmiany: Te wartości typu wyliczeniowego SensitiveCategory zostaną wycofane i nie będą już akceptowane w polu excludedSensitiveCategory obiektu SensitiveCategoryAssignedTargetingOptionDetails podczas przypisywania kierowania typu TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION: SENSITIVE_CATEGORY_ADULT SENSITIVE_CATEGORY_ALCOHOL SENSITIVE_CATEGORY_DEROGATORY SENSITIVE_CATEGORY_DOWNLOADS_SHARING SENSITIVE_CATEGORY_DRUGS SENSITIVE_CATEGORY_GAMBLING SENSITIVE_CATEGORY_POLITICS SENSITIVE_CATEGORY_PROFANITY SENSITIVE_CATEGORY_RELIGION SENSITIVE_CATEGORY_SENSITIVE_SOCIAL_ISSUES SENSITIVE_CATEGORY_SHOCKING SENSITIVE_CATEGORY_SUGGESTIVE SENSITIVE_CATEGORY_TOBACCO SENSITIVE_CATEGORY_TRAGEDY SENSITIVE_CATEGORY_TRANSPORTATION_ACCIDENTS SENSITIVE_CATEGORY_VIOLENCE SENSITIVE_CATEGORY_WEAPONS W kolumnie Brand Safety Sensitivity Setting w plikach SDF elementu zamówienia nie będzie już można wybrać opcji „Użyj niestandardowych”. Kolumna Brand Safety Custom Settings w plikach SDF Element zamówienia nie będzie już obsługiwana i podczas pobierania będzie wypełniana pustą wartością.
Wycofanie wykluczenia etykiet treści cyfrowych	1 października 2026 r.	Od 1 października 2026 r. nie będzie już można wykluczać określonych etykiet treści cyfrowych za pomocą kierowania. W związku z tym w interfejsie Display & Video 360 API i plikach uporządkowanych danych zostaną wprowadzone te zmiany: Te wartości typu wyliczeniowego ContentRatingTier zostaną wycofane i nie będą już akceptowane w polu excludedContentRatingTier obiektu DigitalContentLabelAssignedTargetingOptionDetails podczas przypisywania kierowania typu TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION: CONTENT_RATING_TIER_FAMILIES CONTENT_RATING_TIER_GENERAL CONTENT_RATING_TIER_MATURE CONTENT_RATING_TIER_PARENTAL_GUIDANCE CONTENT_RATING_TIER_TEENS CONTENT_RATING_TIER_UNSPECIFIED W kolumnie Digital Content Labels - Exclude w plikach SDF elementu zamówienia można przypisać tylko opcję „?”. W przeciwnym razie kolumna musi być pusta. Próba przypisania innej wartości spowoduje błąd podczas przesyłania.
Nielsen jako zewnętrzny dostawca usług pomiaru wyników marki	13 lipca 2026 r.	Od 13 lipca 2026 r. nie będzie już można przypisywać firmy Nielsen jako zewnętrznego dostawcy do pomiaru wyników marki. W związku z tym w interfejsie Display & Video 360 API i plikach uporządkowanych danych zostaną wprowadzone te zmiany: Wartość wyliczeniowa THIRD_PARTY_VENDOR_NIELSEN ThirdPartyVendor nie będzie już akceptowana w zasobie LineItem w polu obiektu ThirdPartyMeasurementConfigs brandLiftVendorConfigs.vendor. W plikach SDF Element zamówienia kolumna TrueView Third-Party Brand Lift Vendor nie będzie już obsługiwać opcji „Nielsen”. Dotychczasowe korzystanie z usług firmy Nielsen jako dostawcy pomiarów Wyników marki zostanie usunięte. Aby uniknąć przerw w działaniu usługi, usuń z integracji wszelkie przypisania Nielsena jako dostawcy usług związanych z Wynikami marki.
Dziedziczenie domyślnej nazwy i logo firmy	13 lipca 2026 r.	Od 13 lipca 2026 r. reklamy elastyczne na YouTube zaczną obsługiwać komponenty z nazwą i logo firmy, a wszystkie reklamy elastyczne w kampaniach generujących popyt i na YouTube, które nie mają ustawionych komponentów z nazwą i logo firmy, będą dziedziczyć wartości domyślne ustawione na poziomie reklamodawcy. Jednocześnie ta zmiana spowoduje następujące zmiany w zachowaniu interfejsu Display & Video 360 API i plików uporządkowanych danych: Pola businessName, logo i logoImages w zasobach ad_details kampanii generujących popyt AdGroupAd nie będą już wymagane, jeśli do reklamodawcy nadrzędnego zostaną przypisane wartości domyślne. Jeśli nie podasz tych informacji, reklama odziedziczy ustawienia domyślne na poziomie reklamodawcy. Kolumny Business Name i Logo Asset IDs w plikach SDF Reklama będzie można ustawiać w przypadku reklam dowolnego z tych typów: „Elastyczna”, „Produktowa kampania generująca popyt”, „Wideo kampania generująca popyt”, „Graficzna kampania generująca popyt” i „Karuzelowa kampania generująca popyt”. Jeśli te kolumny nie są ustawione dla odpowiedniego wpisu reklamy, a reklamodawcy nadrzędnemu są przypisane wartości domyślne, reklama po zapisaniu odziedziczy wartości domyślne na poziomie reklamodawcy. Kolumny Business Name i Logo Asset IDs w plikach SDF Reklama nie są już wymagane w przypadku reklam generujących popyt, jeśli reklamodawca nadrzędny ma przypisane wartości domyślne. Jeśli wartości domyślne są ustawione na poziomie reklamodawcy, wszystkie reklamy tego reklamodawcy będą miały przypisaną nazwę i logo firmy. Jeśli nie chcesz ustawiać wartości komponentów z nazwą i logo firmy w przypadku elastycznych reklam w YouTube, nie ustawiaj wartości domyślnych dla reklamodawcy.
Zarządzanie kierowaniem zamówień reklamowych i kampanii w interfejsie Display & Video 360 API i plikach uporządkowanych danych	23 lutego 2026 r.	23 lutego 2026 r. wycofamy z Display & Video 360 kierowanie zamówień reklamowych i kampanii. W związku z tym wprowadzimy zmiany w interfejsie Display & Video 360 API i plikach uporządkowanych danych (SDF). W interfejsie Display & Video 360 API podzbiór metod zostanie wycofany i będzie zwracać błąd w przypadku wywołania. W plikach SDF kolumny kierowania w plikach Zamówienie reklamowe i Kampania nie będą już wypełniane podczas pobierania i będą musiały być puste podczas przesyłania. Zalecamy, aby użytkownicy przypisywali kierowanie bezpośrednio do elementów zamówienia podczas ich tworzenia. Jeśli wywołasz te metody interfejsu Display & Video 360 API, zwrócą one błąd 404: advertisers.campaigns.listAssignedTargetingOptions advertisers.campaigns.targetingTypes.assignedTargetingOptions.get advertisers.campaigns.targetingTypes.assignedTargetingOptions.list advertisers.insertionOrders.listAssignedTargetingOptions advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.create advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.delete advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.get advertisers.insertionOrders.targetingTypes.assignedTargetingOptions.list advertisers.lineItems.generateDefault Wpisy w pliku SDF kampanii, które mają przypisane wartości w tych kolumnach, nie zostaną przesłane: Demographic Targeting Gender Demographic Targeting Age Demographic Targeting Household Income Demographic Targeting Parental Status Geography Targeting - Include Geography Targeting - Exclude Language Targeting - Include Language Targeting - Exclude Digital Content Labels - Exclude Brand Safety Sensitivity Setting Brand Safety Custom Settings Third Party Verification Services Third Party Verification Labels Viewability Targeting Active View Position Targeting - Display On Screen Position Targeting - Video On Screen Position Targeting - Display Position In Content Position Targeting - Video Position In Content Inventory Source Targeting - Authorized Seller Options Inventory Source Targeting - Include Inventory Source Targeting - Exclude Inventory Source Targeting - Target New Exchanges Environment Targeting Wpisy w pliku SDF Zamówienie reklamowe, które mają przypisane wartości w tych kolumnach, nie zostaną przesłane: Geography Targeting - Include Geography Targeting - Exclude Proximity Targeting Proximity Location List Targeting Language Targeting - Include Language Targeting - Exclude Device Targeting - Include Device Targeting - Exclude Browser Targeting - Include Browser Targeting - Exclude Digital Content Labels - Exclude Brand Safety Sensitivity Setting Brand Safety Custom Settings Third Party Verification Services Third Party Verification Labels Channel Targeting - Include Channel Targeting - Exclude Site Targeting - Include Site Targeting - Exclude App Targeting - Include App Targeting - Exclude App Collection Targeting - Include App Collection Targeting - Exclude Category Targeting - Include Category Targeting - Exclude Content Genre Targeting - Include Content Genre Targeting - Exclude Keyword Targeting - Include Keyword Targeting - Exclude Keyword List Targeting - Exclude Audience Targeting - Include Audience Targeting - Exclude Affinity & In Market Targeting - Include Affinity & In Market Targeting - Exclude Custom List Targeting Inventory Source Targeting - Authorized Seller Options Inventory Source Targeting - Include Inventory Source Targeting - Exclude Inventory Source Targeting - Target New Exchanges Daypart Targeting Daypart Targeting Time Zone Environment Targeting Viewability Omid Targeting Enabled Viewability Targeting Active View Position Targeting - Display On Screen Position Targeting - Video On Screen Position Targeting - Display Position In Content Position Targeting - Video Position In Content Position Targeting - Audio Position In Content Video Player Size Targeting Content Duration Targeting Content Stream Type Targeting Audio Content Type Targeting Demographic Targeting Gender Demographic Targeting Age Demographic Targeting Household Income Demographic Targeting Parental Status Connection Speed Targeting Carrier Targeting - Include Carrier Targeting - Exclude
Deklarowanie, czy elementy zamówienia wyświetlają reklamy polityczne w UE	8 września 2025 r.	Od 8 września 2025 r. podczas tworzenia nowego elementu zamówienia za pomocą interfejsu Display & Video 360 API lub plików SDF trzeba będzie zadeklarować, czy będzie on wyświetlać reklamy polityczne w Unii Europejskiej. Deklaracje te można składać na następujące sposoby: Użycie pola containsEuPoliticalAds w zasobie LineItem interfejsu Display & Video 360 API. Możesz też złożyć tę deklarację, korzystając z nowych pól w żądaniach advertisers.lineItems.duplicate i advertisers.lineItems.generateDefault. Użyj kolumny Contains EU Political Ads w pliku SDF w wersji 9 typu Element zamówienia. Jeśli reklamodawca nadrzędny nie będzie zawierać żadnych elementów zamówienia, które wyświetlają reklamy polityczne w UE, możesz zadeklarować to na poziomie reklamodawcy, używając pola containsEuPoliticalAds w zasobie Advertiser interfejsu Display & Video 360 API. Jeśli to pole ma wartość DOES_NOT_CONTAIN_EU_POLITICAL_ADVERTISING, wszystkie nowe elementy zamówienia reklamodawcy będą miały przypisaną tę samą wartość, chyba że określono inaczej, a wszystkie istniejące elementy zamówienia reklamodawcy zostaną zaktualizowane, aby używać tej samej wartości, jeśli nie została ona jeszcze ustawiona. Deklarację elementu zamówienia można zaktualizować w dowolnym momencie po utworzeniu za pomocą interfejsu, interfejsu API lub pliku SDF. Jeśli nie możesz złożyć deklaracji na poziomie reklamodawcy lub zadeklarujesz, że reklamy polityczne w UE mogą być wyświetlane w ramach Twojego konta reklamodawcy, zaktualizuj integrację interfejsu Display & Video 360 API i plików SDF przed 8 września 2025 r., aby uniknąć przerw w działaniu usługi: Ustaw pole containsEuPoliticalAds w nowym zasobie LineItem podczas wysyłania żądania advertisers.lineItems.create. Ustaw pole containsEuPoliticalAds w treści żądania dowolnych żądań advertisers.lineItems.duplicate i advertisers.lineItems.generateDefault. Przejdź na pliki uporządkowanych danych w wersji 9 i podczas przesyłania ustaw kolumnę Contains EU Political Ads w przypadku nowych elementów zamówienia na wartość Yes lub No. Szczegółowe instrukcje znajdziesz w przewodniku po migracji do wersji 9. Zanim zaktualizujesz kierowanie geograficzne w przypadku dotychczasowego elementu zamówienia za pomocą interfejsu Display & Video 360 API lub pliku SDF, zaktualizuj element zamówienia, aby podać deklarację.
Ustawienia kategorii treści w przypadku elementów zamówienia typu YouTube i sieć partnerów wideo Google	12 czerwca 2025 r.	12 czerwca 2025 r. w ramach aktualizacji funkcji dopasowania do marki konfiguracje kategorii treści w poszczególnych elementach zamówienia typu YouTube i sieć partnerów wideo Google nie będą już modyfikowalne. Ustawienia kategorii treści będą kontrolowane wyłącznie na poziomie reklamodawcy. W związku z tym w interfejsie Display & Video 360 API i plikach uporządkowanych danych zostaną wprowadzone te zmiany: Pole contentCategory w obiektach YoutubeAndPartnersSettings zasobów LineItem YouTube i sieci partnerów wideo Google nie będzie już aktualizowane. Zostanie ona całkowicie usunięta w późniejszym terminie. Kolumna TrueView Content Filter w plikach SDF Element zamówienia nie będzie już dostępna do zapisu. Aby uniknąć przerw w działaniu usługi: Podczas sprawdzania elementów zamówienia typu YouTube i sieć partnerów wideo Google w interfejsie API pobieraj pole effectiveContentCategory zamiast pola contentCategory. Podczas aktualizowania wpisów elementów zamówienia w pliku SDF przestań modyfikować kolumnę TrueView Content Filter. Jeśli tworzysz nowe elementy zamówienia, pozostaw tę kolumnę pustą.
Aktualizacje budżetu elementu zamówienia z optymalizacją zamówienia reklamowego	12 czerwca 2025 r.	Od 12 czerwca 2025 r. nie będzie już można aktualizować ustawień budżetu w przypadku elementów zamówienia, których nadrzędne zamówienia reklamowe są skonfigurowane pod kątem optymalizacji za pomocą strategii automatycznego określania stawek. Aby uniknąć przerw w działaniu usługi: W interfejsie API: sprawdź, czy element nadrzędny elementu zamówienia InsertionOrder ma ustawioną wartość bidStrategy.maximizeSpendAutoBid lub bidStrategy.performanceGoalAutoBid. Jeśli tak, nie próbuj aktualizować pola budżetu LineItem za pomocą advertisers.lineItems.patch. W pliku SDF: sprawdź, czy wpis w pliku SDF dotyczący nadrzędnego zamówienia reklamowego elementu zamówienia ma w kolumnie Insertion Order Optimization wartość TRUE. Jeśli tak, nie próbuj aktualizować kolumn Budget Type ani Budget Amount we wpisie SDF elementu zamówienia.
Ograniczenia dotyczące witryn w plikach uporządkowanych danych	12 czerwca 2025 r.	12 czerwca 2025 r. usuniemy istniejące ograniczenie dotyczące kierowania na adresy URL we wpisach SDF, które uniemożliwiało uwzględnianie nowszych witryn. Zamiast tego pliki SDF będą dopasowywać zachowanie interfejsu API i interfejsu użytkownika oraz umożliwiać kierowanie na adresy URL, o ile są one prawidłowo sformatowane. Dotyczy to kolumn Site Targeting - Include i Site Targeting - Exclude w plikach Zamówienie reklamowe i Element zamówienia.
Kolumna „Mnożniki stawek” w plikach uporządkowanych danych elementu zamówienia	1 maja 2025 r.	Od 1 maja 2025 r. wpisy w plikach uporządkowanych danych elementu zamówienia, które próbują ustawić kolumnę „Mnożniki stawek”, nie będą mogły utworzyć ani zaktualizować zasobu podczas przesyłania pliku.
Wymaganie źródła zasobów reklamowych w sieci partnerów wideo w przypadku elementów zamówienia generujących popyt w plikach uporządkowanych danych	22 kwietnia 2025 r.	Od 22 kwietnia 2025 r. w kolumnie TrueView Inventory Source Targeting wpisów elementów zamówienia, które w kolumnie Type mają wartość „kampania generująca popyt”, trzeba będzie podawać wartość „sieć partnerów wideo”. Gdy zaczniemy egzekwować tę zasadę, wartość zostanie uzupełniona w przypadku dotychczasowych elementów zamówienia i będzie uwzględniana podczas pobierania nowych plików uporządkowanych danych. Aby uniknąć przerw w działaniu usługi: Zaktualizuj integrację, aby uwzględnić wartość „Sieć partnerów wideo” we wszystkich wpisach elementów zamówienia z kampanii generujących popyt. Zaktualizuj integrację, aby zarządzać źródłami zasobów reklamowych kampanii generujących popyt na poziomie grupy reklam za pomocą kolumn Demand Gen Inventory Source Strategy i Demand Gen Enabled Inventory Sources w pliku SDF w wersji 8.1 na poziomie grupy reklam.
Kampanie wideo zachęcające do działania w plikach uporządkowanych danych	22 kwietnia 2025 r.	Od 22 kwietnia 2025 r. nie będzie już można tworzyć elementów zamówienia w kampaniach wideo zachęcających do działania za pomocą plików uporządkowanych danych, ponieważ te kampanie są przekształcane w kampanie generujące popyt. Próby przesłania wpisów elementów zamówienia z wartością „Action” w kolumnie Subtype i wartością „TrueView” w kolumnie Type zakończą się niepowodzeniem. Aby uniknąć przerw w świadczeniu usług, zaktualizuj integrację, aby używać kampanii generujących popyt zamiast kampanii wideo zachęcających do działania.
Nieograniczony okres członkostwa w przypadku własnych list odbiorców.	7 kwietnia 2025 r.	7 kwietnia 2025 r. zasoby FirstAndThirdPartyAudience przestaną zezwalać na nieograniczony okres członkostwa odbiorców. Żądania firstAndThirdPartyAudiences.create i firstAndThirdPartyAudiences.patch, które ustawiają wartość pola membershipDurationDays na 10 000, zwrócą błąd 400. W przypadku dotychczasowych list odbiorców, które mają wartość pola membershipDurationDays równą 10 000, zostanie ona zmieniona na 540, a nowy okres członkostwa zostanie zastosowany wstecznie do dotychczasowych członkostw. Spowoduje to wygaśnięcie wszystkich członkostw starszych niż 540 dni. Aby uniknąć przerw w działaniu usługi: Sprawdź,czy integracja nie ustawia wartości pola membershipDurationDays nowych lub dotychczasowych list odbiorców na 10 000. Odśwież członkostwo obecnych odbiorców kierowania na listę klientów za pomocą firstAndThirdPartyAudiences.editCustomerMatchMembers. Regularnie odświeżaj członkostwo odbiorców kierowania na listę klientów, aby nie dopuścić do niezamierzonego zmniejszenia rozmiaru listy odbiorców. W wersji 4 ta zmiana jest odzwierciedlona w zasobach FirstPartyAndPartnerAudience.
Niezgodność algorytmu ustalania stawek niestandardowych i aktywności Floodlight	1 kwietnia 2025 r.	1 kwietnia 2025 r.: Żądania advertisers.lineItems.create, które próbują ustawić pole floodlightActivityConfigs obiektu ConversionCountingConfig i pole customBiddingAlgorithmId obiektów MaximizeSpendBidStrategy lub PerformanceGoalBidStrategy, które nie używają pasujących aktywności Floodlight, zwrócą błąd 400. advertisers.lineItems.patch Żądania próby zaktualizowania pola floodlightActivityConfigs obiektu ConversionCountingConfig, gdy ustawione jest pole customBiddingAlgorithmId obiektów MaximizeSpendBidStrategy lub PerformanceGoalBidStrategy, zwrócą błąd 400. Wpisy w plikach uporządkowanych danych elementu zamówienia, które próbują zaktualizować kolumnę „Identyfikatory aktywności Floodlight konwersji”, gdy kolumna „Identyfikator algorytmu” jest ustawiona, nie zostaną zaktualizowane podczas przesyłania pliku. Żądania customBiddingAlgorithms.patch, customBiddingAlgorithms.rules.create, customBiddingAlgorithms.scripts.create dotyczące zasobów CustomBiddingAlgorithm przypisanych do elementu zamówienia zwrócą błąd. Aby uniknąć przerw w świadczeniu usług, zaktualizuj integrację: Sprawdź, czy odpowiednie aktywności Floodlight są przypisane do elementu zamówienia przed przypisaniem algorytmu ustalania stawek niestandardowych lub w tym samym czasie. Przed próbą aktualizacji istniejące algorytmy ustalania stawek niestandardowych są odłączane od wszystkich elementów zamówienia.

Wycofanie poprzednich funkcji

Aby dowiedzieć się więcej o ogłoszonych wycofaniach, które mają wpływ na wycofywane wersje interfejsu Display & Video 360 API, zapoznaj się z wycofanymi funkcjami w archiwum.