Wycofanie i wycofanie

Wraz z opublikowaniem nowej wersji wycofanej wersji zostaje wyznaczona data wycofania, po upływie której nie będzie już ona dostępna. Oto kilka dodatkowych wskazówek, o których warto pamiętać:

  • W danym momencie dostępne są maksymalnie 3 główne wersje.
  • Wersje główne mają żywotność od 12 miesięcy do wersji podrzędnych: 10 miesięcy.
  • Wystarczą maksymalnie 2 uaktualnienia rocznie i nie trzeba uaktualniać w ścisłej kolejności, np. można uaktualnić wersję (N) bezpośrednio do wersji (N+2).
  • Okres między opublikowaniem wszystkich bibliotek klienta a wycofaniem wersji wynosi co najmniej 20 tygodni.

Nasze biblioteki klienta obsługują wszystkie dostępne wersje usług, możesz więc stopniowo przeprowadzać uaktualnienie, określając różne wersje używanych usług.

Rozkład

W tabeli poniżej znajdziesz dokładne daty wycofania i wycofania poszczególnych dostępnych wersji oraz przewidywane daty ich wydania w przypadku przyszłych wersji. Zachęcamy do uaktualnienia do najnowszej wersji jak najszybciej po jej opublikowaniu.

Wersja interfejsu API Data premiery Data wycofania Data wycofania Przewodnik uaktualniania
v18 wrzesień i październik 2024 r. styczeń i luty 2025 r. Wrzesień 2025 r.
v17.1 lipiec/sierpień 2024 r. wrzesień i październik 2024 r. Maj 2025 r.
v17 maj/czerwiec 2024 r. wrzesień i październik 2024 r. Maj 2025 r.
v16.1 kwiecień/maj 2024 r. maj/czerwiec 2024 r. Styczeń 2025 r.
v16 21 lutego 2024 r. maj/czerwiec 2024 r. Styczeń 2025 r.
v15 18 października 2023 r. 21 lutego 2024 r. 25 września 2024 r. Uaktualnienie z wersji 15 do wersji 16
v14.1 9 sierpnia 2023 r. 18 października 2023 r. 5 czerwca 2024 r.
v14 7 czerwca 2023 r. 18 października 2023 r. 5 czerwca 2024 r. Uaktualnienie z wersji 14 do wersji 15

Wyświetlanie wersji, których używa Twój projekt

Listę metod i usług wywołanych ostatnio przez Twój projekt możesz wyświetlić w konsoli Google Cloud:

  1. W konsoli Google Cloud otwórz sekcję Interfejsy API i usługi.
  2. W tabeli kliknij Interfejs Google Ads API.
  3. Na podkarcie DANE ostatnie żądania powinny być przedstawione na każdym wykresie. Metody używane do wysyłania żądań możesz sprawdzić w tabeli Metody. Nazwa metody obejmuje wersję interfejsu Google Ads API, usługę i nazwę metody, np. google.ads.googleads.v16.services.GoogleAdsService.Mutate.
  4. (Opcjonalnie) Wybierz przedział czasu, w którym chcesz wyświetlać swoje żądania.

Różnice między wycofywaniem a wycofaniem

TerminWycofanieZachód słońca
Definicja Wycofana wersja to nie najnowsza wersja. Po opublikowaniu nowej wersji wszystkie wcześniejsze wersje zostaną oznaczone jako wycofane. Wycofanej wersji nie można już używać. Żądania wysyłane do tej wersji będą kończyć się niepowodzeniem w dniu wycofania usługi lub później.
Konsekwencje Możesz używać wycofanych wersji do momentu ich wycofania, ale odniesienia do tych wersji będą odznaczone, aby poinformować, że nie są już najnowszą wersją.

Zachęcamy do jak najszybszego uaktualnienia do najnowszej wersji, co pozwoli Ci korzystać z nowych funkcji.

Aby korzystać z interfejsu Google Ads API, musisz natychmiast przejść na wyższą wersję wycofywaną.

Zdecydowanie zalecamy uaktualnienie do najnowszej wersji przy użyciu przewodnika po uaktualnieniu.

Czas Nową wersję udostępniamy średnio co 3–4 miesiące, więc dana wersja zostanie wycofana po około 3–4 miesiącach. Zamierzamy wycofać wersję 1 rok po jej opublikowaniu.
API Punkty końcowe interfejsu API dla wycofanych wersji nadal działają tak jak zwykle.

Możesz uzyskać dostęp do punktów końcowych interfejsu API za pomocą naszych bibliotek klienta, REST itp. Jednak nowe funkcje nie są dodawane do wersji wycofanych.

Punkty końcowe interfejsu API wycofanych wersji przestaną działać po dacie wycofania. Jeśli spróbujesz uzyskać dostęp do punktów końcowych API wycofanych wersji, interfejs Google Ads API zgłosi błąd.
Biblioteki klienta W związku z udostępnieniem kompaktowych bibliotek klienta przestaniemy uwzględniaćwycofane wersje interfejsu API w nowej wersji biblioteki klienta po dacie wycofania. Pomaga to zaoszczędzić miejsce przy włączaniu naszych bibliotek klienta do projektów. Biblioteki klienta nie obsługują już wycofanych wersji interfejsu API w nowych wersjach biblioteki klienta po dacie wycofania.
Pomoc Zapewniamy regularne wsparcie wersji wycofanych. Wersje wycofanej funkcji nie będą już obsługiwane po dacie wycofania.

Obsługiwane wersje biblioteki klienta

Tabela pokazuje, z którymi bibliotekami klienta współpracują poszczególne wersje interfejsu API.

Java

Biblioteka klienta dla języka Java
v16 Min: 30.0.0
Max: –
v15 Min: 28.0.0
Max: –
v14 Min: 26.0.0
Max: –

C#

Biblioteka klienta dla .NET
v16 Min: 18.1.0
Max: –
v15 Min: 17.1.0
Max: –
v14 Min: 16.1.0
Max: –

PHP

Biblioteka klienta dla języka PHP
v16 Min: 22.1.0
Max: –
v15 Min: 21.1.0
Max: –
v14 Min: 19.2.0
Max: –

Python

Biblioteka klienta dla Pythona
v15 Min: 22.1.0
Max: –
v14 Min: 21.2.0
Max: –

Ruby

Biblioteka klienta dla Ruby
v16 Min: 27.0.0
Max: –
v15 Min: 25.0.0
Max: –
v14 Min: 23.0.0
Max: –

Perl

Biblioteka klienta dla Perl
v16 Min: 21.0.0
Max: –
v15 Min: 19.0.0
Max: –
v14 Min: 17.0.0
Max: –

Wycofane funkcje

Zaglądaj regularnie na bloga dla programistów Google Ads, by być na bieżąco z informacjami o wycofywaniu funkcji.

W tabeli poniżej znajdziesz listę funkcji, które są obecnie planowane do wycofania z interfejsu Google Ads API. Więcej informacji o każdym wycofywaniu znajdziesz w postach, do których prowadzą linki na blogu.

Funkcja Opis Data obowiązywania Dodatkowe uwagi
Strategia ustalania stawek Prowizje Interfejs Google Ads API nie obsługuje już tworzenia kampanii reklam hoteli ze strategią ustalania stawek COMMISSION . 30 kwietnia 2024 r. Prośby o utworzenie nowych kampanii reklam hoteli lub zastosowanie strategii ustalania stawek COMMISSION do dotychczasowych kampanii będą powodować błąd BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED. Istniejące kampanie ze strategią ustalania stawek COMMISSION będą działać do 31 października 2024 r. Po tym dniu kampanie przestaną wyświetlać reklamy, dopóki nie zaktualizujesz ich strategii ustalania stawek.