Wycofanie i wycofanie

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

  • W danym momencie dostępne są 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 uaktualnienia. Nie musisz ich przeprowadzać w ściśle określonej kolejności. Możesz na przykład przejść z wersji N bezpośrednio do wersji N+2.
  • Przedział czasowy między datą wydania wszystkich bibliotek klienta dla najnowszej wersji a wersją, 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 po jej wydaniu.

Wersja interfejsu API Data premiery Data wycofania Data wycofania Przewodnik po uaktualnianiu
v18 16 października 2024 r. Luty 2025 r. 24 września 2025 r.
v17.1 7 sierpnia 2024 r. 16 października 2024 r. 4 czerwca 2025 r. Przechodzenie z wersji 17 na wersję 18
v17 5 czerwca 2024 r. 16 października 2024 r. 4 czerwca 2025 r. Przechodzenie z wersji 17 na wersję 18
v16.1 24 kwietnia 2024 r. 5 czerwca 2024 r. 5 lutego 2025 r. Przejście z wersji 16 na wersję 17
v16 21 lutego 2024 r. 5 czerwca 2024 r. 5 lutego 2025 r. Przejście z wersji 16 na wersję 17

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 METRICS 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.v18.services.GoogleAdsService.Mutate.
  4. (Opcjonalnie) Wybierz przedział czasowy, w którym chcesz wyświetlić swoje żądania.

Różnice między wycofaniem a wycofaniem z użycia

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 korzystać z interfejsu Google Ads API, musisz natychmiast zaktualizować wersje wycofywane.

Zdecydowanie zalecamy przejście na najnowszą wersję, korzystając z tego przewodnika.
Czas Średnio nową wersję publikujemy 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 Google Ads API 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ą starszych wersji interfejsu API po dacie wyłączenia.
Pomoc Zapewniamy regularną pomoc w przypadku wycofanych wersji. 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
v18 Min: 34.0.0
Max: -
v17 Min: 32.0.0
Max: -
v16 Min: 30.0.0
Max: -

C#

Biblioteka klienta dla .NET
v18 Min: 21.1.0
Max: -
v17 Min: 20.1.0
Max: -
v16 Min: 18.1.0
Max: -

PHP

Biblioteka klienta dla PHP
v18 Min: 25.0.0
Max: -
v17 Min: 23.1.0
Max: -
v16 Min: 22.1.0
Max: -

Python

Biblioteka klienta dla Pythona
v18 Min: 25.1.0
Max: -
v17 Min: 24.1.0
Max: -
v16 Min: 23.1.0
Max: -

Ruby

Biblioteka klienta do języka Ruby
v18 Min: 31.0.0
Max: -
v17 Min: 29.0.0
Max: -
v16 Min: 27.0.0
Max: -

Perl

Biblioteka klienta dla Perla
v18 Min: 25.0.0
Max: -
v17 Min: 23.0.0
Max: -
v16 Min: 21.0.0
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
Nadchodzące zmiany dotyczące rozmiaru strony w interfejsie Google Ads API Po wycofaniu wersji 16 nie będzie już można ustawiać pola page_size podczas wysyłania żądań GoogleAdsService.Search. Luty 2025 r. Gdy wycofamy wersję 16, wszystkie żądania GoogleAdsService.Search będą zakładać stały rozmiar strony: 10 000 wierszy.
Strategia Ulepszone określanie stawek CPC Interfejs Google Ads API nie obsługuje już ustawiania eCPC jako strategii ustalania stawek w kampaniach w sieci wyszukiwania i sieci reklamowej. Październik 2024 r. Prośby o ustawienie pola enhanced_cpc_enabled na TRUE w strategii ustalania stawek spowodują błąd BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED. Istniejące kampanie korzystające ze strategii ustalania stawek eCPC będą działać do 15 marca 2025 r. Po tym dniu zostaną one automatycznie przeniesione na samodzielnie ustawiany koszt kliknięcia (CPC).