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:
- W konsoli Google Cloud otwórz panel Interfejsy API i usługi.
- W tabeli kliknij Google Ads API.
- 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. - (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.
Java
Interfejs Google Ads API |
Biblioteka klienta dla języka Java |
v18 |
Min: 34.0.0Max: - |
v17 |
Min: 32.0.0Max: – |
v16 |
Min: 30.0.0Max: - |
C#
Interfejs Google Ads API |
Biblioteka klienta dla .NET |
v18 |
Min: 21.1.0Max: – |
v17 |
Min: 20.1.0Max: – |
v16 |
Min: 18.1.0Max: - |
PHP
Interfejs Google Ads API |
Biblioteka klienta dla PHP |
v18 |
Min: 25.0.0Max: – |
v17 |
Min: 23.1.0Max: - |
v16 |
Min: 22.1.0Max: – |
Python
Interfejs Google Ads API |
Biblioteka klienta dla Pythona |
v18 |
Min: 25.1.0Max: – |
v17 |
Min: 24.1.0Max: – |
v16 |
Min: 23.1.0Max: - |
Ruby
Interfejs Google Ads API |
Biblioteka klienta do języka Ruby |
v18 |
Min: 31.0.0Max: - |
v17 |
Min: 29.0.0Max: – |
v16 |
Min: 27.0.0Max: – |
Perl
Interfejs Google Ads API |
Biblioteka klienta dla Perla |
v18 |
Min: 25.0.0Max: - |
v17 |
Min: 23.0.0Max: – |
v16 |
Min: 21.0.0Max: - |
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).
|