wycofanie i wycofanie

Wraz z wydaniem nowej wersji starszej wersji nadajemy datę wyłączenia, po której nie będzie ona już dostępna. Oto kilka dodatkowych wskazówek, o których warto pamiętać:

  • Staramy się, aby w danym momencie dostępne były maksymalnie 3 wersje główne.
  • Wersje główne są dostępne 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 przechodzić od wersji do wersji w ściśle określonej kolejności. Możesz na przykład przejść z wersji N bezpośrednio do wersji N+2.
  • Pokrywanie się daty wydania wszystkich bibliotek klienta dla najnowszej wersji i wersji, która zostanie wycofana, wynosi co najmniej 20 tygodni.

Nasze biblioteki klienta obsługują wszystkie dostępne wersje usługi, dzięki czemu możesz stopniowo przechodzić na nowsze wersje, podając różne wersje używanych usług.

Rozkład

W tabeli poniżej znajdziesz daty wycofania i zaprzestania obsługi poszczególnych dostępnych wersji oraz przewidywane daty premiery przyszłych wersji. Zachęcamy do jak najszybszego uaktualnienia do najnowszej wersji.

Wersja interfejsu APIData premieryData wycofaniaData wycofaniaPrzewodnik po uaktualnianiu
v204 czerwca 2025 r.Przechodzenie z wersji 19 na wersję 20
v19.116 kwietnia 2025 r.
v1926 lutego 2025 r. Przechodzenie z wersji 18 na 19
v1816 października 2024 r.Czerwiec 2025 r.Sierpień 2025 r.Przechodzenie z wersji 17 na wersję 18

Wyświetlanie wersji używanych przez projekt

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

  1. W konsoli Google Cloud otwórz panel Interfejsy API i usługi.
  2. W tabeli kliknij Google Ads API.
  3. Na karcie DANE zobaczysz swoje ostatnie żądania przedstawione na każdym wykresie. W tabeli Metody możesz sprawdzić, do których metod wysłano prośby. Nazwa metody zawiera wersję interfejsu Google Ads API, usługę i nazwę metody, np. google.ads.googleads.v20.services.GoogleAdsService.Mutate.
  4. (Opcjonalnie) Wybierz przedział czasowy, w którym chcesz wyświetlić swoje żądania.

Różnice między wycofaniem a wycofaniem wsparcia

TerminWycofanieZachód słońca
Definicja Wersja wycofana to wersja, która nie jest najnowsza. Po wydaniu nowej wersji wszystkie poprzednie wersje zostaną oznaczone jako wycofane. Nie można już używać wersji wycofanej. Żądania wysłane do tej wersji nie będą realizowane w dniu wyłączenia ani po nim.
Wnioski Nadal możesz używać przestarzałych wersji do momentu ich wycofania, ale odniesienia do przestarzałych wersji nie są już wyróżnione, aby pokazać, że nie są one już najnowszymi wersjami.

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

 Aby móc korzystać z interfejsu Google Ads API, musisz natychmiast zaktualizować wersje wycofywane.

Zdecydowanie zalecamy przejście na najnowszą wersję za pomocą tego przewodnika.
Czas Nową wersję publikujemy średnio co 3–4 miesiące, więc dana wersja przestanie być obsługiwana po około 3–4 miesięcach. Staramy się wycofywać wersje po 1 roku od ich wydania.
API Punkty końcowe interfejsu API starszych wersji nadal działają normalnie.

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

 Punkty końcowe interfejsu API wycofanych wersji przestaną działać po dacie wyłączenia. Jeśli spróbujesz uzyskać dostęp do punktów końcowych interfejsu API wersji wycofanych, interfejs API Google Ads wyświetli błąd.
Biblioteki klienta Aby zapewnić kompaktowe biblioteki klienta, zaprzestaniemy uwzględniać wycofane wersje interfejsu API w nowej wersji biblioteki klienta po dacie wycofania. Dzięki temu oszczędzasz miejsce podczas stosowania w projektach naszych bibliotek klientów. Biblioteki klienta nie obsługują wersji interfejsu API wyłączonych po dacie wyłączenia w żadnych nowych wersjach bibliotek klienta.
Pomoc W przypadku wycofanych wersji zapewniamy regularną pomoc. Po dacie wyłączenia nie będą one już obsługiwane.

Obsługiwane wersje biblioteki klienta

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

Java

Biblioteka klienta dla Javy
v20 Min: 38.0.0
Max: -
v19 Min: 36.0.0
Max: -
v18 Min: 34.0.0
Max: -
v17 Min: 31.0.0
Max: 36.1.0

C#

Biblioteka klienta dla .NET
v20 Min: 23.0.0
Max: -
v19 Min: 22.1.0
Max: -
v18 Min: 21.1.0
Max: -
v17 Min: 20.1.0
Max: 22.2.0

PHP

Biblioteka klienta dla PHP
v20 Min: 28.0.0
Max: -
v19 Min: 26.1.0
Max: -
v18 Min: 25.0.0
Max: -
v17 Min: 23.1.0
Max: 27.2.0

Python

Biblioteka klienta dla Pythona
v20 Min: 27.0.0
Max: -
v19 Min: 25.2.0
Max: -
v18 Min: 25.1.0
Max: -
v17 Min: 24.1.0
Max: 26.1.0

Ruby

Biblioteka klienta do języka Ruby
v20 Min: 34.0.0
Max: -
v19 Min: 32.0.0
Max: -
v18 Min: 31.0.0
Max: -

Perl

Biblioteka klienta dla Perla
v20 Min: 27.0.0
Max: -
v19 Min: 26.0.0
Max: -
v18 Min: 25.0.1
Max: -

Wycofanie funkcji

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

W tabeli poniżej znajdziesz listę funkcji interfejsu Google Ads API, które zostaną wycofane. Więcej informacji o każdej wycofywanej funkcji znajdziesz w powiązanych postach na blogu.

Funkcja Opis Data wejścia w życie Uwagi dodatkowe
Nowe komunikaty o błędach dotyczące nieprawidłowych tokenów dewelopera Od 28 kwietnia 2025 r. nieprawidłowy token dewelopera będzie zwracany: DEVELOPER_TOKEN_INVALID w przypadku wersji 19.1 i późniejszych oraz DEVELOPER_TOKEN_NOT_APPROVED w przypadku wersji starszych niż 19.1. Nieprawidłowe tokeny dewelopera zwracane wcześniej przez OAUTH_TOKEN_HEADER_INVALID, które nadal będą używane w przypadku nieprawidłowych nagłówków OAuth. 28 kwietnia 2025 r. Ta zmiana nie wpłynie na osoby, które mają już działające wywołania interfejsu API.