wycofanie i wycofanie

Wraz z udostępnieniem nowej wersji wycofana wersja otrzymuje datę wyłączenia, po której nie będzie już dostępna. Oto kilka innych wskazówek, 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 – możesz na przykład 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 udostępnienia przyszłych wersji. Zachęcamy do jak najszybszego uaktualnienia do najnowszej wersji po jej udostępnieniu. Data przybliżona oznacza, że wyłączenie może nastąpić w dowolnym momencie w danym miesiącu, a daty mogą ulec zmianie. Aby otrzymywać przypomnienia o wycofaniu wersji interfejsu API, zasubskrybuj bloga.

Wersja interfejsu API	Data premiery	Data wyłączenia	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
v25	22 lipca 2026 r.	sierpień 2027 r.	Uaktualnianie z wersji 24.2 do wersji 25
Nadchodzące wersje
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.v25.services.GoogleAdsService.Mutate.
4. (Opcjonalnie) Wybierz okres, w którym chcesz wyświetlić żądania.

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

Hasło	Wycofanie	Wyłączenie
Definicja	Wycofana wersja to wersja, która nie jest najnowsza. Gdy zostanie udostępniona nowa wersja, 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.
Implikacja	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 uaktualnienia do najnowszej wersji, aby korzystać z nowych funkcji.	Aby korzystać z interfejsu Google Ads API, musisz natychmiast przejść z wersji wyłączonych. Zdecydowanie zalecamy uaktualnienie do najnowszej wersji za pomocą przewodnika po uaktualnianiu.
Timing	Średnio co 3–4 miesiące udostępniamy nową wersję, więc dana wersja zostanie wycofana po około 3–4 miesiącach.	Staramy się wyłączyć wersję rok po jej udostępnieniu.
API	Punkty końcowe interfejsu API dla wycofanych wersji nadal działają normalnie. Do punktów końcowych interfejsu API możesz uzyskać dostęp za pomocą bibliotek klienta i interfejsu 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ędzisz 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 pokazano, które biblioteki klienta działają z którymi wersjami interfejsu API.

Podana minimalna wersja biblioteki klienta jest wystarczająca w przypadku głównego wydania interfejsu Google Ads API (np. v25). 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.