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.

Informacje o wycofaniu i wyłączeniu interfejsu API będą też publikowane na blogu Google Ads dla deweloperów.

Wycofanie wersji

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

  • Wersja: wersja opuszcza stan alfa lub beta i jest uznawana za stabilną. W tej wersji mogą być nadal udostępniane nowe funkcje.
  • Wycofanie: wycofujemy wersję i ogłaszamy datę zakończenia jej obsługi. Użytkownicy muszą przejść na nowszą wersję przed datą wycofania. W tej wersji nie będą już udostępniane nowe funkcje.
  • Wycofanie: ta wersja nie jest już obsługiwana. Żądania wysłane do wersji zwracają błąd.

Tabela poniżej zawiera listę wszystkich dotychczasowych wersji podstawowego interfejsu Display & Video 360 API, ich dat wydania oraz dat ich wycofania i zakończenia obsługi (jeśli zostały ogłoszone).

Wersja interfejsu API Data wydania Data wycofania Data wycofania Przewodnik po migracji
v3 31 października 2023 r.
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

Wycofanie funkcji

Aby dowiedzieć się o nadchodzących ważnych wycofanych funkcjach, obserwuj bloga dla programistów Google Ads.

Tabela poniżej zawiera listę wszystkich zapowiedzianych wycofań funkcji, z datą początkowej skuteczności, opisem wycofania oraz zalecanymi działaniami i linkami do odpowiedniej dokumentacji:

Funkcja Data początkowego wejścia w życie Opis
Rozszerzanie zasięgu kierowania 25 marca 2023 r. Zastąpienie funkcji rozszerzania zasięgu kierowania funkcją kierowania zoptymalizowanego, która będzie wdrażana stopniowo od 25 marca 2023 r. do początku maja 2023 r. W poście na blogu ogłoszono istotne zmiany w zachowaniu interfejsu Display & Video 360 API i plików uporządkowanych danych oraz zalecane działania.
Aktywatory ręczne 17 maja 2023 r.

Oś czasu:

  • 17 maja 2023 r.: elementy zamówienia korzystające z ręcznych uruchamiaczy przestaną się wyświetlać w Display & Video 360. Jeśli po tej dacie uaktywnisz regułę ręczną powiązaną z aktywnym elementem zamówienia, element zamówienia nie będzie wyświetlać reklam.
  • 1 sierpnia 2023 r.: wycofanie usługi advertisers.manualTriggers w interfejsie DV360 API w wersji 1 i 2, wartości wyliczenia LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER w interfejsie DV360 API w wersji 1 oraz pola LineItemFlight.triggerId w interfejsie DV360 API w wersji 1. Po tym terminie żądania wysyłane do tych usług lub pól będą zwracać błąd.

Zalecane działania:

  • Natychmiast przestań używać reguł ręcznych do uruchamiania i zatrzymywania wyświetlania elementów zamówienia.
  • Przestań wysyłać żądania do usługi advertisers.manualTriggers.
  • Zaktualizuj pola flight.flightDateTypeflight.triggerId we wszystkich elementach zamówienia za pomocą ręcznych inicjatorów.
Zainstalowane aplikacje i nowe urządzenia mobilne GoogleAudience 20 maja 2023 r.

Oś czasu:

  • 20 maja 2023 r.: nie będzie już można przypisywać do elementu zamówienia lub kierowania na zamówienie reklamowe zasobów GoogleAudienceGoogleAudienceType GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS lub GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES. Prośby o przypisanie tych list odbiorców do kierowania na odbiorców elementu zamówienia zwrócą błąd. Obejmuje to żądania advertisers.lineItems.duplicateadvertisers.lineItems.generateDefault, jeśli utworzony element zamówienia będzie zawierać w kierowaniu na odbiorców listy odbiorców wycofane.
  • 8 czerwca 2023 r.: listy odbiorców, na które ma to wpływ, zostaną usunięte ze wszystkich ustawień kierowania elementu zamówienia i zamówienia reklamowego oraz ze wszystkich połączonych list odbiorców. Jeśli po usunięciu tych list element zamówienia nie może wyświetlać reklam, zostaje wstrzymany. Tego dnia tych list odbiorców nie będzie też można pobrać za pomocą usługi googleAudiences.

Zalecane zadania:

  • Zalecamy, aby w przyszłości, gdy będziesz wprowadzać zmiany w kierowaniu elementu zamówienia, natychmiast przestać używać list odbiorców, których dotyczy problem.
  • Usuń wszystkie te listy odbiorców z dotychczasowego kierowania elementu zamówienia i zamówienia reklamowego. Więcej informacji o aktualizowaniu kierowania na odbiorców znajdziesz w przewodniku Grupy odbiorców.
Typy list odbiorców na podstawie aktywności i ograniczenia liczby wyświetleń FirstAndThirdPartyAudience 20 maja 2023 r.

Oś czasu:

  • 20 maja 2023 r.: nie będzie już można przypisywać do elementu zamówienia lub kierowania na zamówienie reklamowe zasobów FirstAndThirdPartyAudienceAudienceType ACTIVITY_BASED lub FREQUENCY_CAP. Prośby o przypisanie tych list odbiorców do kierowania na odbiorców elementu zamówienia zwrócą błąd. Obejmuje to żądania advertisers.lineItems.duplicateadvertisers.lineItems.generateDefault, jeśli utworzony element zamówienia będzie zawierać w kierowaniu na odbiorców listy odbiorców wycofane.
  • 8 czerwca 2023 r.: listy odbiorców, na które ma to wpływ, zostaną usunięte ze wszystkich ustawień kierowania elementu zamówienia i zamówienia reklamowego oraz ze wszystkich połączonych list odbiorców. Jeśli po usunięciu tych list element zamówienia nie może wyświetlać reklam, zostaje wstrzymany. Tego dnia tych list odbiorców nie będzie też można pobrać za pomocą usługi firstAndThirdPartyAudiences.

Zalecane zadania:

  • Zalecamy, aby w przyszłości, gdy będziesz wprowadzać zmiany w kierowaniu elementu zamówienia, natychmiast przestać używać list odbiorców, których dotyczy problem.
  • Usuń wszystkie te listy odbiorców z dotychczasowego kierowania elementu zamówienia i zamówienia reklamowego. Więcej informacji o aktualizowaniu kierowania na odbiorców znajdziesz w przewodniku Grupy odbiorców.
Dotychczasowe limity przydziału interfejsu API 30 maja 2023 r.

30 maja 2023 r. dotychczasowe limity wykorzystania zostaną zastąpione hybrydową strukturą limitów, która:

  1. Usuwa limit żądań dziennie na projekt.
  2. Wprowadza limit żądań na minutę na reklamodawcę na projekt w przypadku kwalifikujących się metod.

Te nowe limity zapewnią większą elastyczność w korzystaniu z interfejsu API i umożliwią równoległe wysyłanie żądań przez różnych reklamodawców. Szczegółowe informacje o tej zmianie znajdziesz w naszej dokumentacji dotyczącej limitu kwoty.

Użycie operatora OR między ograniczeniami różnych pól w filtrach LIST

21 czerwca 2023 r.

21 czerwca 2023 r. parametry LIST żądania filter nie będą już zezwalać na używanie operatorów logicznych OR między ograniczeniami dotyczącymi różnych pól.

Na przykład zasoby zidentyfikowane za pomocą ciągu filtra lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" muszą być zamiast tego pobierane za pomocą 2 żądań LIST z tymi ciągami filtra:

  • lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT"
  • insertionOrderId="123"

Więcej informacji o ograniczeniach operatorów logicznych znajdziesz w przewodniku dotyczącym filtrowania żądań LIST.

Przed 21 czerwca 2023 r. sprawdź parametry zapytania filter we wszystkich dotychczasowych wywołaniach LIST i upewnij się, że używają one prawidłowo operatora logicznego LUB.

Możliwość filtrowania i sortowania żądań list według pól budget.budget_segments.date_range.end_dateflight.dateRange.endDate

Zmieniono datę początkowego wejścia w życie

21 czerwca 2023 r.

21 czerwca 2023 r. pola budget.budget_segments.date_range.end_dateflight.dateRange.endDate nie będą już akceptowane w parametrach zapytań advertisers.insertionOrders.listadvertisers.lineItems.list (odpowiednio filterorderBy). Po tej dacie żądania korzystające z tych pól w parametrach zapytania filterorderBy będą zwracać błąd.

Aby uniknąć przerw w działaniu usługi, przed 21 czerwca 2023 r. usuń całą logikę filtrowania i porządkowania, która korzysta z tych 2 pól.

Możliwość filtrowania żądań advertisers.lineItems.list według 4 dodatkowych pól 21 czerwca 2023 r.

21 czerwca 2023 r. advertisers.lineItems.list nie będzie już obsługiwać filtrowania według tych pól:

  • flight.triggerId
  • targetedChannelId
  • targetedNegativeKeywordListId
  • warningMessages

Aby uniknąć przerwy w działaniu usługi, przed 21 czerwca 2023 r. usuń całą logikę filtra, która korzysta z tych 4 pól.

Kupowanie na podstawie wyników 1 sierpnia 2023 r.

1 sierpnia 2023 r. zamówienia reklamowe korzystające z kupowania na podstawie wyników, z wartością pola billableOutcome równą BILLABLE_OUTCOME_PAY_PER_CLICK lub BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION, oraz ich elementy zamówienia podrzędne zostaną zarchiwizowane.

Ta zmiana będzie miała wpływ na te prośby:

Pole publisherReviewStatuses w zasobach kreacji 26 czerwca 2024 r.

Od 26 czerwca 2024 r. pole publisherReviewStatuses zostanie wycofane i będzie puste podczas pobierania zasobów Creative.

Kierowanie na treści w przypadku elementów zamówienia typu YouTube i sieć partnerów wideo Google 30 września 2024 r.

30 września 2024 r. w przypadku elementów zamówienia typu YouTube i sieć partnerów wideo Google zostaną wycofane te wartości typów kierowania:

Opcje kierowania, które zostaną wycofane, zostaną automatycznie usunięte z dotychczasowego kierowania elementu zamówienia. Te wartości nadal będą dostępne do stosowania w kierowaniu na poziomie reklamodawcy.

Aby uniknąć przerw w świadczeniu usług, przed datą wycofania usuń to ustawienie kierowania z dotychczasowych elementów zamówienia typu YouTube i sieć partnerów wideo Google.

Własne listy odbiorców i listy odbiorców Oracle 30 września 2024 r.

30 września 2024 r. kończy się wsparcie dla źródeł danych FirstAndThirdPartyAudience firmy Oracle. Po wycofaniu te listy odbiorców zostaną usunięte z dotychczasowych ustawień kierowania na zasoby i z list odbiorców połączonych. Jeśli element zamówienia jest kierowany tylko na odbiorców objętych wycofaniem lub negatywnie na wszystkich odbiorców objętych wycofaniem, zostanie on automatycznie wstrzymany.

Aby uniknąć przerw w świadczeniu usług, przed datą wycofania z użycia zidentyfikuj i usuń z dotychczasowego kierowania na listę odbiorców w poszczególnych pozycjach reklamowych oraz z połączonych list odbiorców wszystkich odbiorców Oracle.

Kierowanie zoptymalizowane na element zamówienia w przypadku podzbioru strategii ustalania stawek 30 września 2024 r.

30 września 2024 r. zasoby LineItem korzystające z podzbioru strategii ustalania stawek nie będą już zgodne z kierowaniem zoptymalizowanym. W ramach tej zmiany zasoby LineItem z wartością targetingExpansion.enableOptimizedTargeting True i bidStrategy.maximizeSpendAutoBid.performanceGoalType BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_CIVA, BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_IVO_TEN lub BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_AV_VIEWED lub bidStrategy.performanceGoalAutoBid.performanceGoalType BIDDING_STRATEGY_PERFORMANCE_GOAL_TYPE_VIEWABLE_CPM zostaną zaktualizowane, aby mieć wartość targetingExpansion.enableOptimizedTargeting False.

Aby uniknąć przerw w świadczeniu usług, zaktualizuj elementy zamówienia korzystające z tych strategii ustalania stawek i sprawdź, czy nie mają włączonego kierowania zoptymalizowanego.

Emisja, jak najszybciej Pacing w przypadku zamówień reklamowych 5 listopada 2024 r.

5 listopada 2024 r. podczas ustawiania pola zamówienia reklamowego pacing PACING_TYPE_ASAP nie będzie już zgodne z PACING_PERIOD_FLIGHT. Wartość pacingType we wszystkich istniejących zamówieniach reklamowych z tą konfiguracją zostanie zmieniona na PACING_TYPE_AHEAD.

Aby uniknąć przerw w świadczeniu usług, zaktualizuj pacing wszystkich istniejących zamówień reklamowych za pomocą PACING_TYPE_ASAPPACING_PERIOD_FLIGHT.

Okres obowiązywania limitu wyświetleń na użytkownika przekracza 30 dni 28 lutego 2025 r.

28 lutego 2025 r.:

  • Prośby o tworzenie lub aktualizowanie zasobów LineItem, InsertionOrderCampaign, które używają obiektu FrequencyCap z polem timeUnit ustawionym na TIME_UNIT_LIFETIME lub polem timeUnit ustawionym na TIME_UNIT_MONTH oraz polem timeUnitCount ustawionym na 2, zwracają błąd 400.
  • Wpisy w plikach uporządkowanych danych Element zamówienia, Zamówienie reklamoweKampania, w których wartość w kolumnie „Okres częstotliwości” to „Dożywotnio” lub „Miesiące”, a wartość w kolumnie „Ilość wyświetleń” to „2”, nie zostaną utworzone ani zaktualizowane podczas przesyłania pliku.
  • Istniejące kampanie, zamówienia reklamowe i elementy zamówienia zostaną zaktualizowane, aby używały okresu ograniczenia liczby wyświetleń wynoszącego co najwyżej 30 dni.

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

  • Zaktualizuj istniejące zasoby kampanii, zamówienia reklamowego i elementu zamówienia, które korzystają z okresu limitu wyświetleń na użytkownika dłuższego niż 30 dni, tak aby wynosił 30 dni lub krócej.
  • Sprawdź, czy podczas tworzenia lub aktualizowania zasobów kampanii, zamówienia reklamowego lub elementu zamówienia za pomocą interfejsu API Display & Video 360 lub plików uporządkowanych danych integracja nie ustawia okresu limitu wyświetleń na użytkownika dłuższego niż 30 dni.
Kierowanie zoptymalizowane w przypadku elementów zamówienia korzystających ze stałej stawki 6 marca 2025 r.

6 marca 2025 r.:

  • Prośby o utworzenie lub zaktualizowanie zasobów LineItem, aby ustawić pole BiddingStrategy fixedBid i pole TargetingExpansionConfig enableOptimizedTargeting na wartość „PRAWDA”, zwrócą błąd 400.
  • Wpisy w plikach uporządkowanych danych Elementu zamówienia, w których wartość w kolumnie „Typ strategii ustalania stawek” to „Stałe”, a wartość w kolumnie „Skuteczne kierowanie” to „Prawda”, nie zostaną utworzone ani zaktualizowane podczas przesyłania pliku.
  • Istniejące elementy zamówienia korzystające ze stałego określania stawek zostaną zaktualizowane tak, aby wyłączyć kierowanie zoptymalizowane.

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

  • Zaktualizuj istniejące zasoby elementów zamówienia, które korzystają zarówno ze stałego określania stawek, jak i z kierowania zoptymalizowanego.
  • Sprawdź, czy podczas tworzenia lub aktualizowania zasobów elementów zamówienia za pomocą interfejsu Display & Video 360 API lub plików uporządkowanych danych integracja nie ustawia stałej strategii ustalania stawek i optymalizowanego kierowania.
Zmień domyślny rozmiar strony na firstAndThirdPartyAudiences.list 6 marca 2025 r.

6 marca 2025 r. domyślny rozmiar strony dla żądań firstAndThirdPartyAudiences.list zostanie zwiększony z 100 do 5000.

Aby uniknąć przerw w działaniu usługi, zaktualizuj integrację, aby ustawić parametr zapytania pageSize żądań firstAndThirdPartyAudiences.list na preferowany rozmiar strony.

Nowy błąd niezgodności partnera/reklamodawcy sdfdownloadtasks.create 6 marca 2025 r.

6 marca 2025 r. żądania sdfdownloadtasks.create, które używają filtra nadrzędnego do filtrowania według reklamodawców, którzy nie są podrzędnymi zestawu partnerId, zaczną zwracać błąd 400.

Niezgodność algorytmu ustalania stawek niestandardowych i aktywności Floodlight 1 kwietnia 2025 r.

1 kwietnia 2025 r.:

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ą zaktualizowania algorytmów ustalania stawek niestandardowych są one odłączane od wszystkich elementów zamówienia.

Nieograniczony okres członkostwa w przypadku własnych list odbiorców 7 kwietnia 2025 r.

7 kwietnia 2025 r. zasoby FirstAndThirdPartyAudience nie będą już pozwalać na nieograniczony czas trwania członkostwa w grupie odbiorców. Żądania firstAndThirdPartyAudiences.createfirstAndThirdPartyAudiences.patch, które ustawiają wartość pola membershipDurationDays na 10 tys., zwracają błąd 400. Wartość pola membershipDurationDays w przypadku dotychczasowych list odbiorców o wartości 10 000 zostanie zaktualizowana do 540,a nowy czas trwania subskrypcji zostanie zastosowany z skutkiem wstecznym do dotychczasowych subskrypcji. 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 ani dotychczasowych list odbiorców na 10 tys.
  • Odśwież członkostwo dotychczasowych list odbiorców kierowanych na listę klientów za pomocą firstAndThirdPartyAudiences.editCustomerMatchMembers.
  • Regularnie odświeżaj listy członków list 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.

Kolumna „Współczynniki stawek” w plikach danych uporządkowanych dotyczących pozycji 1 maja 2025 r.

1 maja 2025 r. nie będzie można utworzyć ani zaktualizować zasobu podczas przesyłania pliku z pliku uporządkowanych danych Element zamówienia, który zawiera kolumnę „Współczynniki stawek”.