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ć:
- 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.
- 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, określają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:
- 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 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. - (Opcjonalnie) Wybierz przedział czasowy, w którym chcesz wyświetlić swoje żądania.
Różnice między wycofaniem a wycofaniem wsparcia
| 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. |
| Wnioski | 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 móc korzystać z interfejsu Google Ads API, musisz natychmiast zaktualizować wersje wycofywane.
Zdecydowanie zalecamy przejście na najnowszą wersję, korzystając z 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 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 | 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
Interfejs Google Ads API |
Biblioteka klienta dla Javy |
v18 |
Min: 34.0.0Max: - |
v17 |
Min: 32.0.0Max: - |
v16 |
Min: 30.0.0Max: 34.0.0 |
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.1Max: - |
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 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 |
|---|---|---|---|
| Aktualizacja raportu „Statystyki wyszukiwanych haseł” w interfejsie Google Ads API i w skryptach Google Ads od 3 marca 2025 r. | Od 3 marca 2025 r. interfejs Google Ads API i skrypty Google Ads w raportach statystyk wyszukiwanych haseł będą zwracać wszystkie podkategorie wyszukiwań jako puste. W interfejsie Google Ads to pole zostało już usunięte, a w interfejsie API ta zmiana jest wprowadzana stopniowo, aby zapewnić spójność w Google Ads. | 3 marca 2025 r. | Od 3 marca 2025 r. wszystkie wartości w kolumnie
segments.search_subcategory będą puste. Jeśli w raportach
campaign_search_term_insight lub
customer_search_term_insight wysyłasz zapytanie o element segments.search_subcategory, sprawdź, czy Twój kod może obsługiwać pustą wartość w elemencie segments.search_subcategory.
Pusty ciąg znaków jest już domyślnym ciągiem znaków, więc Twój kod powinien już to obsługiwać. Zalecamy usunięcie z zapytania znaku segments.search_subcategory.
|
| 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. |
| Aktualizacja dotycząca wygaśnięcia członkostwa w programie kierowania na listę klientów | Od 7 kwietnia 2025 r. w polu UserList.membership_life_span nie będzie można już używać wartości wyższych niż 540. |
7 kwietnia 2025 r. | W okresie od 7 do 15 kwietnia 2025 r. stopniowo wprowadzimy zmianę w polu UserList.membership_life_span. Żądania ustawienia pola na wartość większą niż 540 zwracają błąd RangeError.TOO_HIGH. Każda istniejąca lista użytkowników z wartością pola większą niż 540 zostanie automatycznie przeniesiona, aby okres członkostwa wynosił maksymalnie 540 dni. Więcej informacji znajdziesz w artykule Aktualizacja dotycząca wygaśnięcia członkostwa w programie kierowania na listę klientów.
|