Wycofanie i wycofanie

Wraz z wydaniem nowej wersji wycofana wersja otrzymuje datę wycofania, po której nie będzie ona już dostępna. Oto kilka innych wskazówek, o których warto pamiętać:

• W danym momencie dostępne są maksymalnie 3 wersje główne.
• Główne wersje mają okres ważności przez około 12 miesięcy, a wersje mniejsze: do 10 miesięcy.
• Musisz wykonać maksymalnie 2 uaktualnienia rocznie. Nie musisz też przeprowadzać uaktualnień w ścisłej kolejności sekwencyjnej. Możesz na przykład przejść z wersji (N) bezpośrednio na wersję (N+2).
• Okres pokrywania się daty udostępnienia wszystkich bibliotek klienta dla najnowszej wersji do daty wycofania wersji wynosi co najmniej 20 tygodni.

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

Rozkład

W tabeli poniżej znajdziesz konkretne daty wycofania i wycofania każdej dostępnej wersji oraz przewidywane daty wydania w przyszłości. Zachęcamy do uaktualnienia do najnowszej wersji jak najszybciej po jej opublikowaniu.

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.
17.1	7 sierpnia 2024 r.	Wrzesień/październik 2024 r.	4 czerwca 2025 r.	Uaktualnienie z wersji 17 do 18
v17	5 czerwca 2024 r.	wrzesień/październik 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 DANE zobaczysz swoje ostatnie żądania przedstawione 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.v18.services.GoogleAdsService.Mutate.
4. (Opcjonalnie) Wybierz przedział czasowy, w którym chcesz wyświetlić swoje żądania.

Różnice między wycofaniem a wycofaniem

Termin	Wycofanie	Zachó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.
Konsekwencje	Możesz nadal 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 upływie roku od ich opublikowania.
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 dla wycofanych wersji przestaną działać po datach wycofania. Jeśli spróbujesz uzyskać dostęp do punktów końcowych interfejsu API w wycofanych wersjach, interfejs Google Ads API zgłosi 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.

Wycofanie funkcji

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

W tabeli poniżej znajdziesz informacje o wycofaniu konkretnych funkcji, które są obecnie zaplanowane w interfejsie Google Ads API. Więcej informacji o każdym wycofaniu znajdziesz w linkach na blogu.

Funkcja	Opis	Data wejścia w życie	Uwagi dodatkowe
Nadchodzące zmiany 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.	Styczeń 2025 r.	Gdy wycofamy wersję 16, wszystkie żądania GoogleAdsService.Search będą zakładać stały rozmiar strony: 10 000 wierszy.
Strategia ustalania stawek Ulepszony 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.	Żądania ustawienia pola enhanced_cpc_enabled na TRUE w strategii ustalania stawek będą powodować błąd BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED. Dotychczasowe 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).