wycofanie i wycofanie

Po opublikowaniu nowej wersji wycofana wersja otrzymuje datę wyłączenia, 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 dostępne były maksymalnie 4 wersje główne.
  • Wersje główne są obsługiwane przez około 12 miesięcy, a wersje pomocnicze przez 10 miesięcy.
  • W ciągu roku możesz przeprowadzić maksymalnie 2 aktualizacje. Nie musisz też aktualizować wersji w ściśle określonej kolejności – możesz na przykład przejść z wersji N bezpośrednio do wersji N+2.
  • Okres, w którym wszystkie biblioteki klienta są dostępne w najnowszej wersji, a wersja, która ma zostać wycofana, jest dostępna, wynosi co najmniej 20 tygodni.

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

Rozkład

W tabeli poniżej znajdziesz daty wycofania i zakończenia obsługi poszczególnych dostępnych wersji oraz przewidywane daty premiery przyszłych wersji. Zachęcamy do jak najszybszego uaktualnienia do najnowszej wersji po jej wydaniu. Przybliżona data oznacza, że wycofanie może nastąpić w dowolnym momencie w danym miesiącu, a daty mogą ulec zmianie. Zasubskrybuj bloga, aby otrzymywać przypomnienia o wycofaniu wersji interfejsu API.

Wersja interfejsu APIData premieryData wycofaniaData wycofaniaPrzewodnik po uaktualnianiu
v216 sierpnia 2025 r.Przechodzenie z wersji 20 na wersję 21
v20.16 sierpnia 2025 r.Czerwiec 2026 r. (wstępnie)Przechodzenie z wersji 19 na wersję 20
v204 czerwca 2025 r.Czerwiec 2026 r. (wstępnie)Przechodzenie z wersji 19 na wersję 20
v19.26 sierpnia 2025 r. Luty 2026 r. (wstępnie)Przechodzenie z wersji 18 na wersję 19
v19.116 kwietnia 2025 r. Luty 2026 r. (wstępnie)Przechodzenie z wersji 18 na wersję 19
v1926 lutego 2025 r. Luty 2026 r. (wstępnie)Przechodzenie z wersji 18 na wersję 19
v1816 października 2024 r.Czerwiec 2025 r.20 sierpnia 2025 r.

Wyświetlanie wersji używanych w projekcie

Listę metod i usług, które były ostatnio wywoływane w Twoim projekcie, możesz wyświetlić w konsoli Google Cloud:

  1. W konsoli Google Cloud otwórz Interfejsy API i usługi.
  2. W tabeli kliknij Google Ads API.
  3. Na podzakładce METRICS (DANE) powinny być widoczne Twoje ostatnie prośby na każdym wykresie. W tabeli Metody możesz sprawdzić, do których metod zostały wysłane prośby. Nazwa metody zawiera wersję interfejsu Google Ads API, usługę i nazwę metody, np.google.ads.googleads.v21.services.GoogleAdsService.Mutate.
  4. (Opcjonalnie) Wybierz przedział czasowy, dla którego chcesz wyświetlić prośby.

Różnice między wycofaniem a zakończeniem działania

TerminWycofanieZachód słońca
Definicja Wycofana wersja to wersja, która nie jest najnowsza. Gdy nowa wersja zostanie udostępniona, wszystkie poprzednie wersje zostaną oznaczone jako wycofane. Wersji wyłączonej nie można już używać. Żądania wysyłane do tej wersji po dacie wyłączenia będą kończyć się niepowodzeniem.
Implikacja Możesz nadal używać wycofanych wersji, dopóki nie zostaną wycofane, ale odniesienia do nich są mniej widoczne, aby pokazać, że nie są już najnowszą wersją.

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ść na nowszą wersję.

Zdecydowanie zalecamy uaktualnienie do najnowszej wersji, korzystając z 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. Planujemy wyłączać wersje rok po ich wydaniu.
API Punkty końcowe interfejsu API w przypadku wycofanych wersji nadal działają jak zwykle.

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

 Punkty końcowe interfejsu API w wersjach wycofanych przestaną działać po datach wycofania. Jeśli spróbujesz uzyskać dostęp do punktów końcowych interfejsu API wycofanych wersji, 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. Dzięki temu oszczędzasz miejsce podczas włączania bibliotek klienta do projektów. Biblioteki klienta nie obsługują już wyłączonych wersji interfejsu API w żadnych nowych wersjach bibliotek klienta po datach wyłączenia.
Pomoc Zapewniamy regularną pomoc dotyczącą wycofanych wersji. Wersje wyłączone nie są już obsługiwane po dacie wyłączenia.

Obsługiwane wersje biblioteki klienta

Tabela pokazuje, które biblioteki klienta działają z którymi wersjami interfejsu API.

Java

Biblioteka klienta Java
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: -
v19 Min: 36.0.0
Max: -

C#

Biblioteka klienta dla .NET
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -
v19 Min: 22.1.0
Max: -
v18 Min: 21.1.0
Max: 23.0.0

PHP

Biblioteka klienta dla PHP
v21 Min: 31.0.0
Max: -
v20 Min: 28.0.0
Max: -
v19 Min: 26.1.0
Max: -
v18 Min: 25.0.0
Max: 30.0.0

Python

Biblioteka klienta Python
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -
v19 Min: 25.2.0
Max: -

Ruby

Biblioteka klienta Ruby
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -
v19 Min: 32.0.0
Max: -
v18 Min: 31.0.0
Max: -

Perl

Biblioteka klienta Perl
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -
v19 Min: 26.0.0
Max: -
v18 Min: 25.0.1
Max: 28.0.0

Wycofanie funkcji

Regularnie sprawdzaj blog dla programistów Google Ads, aby jako pierwszy dowiadywać się o wycofywaniu funkcji.

W tabeli poniżej znajdziesz listę konkretnych funkcji, które planujemy wycofać z interfejsu Google Ads API. Więcej informacji o każdym wycofaniu znajdziesz w linkowanych postach na blogu.

Funkcja Opis Data wejścia w życie Uwagi dodatkowe
Środowisko konwersji ma wpływ na skuteczność kampanii promujących aplikacje 30 września 2025 r. zaczniemy stopniowo wprowadzać zmianę w modelach ustalania stawek, która umożliwi im korzystanie z danych o środowisku konwersji zawartych w importowanych konwersjach w celu optymalizacji skuteczności kampanii. 3 października 2025 r. Więcej informacji znajdziesz w poście na naszym blogu.
Konwersje mogą zawierać wartości `gclid` i `gbraid`. Od 3 października 2025 r. importowane konwersje nie będą już zwracać błędu `VALUE_MUST_BE_UNSET`, jeśli ustawione są zarówno pola `gclid`, jak i `gbraid`. 3 października 2025 r. Więcej informacji znajdziesz w poście na naszym blogu.