Ogłoszone wycofania

Ta strona zawiera daty wycofania i wycofania wersji interfejsu API oraz poszczególnych funkcji interfejsu Display & Video 360 API.

Informacje o wycofaniach i datach wycofania interfejsu API zostaną również ogłoszone na blogu dla programistów Google Ads.

Wycofane wersje

Wersje interfejsu Display & Video 360 API są regularnie publikowane, wycofywane i wycofywane. Kroki te są definiowane w ten sposób:

  • Wersja: wersja wycofuje się z wersji alfa lub beta i jest uważana za stabilną. Dodatkowe funkcje w tej wersji mogą być nadal publikowane.
  • Wycofanie: ta wersja jest wycofywana i ogłaszana jest data zakończenia obsługi (wyłączenia). Użytkownicy muszą przejść na nowszą wersję przed datą wycofania tej usługi. Dodane funkcje nie będą już publikowane w tej wersji.
  • Wycofanie: ta wersja nie jest już obsługiwana. Żądania wysyłane do wersji zwracają błąd.

W tabeli poniżej znajdziesz wszystkie istniejące podstawowe wersje interfejsu Display & Video 360 API, daty ich premiery oraz daty ich wycofania i wycofania, jeśli zostaną ogłoszone.

Wersja interfejsu API Data premiery Data wycofania Data zachodu słońca Przewodnik po migracji
v3 31 października 2023 r.
v2 6 grudnia 2022 r. 15 lutego 2024 r. 3 września 2024 r. Migracja z wersji 2 do wersji 3
v1 Marzec 9, 2020 13 marca 2023 r. 14 września 2023 r. Migracja z wersji 1 do wersji 2

Wycofane funkcje

Obserwuj naszego bloga dla deweloperów Google Ads, aby być na bieżąco z informacjami o zbliżającym się wycofaniu istotnych funkcji.

W tabeli poniżej znajdziesz listę wszystkich zapowiedzianych wycofywania funkcji wraz z początkową datą wejścia w życie i opisem wycofanych funkcji wraz z zalecanymi działaniami i linkami do odpowiedniej dokumentacji:

Funkcja Początkowa data wejścia w życie Opis
Rozszerzanie zasięgu kierowania 25 marca 2023 r. Zastąpienie funkcji rozszerzania zasięgu kierowania kierowaniem zoptymalizowanym wprowadzanym stopniowo między 25 marca a początkiem maja 2023 r. Odpowiednie zmiany w działaniu interfejsu Display & Video 360 API i plików uporządkowanych danych, a także zalecane działania zostały ogłoszone w poście na blogu.
Aktywatory ręczne 17 maja 2023 r.

Oś czasu:

  • 17 maja 2023 r.: elementy zamówienia, które korzystają z reguł ręcznych, przestaną wyświetlać reklamy w Display & Video 360. Jeśli po tej dacie aktywujesz regułę ręczną połączoną z aktywnym elementem zamówienia, element nie będzie wyświetlać reklam.
  • 1 sierpnia 2023 r.: usługa advertisers.manualTriggers w interfejsach DV360 API w wersjach 1 i 2, wartość wyliczeniowa LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER w interfejsie DV360 API w wersji 1 oraz pole LineItemFlight.triggerId w interfejsie API DV360 w wersji 1 zostaną wycofane. Po tym terminie żądania wysyłane do tych usług lub tych pól będą zwracać błąd.

Zalecane działania:

  • Natychmiast przestań używać reguł ręcznych do uruchamiania i zatrzymywania wyświetlania elementu zamówienia.
  • Przestań wysyłać żądania do usługi advertisers.manualTriggers.
  • Zaktualizuj pola flight.flightDateType i flight.triggerId we wszystkich elementach zamówienia, które korzystają z reguł ręcznych.
Typy zainstalowanych aplikacji i nowych urządzeń mobilnych GoogleAudience 20 maja 2023 r.

Oś czasu:

  • 20 maja 2023 r.: nie będzie już można przypisywać zasobów GoogleAudience z GoogleAudienceType o wartości GOOGLE_AUDIENCE_TYPE_INSTALLED_APPS lub GOOGLE_AUDIENCE_TYPE_NEW_MOBILE_DEVICES do kierowania na odbiorców w elementach zamówienia lub zamówieniach reklamowych. Żądania przypisania tych odbiorców do kierowania na odbiorców elementu zamówienia będą zwracać błąd. Obejmuje to żądania advertisers.lineItems.duplicate i advertisers.lineItems.generateDefault, jeśli utworzony element zamówienia zawierałby wycofanych odbiorców w kierowaniu na odbiorców.
  • 8 czerwca 2023 r.: listy odbiorców, których to dotyczy, zostaną usunięte ze wszystkich ustawień kierowania elementów zamówienia i zamówień reklamowych oraz ze wszystkich połączonych odbiorców. Jeśli po usunięciu tych odbiorców element zamówienia nie będzie mógł wyświetlać reklam, zostaną oni wstrzymani. Tego dnia nie będzie już można pobrać tych list odbiorców za pomocą usługi googleAudiences.

Zalecane zadania:

  • Przy wprowadzaniu zmian w kierowaniu elementów zamówienia zalecamy natychmiastowe zaprzestanie korzystania z tych odbiorców.
  • Usuń wszystkich odbiorców, których dotyczy ta zmiana, z dotychczasowego kierowania elementów zamówienia i zamówień reklamowych. Przeczytaj o aktualizowaniu kierowania na odbiorców w przewodniku po grupach odbiorców.
Typy FirstAndThirdPartyAudience oparte na aktywności i ograniczenia liczby wyświetleń 20 maja 2023 r.

Oś czasu:

  • 20 maja 2023 r.: nie będzie już można przypisywać zasobów FirstAndThirdPartyAudience z AudienceType o wartości ACTIVITY_BASED lub FREQUENCY_CAP do kierowania na odbiorców w elementach zamówienia lub zamówieniach reklamowych. Żądania przypisania tych odbiorców do kierowania na odbiorców elementu zamówienia będą zwracać błąd. Obejmuje to żądania advertisers.lineItems.duplicate i advertisers.lineItems.generateDefault, jeśli utworzony element zamówienia zawierałby wycofanych odbiorców w kierowaniu na odbiorców.
  • 8 czerwca 2023 r.: listy odbiorców, których to dotyczy, zostaną usunięte ze wszystkich ustawień kierowania elementów zamówienia i zamówień reklamowych oraz ze wszystkich połączonych odbiorców. Jeśli po usunięciu tych odbiorców element zamówienia nie będzie mógł wyświetlać reklam, zostaną oni wstrzymani. Tego dnia nie będzie już można pobrać tych list odbiorców za pomocą usługi firstAndThirdPartyAudiences.

Zalecane zadania:

  • Przy wprowadzaniu zmian w kierowaniu elementów zamówienia zalecamy natychmiastowe zaprzestanie korzystania z tych odbiorców.
  • Usuń wszystkich odbiorców, których dotyczy ta zmiana, z dotychczasowego kierowania elementów zamówienia i zamówień reklamowych. Przeczytaj o aktualizowaniu kierowania na odbiorców w przewodniku po grupach odbiorców.
Obecne limity interfejsu API 30 maja 2023 r.

30 maja 2023 roku obecne limity wykorzystania zostaną zastąpione hybrydową strukturą limitów:

  1. Eliminuje limit dziennych żądań na projekt.
  2. Określa limit żądań na minutę na reklamodawcę w ramach projektu na potrzeby kwalifikacji metod.

Te nowe limity zwiększą elastyczność w korzystaniu z interfejsu API i umożliwią równoległe przetwarzanie żądań od reklamodawców. Szczegółowe informacje o tej zmianie znajdziesz w naszej dokumentacji dotyczącej dotychczasowych limitów.
Użycie operatora OR między ograniczeniami różnych pól w filtrach LIST

21 czerwca 2023 r.

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

Na przykład zasoby zidentyfikowane przez ciąg filtra lineItemType="LINE_ITEM_TYPE_DISPLAY_DEFAULT" OR insertionOrderId="123" muszą być pobierane przy użyciu 2 żądań LIST z następującymi ciągami filtra:

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

Więcej informacji o ograniczeniach operatorów logicznych znajdziesz w przewodniku po filtrowaniu żądań LIST.

Aby uniknąć przerw w działaniu usługi, przed 21 czerwca 2023 roku sprawdź parametry zapytania filter we wszystkich dotychczasowych wywołaniach LIST i upewnij się, że prawidłowo używają operatora logicznego LUB.
Możliwość filtrowania i porządkowania żądań listy według pól budget.budget_segments.date_range.end_date i flight.dateRange.endDate

Początkowa data wejścia w życie została zaktualizowana

 21 czerwca 2023 r.

Od 21 czerwca 2023 r. pola budget.budget_segments.date_range.end_date i flight.dateRange.endDate odpowiednio w parametrach zapytania advertisers.insertionOrders.list oraz advertisers.lineItems.list filter i orderBy nie będą już akceptowane. Po tej dacie żądania używające tych pól w parametrach zapytania filter i orderBy będą zwracać błąd.

Aby uniknąć przerw w działaniu usługi, przed 21 czerwca 2023 r. usuń całą logikę filtrowania i zamówienia za pomocą tych 2 pól.
Możliwość filtrowania żądań advertisers.lineItems.list według 4 dodatkowych pól 21 czerwca 2023 r.

Od 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ąć przerw w działaniu usługi, przed 21 czerwca 2023 r. usuń wszystkie logiki filtrów korzystające z tych 4 pól.
Kupowanie na podstawie wyników 1 sierpnia 2023 r.

1 sierpnia 2023 r. zarchiwizowane elementy zamówienia reklamowe korzystające z kupowania na podstawie wyników zdefiniowane w polu billableOutcome o wartości BILLABLE_OUTCOME_PAY_PER_CLICK lub BILLABLE_OUTCOME_PAY_PER_VIEWABLE_IMPRESSION zostaną zarchiwizowane.

Ta zmiana wpłynie na te żądania: