wycofanie i wycofanie

Po opublikowaniu nowej wersji wycofana wersja otrzymuje datę wycofania, po której nie będzie już dostępna. Oto dodatkowe wskazówki, o których warto pamiętać:

• Staramy się, aby w danym momencie było dostępnych co najwyżej 5 wersji głównych.
• Główne wersje są dostępne przez około 12 miesięcy , a pomocnicze wersje – przez 10 miesięcy.
• Będziesz musiał(-a) przeprowadzić co najwyżej 2 uaktualnienia rocznie i nie musisz ich wykonywać w ścisłej kolejności – np. możesz przejść z wersji (N) bezpośrednio do wersji (N+2).

Nasze biblioteki klienta obsługują wszystkie dostępne wersje usługi, dzięki czemu możesz stopniowo uaktualniać, określając różne wersje używanych usług.

Rozkład jazdy

W tabeli poniżej znajdziesz konkretne daty wycofania i wyłączenia każdej dostępnej wersji oraz przewidywane daty premiery przyszłych wersji. Zachęcamy do jak najszybszego przejścia na najnowszą wersję po jej opublikowaniu. Data przybliżona oznacza, że wycofanie może nastąpić w dowolnym momencie danego miesiąca, a daty mogą ulec zmianie. Aby otrzymywać przypomnienia o wycofaniu wersji interfejsu API, zasubskrybuj bloga.

Wersja interfejsu API	Data premiery	Data wycofania	Przewodnik po uaktualnianiu
Wersje
v21	6 sierpnia 2025 r.	sierpień 2026 r. (przybliżona)	Uaktualnianie z wersji 20 do wersji 21
v22	15 października 2025 r.	październik 2026 r. (przybliżona)	Uaktualnianie z wersji 21 do wersji 22
v23	28 stycznia 2026 r.	luty 2027 r.	Uaktualnianie z wersji 22 do wersji 23
v23.1	25 lutego 2026 r.	luty 2027 r.	Uaktualnianie z wersji 23 do wersji 23.1
v23.2	25 marca 2026 r.	luty 2027 r.	Uaktualnianie z wersji 23.1 do wersji 23.2
v24	22 kwietnia 2026 r.	maj 2027 r.	Uaktualnianie z wersji 23.2 do wersji 24
v24.1	13 maja 2026 r.	maj 2027 r.	Uaktualnianie z wersji 24 do wersji 24.1
v24.2	24 czerwca 2026 r.	czerwiec 2027 r.	Uaktualnianie z wersji 24.1 do wersji 24.2
Nadchodzące wersje
v25	lipiec 2026 r.	sierpień 2027 r.
v25.1	sierpień 2026 r.	sierpień 2027 r.
v25.2	wrzesień 2026 r.	sierpień 2027 r.
v26	październik 2026 r.	listopad 2027 r.
v26.1*	listopad 2026 r.	listopad 2027 r.

* Wersja 26.1 jest oznaczona jako opcjonalna ze względu na nakładanie się z okresem świątecznym.

Wyświetlanie wersji używanych przez projekt

Listę metod i usług, z których Twój projekt korzystał ostatnio, możesz wyświetlić przy użyciu konsoli Google Cloud:

1. Otwórz Interfejsy API i usługi w konsoli Google Cloud.
2. W tabeli kliknij Interfejs Google Ads API.
3. Na podkarcie METRYKI powinny być widoczne Twoje ostatnie żądania na każdym wykresie. W tabeli Metody możesz sprawdzić, do których metod zostały wysłane żądania. Nazwa metody zawiera wersję interfejsu Google Ads API, usługę i nazwę metody, np. google.ads.googleads.v24.services.GoogleAdsService.Mutate.
4. (Opcjonalnie) Wybierz okres, który chcesz wyświetlić w przypadku żądań.

Różnice między wycofaniem a wyłączeniem

Hasło	Wycofanie	Wyłączenie
Definicja	Wycofana wersja to wersja, która nie jest najnowsza. Po opublikowaniu nowej wersji wszystkie poprzednie wersje zostaną oznaczone jako wycofane.	Wersja wyłączona nie może być już używana. Żądania wysyłane do tej wersji będą kończyć się niepowodzeniem w dniu wyłączenia lub po nim.
Implikacje	Możesz nadal używać wycofanych wersji, dopóki nie zostaną wyłączone, ale odniesienia do wycofanych wersji są mniej widoczne, aby pokazać że nie są już najnowsze. Zachęcamy do jak najszybszego przejścia na najnowszą wersję, aby korzystać z nowych funkcji.	Aby korzystać z interfejsu Google Ads API, musisz natychmiast przejść z wersji wyłączonych. Zdecydowanie zalecamy przejście na najnowszą wersję za pomocą przewodnika po uaktualnianiu.
Timing	Nową wersję publikujemy średnio co 3–4 miesiące, więc dana wersja zostanie wycofana po około 3–4 miesiącach.	Staramy się wyłączyć wersję rok po jej opublikowaniu.
API	Punkty końcowe interfejsu API dla wycofanych wersji nadal działają normalnie. Do naszych punktów końcowych interfejsu API możesz uzyskać dostęp za pomocą bibliotek klienta i REST. Nowe funkcje nie są jednak dodawane do wycofanych wersji.	Punkty końcowe interfejsu API dla wersji wyłączonych przestają działać po dacie wyłączenia. Jeśli spróbujesz uzyskać dostęp do punktów końcowych interfejsu API wersji wyłączonych, interfejs Google Ads API zwróci błąd.
Biblioteki klienta	Aby zapewnić kompaktowe biblioteki klienta, po dacie wycofania przestaniemy uwzględniać wycofane wersje interfejsu API w nowej wersji biblioteki klienta po dacie wycofania. Dzięki temu oszczędzasz miejsce podczas wdrażania naszych bibliotek klienta w swoich projektach.	Biblioteki klienta nie obsługują już wersji interfejsu API wyłączonych w żadnych nowych wersjach biblioteki klienta po dacie wyłączenia.
Pomoc	Zapewniamy regularną pomoc dotyczącą wycofanych wersji.	Wersje wyłączone nie będą obsługiwane po dacie wyłączenia.

Obsługiwane wersje biblioteki klienta

W tabeli pokazujemy, które biblioteki klienta działają z którymi wersjami interfejsu API.

Podana minimalna wersja biblioteki klienta jest wystarczająca w przypadku głównej wersji interfejsu Google Ads API (np. v24). Aby sprawdzić wymaganą wersję biblioteki klienta w przypadku wersji pomocniczych, zapoznaj się z połączonym dziennikiem zmian.

Wycofanie funkcji i zmiany

Ta strona koncentruje się na cyklu życia na poziomie wersji interfejsu API, ale wycofanie poszczególnych funkcji (np. wycofanie kampanii inteligentnych) i zmiany w przepływie pracy bez wersji (np. nowe wymagania dotyczące budżetu kampanii generujących popyt) są śledzone oddzielnie.

Aby sprawdzić nadchodzące cykle życia funkcji i zmiany w zachowaniu w aktywnych wersjach, zapoznaj się z przewodnikiem Wycofanie funkcji i zmiany bez wersji.