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ą też 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: 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 wydania 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. Migracja 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 naszym 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. Podano 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
Zarządzanie kierowaniem w zamówieniach reklamowych i kampaniach 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 część 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.

Jeśli wywołasz te metody interfejsu Display & Video 360 API, zwrócą one błąd 404:

Przesyłanie wpisów w pliku SDF Campaign, w których do tych kolumn przypisano wartości, zakończy się niepowodzeniem:

  • 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 w tych kolumnach są przypisane 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
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 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 dotychczasowe 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 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ż modyfikowalne na poziomie elementu zamówienia. 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 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 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.

Wymagaj ź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 mają w kolumnie Type wartość „Generowanie popytu”, musisz podać wartość „Partnerzy wideo”. Gdy zacznie obowiązywać to egzekwowanie, 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 elementu zamówienia z wartością kolumny Subtype „Action” (Działanie) 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 rozmiar tych list nie zmniejszał 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 wycofane wersje API Display & Video 360, znajdziesz w archiwum wycofań.