Ogłoszone wycofania

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

Daty wycofania interfejsu API i zakończenia jego obsługi będą ogłaszane na blogu Google Ads dla programistów.

Wycofanie wersji

Wersje interfejsu Display & Video 360 API są regularnie publikowane, wycofywane i zamykane. Te kroki są zdefiniowane w ten sposób:

  • Wersja: wersja przestaje być wersją alfa lub beta i jest uznawana za stabilną. W przypadku tej wersji mogą być nadal udostępniane dodatkowe funkcje.
  • Wycofanie: wersja jest wycofywana i ogłaszana jest data zakończenia obsługi. Użytkownicy muszą przejść na nowszą wersję przed datą wycofania. W przypadku tej wersji nie będą już udostępniane nowe funkcje.
  • Wycofana: ta wersja nie jest już obsługiwana. Żądania wysyłane do tej wersji będą zwracać błąd.

Ta tabela zawiera listę wszystkich obecnych wersji podstawowego interfejsu Display & Video 360 API, daty ich wprowadzenia oraz daty wycofania i zakończenia ich obsługi (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. Przejście z wersji 3 na wersję 4
v2 6 grudnia 2022 r. 15 lutego 2024 r. 3 września 2024 r. Przejście z wersji 2 na wersję 3
v1 9 marca 2020 r. 13 marca 2023 r. 14 września 2023 r. Przejście z wersji 1 na wersję 2

Wycofane funkcje

Na blogu dla programistów Google Ads będziemy ogłaszać wycofanie ważnych funkcji.

W tej tabeli znajdziesz wszystkie ogłoszone wycofania funkcji, które mają wpływ na wersje na żywo. Podajemy w niej początkową datę wejścia w życie i opis wycofania wraz z zalecanymi działaniami oraz linkami do odpowiedniej dokumentacji:

Funkcja Początkowa data wejścia w życie Opis
Firma Nielsen jako zewnętrzny dostawca usług pomiaru wyników marki 13 lipca 2026 r.

Od 13 lipca 2026 r. nie będzie można już przypisywać firmy Nielsen jako zewnętrznego dostawcy usług pomiaru wyników marki. Aby uwzględnić tę zmianę, w interfejsie Display & Video 360 API i plikach uporządkowanych danych zostaną wprowadzone te zmiany:

Dotychczasowe korzystanie z usług Nielsen jako dostawcy danych o wynikach marki zostanie usunięte.

Aby uniknąć przerw w działaniu usługi, usuń z integracji przypisanie firmy Nielsen jako dostawcy pomiaru wzrostu świadomości marki.

Dziedziczenie domyślnej nazwy i logo firmy 13 lipca 2026 r.

Od 13 lipca 2026 r. reklamy elastyczne w YouTube będą obsługiwać komponenty z nazwą i logo firmy, a wszystkie reklamy elastyczne w YouTube i kampanie generujące popyt z nieustawionymi komponentami z nazwą i logo firmy będą dziedziczyć wszelkie wartości domyślne ustawione na poziomie reklamodawcy. Jednocześnie ta zmiana spowoduje następujące zmiany w działaniu interfejsu Display & Video 360 API i plików uporządkowanych danych:

  • Pola businessName, logologoImages w zasobach ad_details kampanii generującej popyt AdGroupAd nie będą już wymagane, jeśli reklamodawcy nadrzędnemu zostaną przypisane wartości domyślne. Jeśli nie podasz wartości, reklama odziedziczy domyślne ustawienia na poziomie reklamodawcy.
  • W przypadku reklam dowolnego z tych typów: „Elastyczna”, „Produktowa generująca popyt”, „Wideo generujące popyt”, „Graficzna generująca popyt” i „Karuzela generująca popyt” będzie można ustawić kolumny Business NameLogo Asset IDs w plikach SDF reklamy. Jeśli te kolumny nie są ustawione w przypadku odpowiedniego wpisu reklamy, a wartości domyślne są przypisane do reklamodawcy nadrzędnego, po zapisaniu reklama odziedziczy wartości domyślne na poziomie reklamodawcy.
  • Kolumny Business NameLogo Asset IDs w plikach SDF reklamy nie są już wymagane w przypadku reklam generujących popyt, jeśli reklamodawca nadrzędny przypisał wartości domyślne.

Jeśli wartości domyślne są ustawione na poziomie reklamodawcy, wszystkie reklamy tego reklamodawcy będą miały przypisaną wartość nazwy i logo firmy. Jeśli nie chcesz ustawiać wartości komponentów z nazwą i logo firmy w przypadku reklam elastycznych w YouTube, nie ustawiaj wartości domyślnych dla reklamodawcy.

Zarządzanie kierowaniem na zamówienia reklamowe i kampanie w interfejsie Display & Video 360 API i plikach uporządkowanych danych 23 lutego 2026 r.

23 lutego 2026 r. w Display & Video 360 wycofamy kierowanie na zamówienia reklamowe i kampanie. W związku z tą zmianą zostaną wprowadzone zmiany w interfejsie Display & Video 360 API i plikach uporządkowanych danych (SDF). W interfejsie Display & Video 360 API wycofamy podzbiór metod, które w przypadku wywołania będą zwracać błąd. W pliku SDF kolumny kierowania w plikach Zamówienie reklamoweKampania nie będą już wypełniane podczas pobierania i muszą być puste podczas przesyłania. Zalecamy, aby użytkownicy przypisywali kierowanie bezpośrednio do elementów zamówienia podczas ich tworzenia.

Te metody interfejsu Display & Video 360 API zwrócą błąd 404, jeśli zostaną wywołane:

Wpisy w plikach SDF kampanii, w których do tych kolumn przypisano wartości, 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 Insertion Order, w których do tych kolumn przypisano wartości, 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
Zadeklaruj, 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 przy użyciu interfejsu Display & Video 360 API lub plików SDF będziesz musiał(a) zadeklarować, czy będzie on wyświetlać reklamy polityczne w Unii Europejskiej. Oświadczenia te można składać w następujący sposób:

Jeśli reklamodawca nadrzędny nie będzie zawierać żadnych elementów zamówienia wyświetlających reklamy polityczne w UE, możesz zadeklarować to na poziomie reklamodawcy za pomocą 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 w ramach reklamodawcy będą miały przypisaną tę samą wartość, o ile nie określono inaczej, a wszystkie istniejące elementy zamówienia w ramach reklamodawcy zostaną zaktualizowane, aby używać tej samej wartości, jeśli nie jest ona jeszcze ustawiona. Deklarację elementu zamówienia można zaktualizować w dowolnym momencie po jego utworzeniu za pomocą interfejsu, interfejsu API lub pliku SDF.

Jeśli nie możesz złożyć deklaracji na poziomie reklamodawcy lub zadeklarowałeś(-aś), że w ramach Twojego reklamodawcy mogą być wyświetlane unijne reklamy polityczne, 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:

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ż modyfikowalnym poziomem. Ustawienia kategorii treści będą odtąd kontrolowane wyłącznie na poziomie reklamodawcy. Aby uwzględnić tę zmianę, w interfejsie Display & Video 360 API i plikach uporządkowanych danych zostaną wprowadzone te zmiany:

Aby uniknąć przerw w działaniu usługi:
  • Podczas sprawdzania w interfejsie API elementów zamówienia typu YouTube i sieć partnerów wideo Google pobieraj pole effectiveContentCategory zamiast pola contentCategory.
  • Podczas aktualizowania wpisów elementu zamówienia SDF nie modyfikuj kolumny TrueView Content Filter. Podczas tworzenia nowych elementów 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 można aktualizować ustawień budżetu w przypadku elementów zamówienia z nadrzędnymi zamówieniami reklamowymi skonfigurowanymi pod kątem optymalizacji za pomocą strategii automatycznego określania stawek.

Aby uniknąć przerw w działaniu usługi:
Ograniczenia dotyczące witryn w przypadku plików uporządkowanych danych 12 czerwca 2025 r.

12 czerwca 2025 r. usuniemy dotychczasowe ograniczenie dotyczące adresów URL kierowanych w pozycjach SDF, które uniemożliwiało uwzględnianie nowszych witryn. Zamiast tego SDF będzie dopasowywać się do działania 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 - IncludeSite Targeting - Exclude w plikach Zamówienie reklamoweElement zamówienia.
Kolumna „Mnożniki stawek” w plikach danych strukturalnych elementów zamówienia 1 maja 2025 r.

1 maja 2025 r. wpisy w plikach uporządkowanych danych Element 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 sieci partnerów wideo w przypadku elementów zamówienia generujących popyt w plikach danych strukturalnych 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ść „Generowanie popytu”, musisz podawać wartość „Partnerzy wideo”. Gdy zaczniemy egzekwować to wymaganie, wartość zostanie uzupełniona w przypadku dotychczasowych elementów zamówienia i uwzględniona podczas pobierania nowych plików danych strukturalnych.

Aby uniknąć przerw w działaniu usługi:

  • Zaktualizuj integrację, aby we wszystkich wpisach elementu zamówienia z kampanii generującej popyt uwzględniać wartość „Sieć partnerów wideo”.
  • Zaktualizuj integrację, aby zarządzać źródłami asortymentu kampanii generujących popyt na poziomie grupy reklam za pomocą kolumn SDF w wersji 8.1 – grupa reklam Demand Gen Inventory Source StrategyDemand Gen Enabled Inventory Sources.
Kampanie wideo zachęcające do działania w plikach danych strukturalnych 22 kwietnia 2025 r.

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ż zostaną one przekształcone w kampanie generujące popyt. Próby przesłania wpisów elementów zamówienia z wartością kolumny Subtype „Action” i wartością kolumny Type „TrueView” zakończą się niepowodzeniem.

Aby uniknąć przerw w działaniu usługi, zaktualizuj integrację, aby korzystać z kampanii generujących popyt zamiast z 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ą umożliwiać nieograniczony okres członkostwa odbiorców. Żądania firstAndThirdPartyAudiences.createfirstAndThirdPartyAudiences.patch, w których wartość pola membershipDurationDays jest ustawiona na 10 000, będą zwracać błąd 400. Dotychczasowe listy odbiorców z wartością pola membershipDurationDays wynoszącą 10 000 zostaną zaktualizowane do 540,a nowy okres członkostwa zostanie zastosowany z mocą wsteczną 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żaj członkostwo w dotychczasowych grupach odbiorców kierowania na listę klientów za pomocą firstAndThirdPartyAudiences.editCustomerMatchMembers.
  • Regularnie odświeżaj członkostwo na listach odbiorców kierowania na listę klientów, aby mieć pewność, że rozmiar listy odbiorców nie zmniejszy się nieumyślnie.

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.:

Aby uniknąć przerw w działaniu usługi, zaktualizuj integrację w ten sposób:

  • 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

Informacje o zapowiedzianych wycofaniach, które mają wpływ na wersje interfejsu Display & Video 360 API, znajdziesz w naszych zarchiwizowanych wycofaniach.