Po udostępnieniu nowej wersji wycofana wersja otrzymuje datę wyłączenia, po której nie będzie już dostępna. Oto kilka innych wskazówek, o których warto pamiętać:
- Staramy się, aby w danym momencie było dostępnych nie więcej niż 5 wersji głównych.
- Wersje główne są obsługiwane przez około 12 miesięcy, a wersje podrzędne przez 10 miesięcy.
- Będziesz musiał przeprowadzić maksymalnie 2 uaktualnienia rocznie i nie musisz uaktualniać w ścisłej kolejności – możesz na przykład uaktualnić wersję (N) bezpośrednio do wersji (N+2).
Nasze biblioteki klienta obsługują wszystkie dostępne wersje usługi, dzięki czemu możesz stopniowo uaktualniać, określając różne wersje używanych usług.
Rozkład
W tabeli poniżej znajdziesz daty wycofania i zakończenia obsługi poszczególnych dostępnych wersji oraz przewidywane daty wydania przyszłych wersji. Zachęcamy do jak najszybszego uaktualnienia do najnowszej wersji po jej opublikowaniu. Przybliżona data oznacza, że wycofanie może nastąpić w dowolnym momencie w danym miesiącu, a daty mogą ulec zmianie. Zasubskrybuj bloga, aby otrzymywać przypomnienia o ogłoszeniach dotyczących wycofania wersji interfejsu API.
| Wersja interfejsu API | Data premiery | Data wycofania | Zmiany powodujące niezgodność i uaktualnienie | Funkcje i aktualizacje | Tabela różnic proto |
|---|---|---|---|---|---|
| Wersje do publikacji | |||||
| v23 | 28 stycznia 2026 r. | Luty 2027 r. | Zmiany powodujące niezgodność w wersji 23 (przewodnik po uaktualnieniu) | Funkcje i aktualizacje w wersji 23 | Różnice między wersjami 22 i 23 |
| v23.1 | 25 lutego 2026 r. | Luty 2027 r. | Brak (wersja podrzędna) | Funkcje i aktualizacje w wersji 23.1 | Różnice między wersjami 22 i 23 |
| v23.2 | 25 marca 2026 r. | Luty 2027 r. | Brak (wersja podrzędna) | Funkcje i aktualizacje w wersji 23.2 | Różnice między wersjami 22 i 23 |
| v23.3 | 24 czerwca 2026 r. | Luty 2027 r. | Brak (wersja podrzędna) | Funkcje i aktualizacje w wersji 23.3 | Różnice między wersjami 22 i 23 |
| v24 | 22 kwietnia 2026 r. | Maj 2027 r. | Zmiany powodujące niezgodność w wersji 24 (przewodnik po uaktualnieniu) | Funkcje i aktualizacje w wersji 24 | Różnice między proto w wersji 23 i 24 |
| v24.1 | 13 maja 2026 r. | Maj 2027 r. | Brak (wersja podrzędna) | Funkcje i aktualizacje w wersji 24.1 | Różnice między proto w wersji 23 i 24 |
| v24.2 | 24 czerwca 2026 r. | czerwcu 2027 r. | Brak (wersja podrzędna) | Funkcje i aktualizacje w wersji 24.2 | Różnice między proto w wersji 23 i 24 |
| v25 | 22 lipca 2026 r. | Sierpień 2027 r. | Zmiany powodujące niezgodność w wersji 25 (przewodnik po uaktualnieniu) | Funkcje i aktualizacje w wersji 25 | Różnice między protokołami w wersjach 24 i 25 |
| v25.1 | 19 sierpnia 2026 r. | Sierpień 2027 r. | Brak (wersja podrzędna) | Funkcje i aktualizacje w wersji 25.1 | Różnice między protokołami w wersjach 24 i 25 |
| v25.2 | 23 września 2026 r. | Sierpień 2027 r. | Brak (wersja podrzędna) | Funkcje i aktualizacje w wersji 25.2 | Różnice między protokołami w wersjach 24 i 25 |
| v26 (najnowsza) | 14 października 2026 r. | Listopad 2027 r. | Zmiany powodujące niezgodność w wersji 26 (przewodnik po uaktualnieniu) | Funkcje i aktualizacje w wersji 26 | Różnice między plikami proto w wersjach 25 i 26 |
| v26.1 | 28 października 2026 r. | Listopad 2027 r. | Brak (wersja podrzędna) | Funkcje i aktualizacje w wersji 26.1 | Różnice między plikami proto w wersjach 25 i 26 |
| Nadchodzące wersje | |||||
| v26.2 | Listopad 2026 r. | Listopad 2027 r. | |||
| v26.3* | Grudzień 2026 r. | Listopad 2027 r. | |||
| v27 | Styczeń 2027 r. | Luty 2028 r. | |||
| v27.1 | Luty 2027 r. | Luty 2028 r. | |||
| v27.2 | Luty 2027 r. | Luty 2028 r. | |||
| v27.3 | Marzec 2027 r. | Luty 2028 r. | |||
| v27.4 | Marzec 2027 r. | Luty 2028 r. | |||
| v28 | Kwiecień 2027 r. | maju 2028 r. | |||
| v28.1 | Kwiecień 2027 r. | maju 2028 r. | |||
| v28.2 | Maj 2027 r. | maju 2028 r. | |||
| v28.3 | Maj 2027 r. | maju 2028 r. | |||
| v28.4 | czerwcu 2027 r. | maju 2028 r. | |||
| v28.5 | czerwcu 2027 r. | maju 2028 r. | |||
| v29 | lipcu 2027 r. | Sierpień 2028 r. | |||
| v29.1 | lipcu 2027 r. | Sierpień 2028 r. | |||
| v29.2 | Sierpień 2027 r. | Sierpień 2028 r. | |||
| v29.3 | Sierpień 2027 r. | Sierpień 2028 r. | |||
| v29.4 | Wrzesień 2027 r. | Sierpień 2028 r. | |||
| v29.5 | Wrzesień 2027 r. | Sierpień 2028 r. | |||
| v30 | październiku 2027 r. | Listopad 2028 r. | |||
| v30.1 | październiku 2027 r. | Listopad 2028 r. | |||
| v30.2 | Listopad 2027 r. | Listopad 2028 r. | |||
| v30.3* | Grudzień 2027 r. | Listopad 2028 r. | |||
* Wersje 26.3 i 30.3 są oznaczone jako opcjonalne ze względu na pokrywanie się z sezonem świątecznym.
Wyświetlanie wersji używanych w projekcie
Listę metod i usług, które zostały ostatnio wywołane przez Twój projekt, możesz wyświetlić w konsoli Google Cloud:
- W konsoli Google Cloud otwórz Interfejsy API i usługi.
- W tabeli kliknij interfejs Google Ads API.
- Na podkarcie WSKAŹNIKI powinny być widoczne ostatnie żądania naniesione na każdy wykres. 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.v26.services.GoogleAdsService.Mutate. - (Opcjonalnie) Wybierz przedział czasowy, który chcesz wyświetlić w przypadku próśb.
Różnice między wycofaniem a zakończeniem obsługi
| Okres obowiązywania | Wycofanie | Zachód słońca |
|---|---|---|
| Definicja | Wycofana wersja to wersja, która nie jest najnowsza. Po udostępnieniu nowej wersji wszystkie poprzednie wersje zostaną oznaczone jako wycofane. | Wersji wycofanej nie można już używać. Żądania wysyłane do tej wersji w dniu wycofania lub później będą kończyć się niepowodzeniem. |
| Konsekwencje | Możesz nadal używać wycofanych wersji, dopóki nie zostaną wyłączone, ale odwołania do wycofanych wersji są odznaczone, aby pokazać, że nie są już najnowszą wersją.
Zachęcamy do jak najszybszego uaktualnienia do najnowszej wersji, aby móc korzystać z nowych funkcji. |
Aby korzystać z interfejsu Google Ads API, musisz natychmiast przejść na nowszą wersję.
Zdecydowanie zalecamy uaktualnienie do najnowszej wersji zgodnie z przewodnikiem po uaktualnieniu. |
| Timing | Nową wersję publikujemy średnio co 3–4 miesiące, więc dana wersja zostanie wycofana po około 3–4 miesiącach. | Planujemy wycofywać wersje po roku od ich wydania. |
| API | Punkty końcowe interfejsu API w wycofanych wersjach nadal działają jak zwykle.
Dostęp do naszych punktów końcowych interfejsu API możesz uzyskać za pomocą naszych bibliotek klienta i interfejsu REST. Jednak nowe funkcje nie są dodawane do wycofanych wersji. |
Punkty końcowe interfejsu API w wycofanych wersjach przestają 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 zwróci błąd. |
| Biblioteki klienta | Aby zapewnić kompaktowe biblioteki klienta, po dacie wycofania przestaniemy uwzględniać wycofane wersje interfejsu API w nowej wersji biblioteki klienta. Dzięki temu oszczędzasz miejsce, gdy dołączasz nasze biblioteki klienta do swoich projektów. | Biblioteki klienta nie będą już obsługiwać wycofanych wersji interfejsu API w żadnych nowych wersjach bibliotek klienta po datach wycofania. |
| Pomoc | Zapewniamy regularną pomoc w przypadku wycofanych wersji. | Wersje wyłączone nie będą obsługiwane po dacie wyłączenia. |
Obsługiwane wersje biblioteki klienta
Tabela pokazuje, które biblioteki klienta działają z którymi wersjami interfejsu API.
Podana minimalna wersja biblioteki klienta jest wystarczająca dla głównej wersji interfejsu Google Ads API (np. v26). Aby sprawdzić wymaganą wersję biblioteki klienta w przypadku wersji podrzędnych, zapoznaj się z połączoną listą zmian.
Java
Interfejs Google Ads API |
Biblioteka klienta dla Javy |
v26 |
Min: 48.0.0Max: – |
v25 |
Min: 44.0.0Max: – |
v24 |
Min: 43.0.0Max: – |
v23 |
Min: 42.0.0Max: – |
C#
Interfejs Google Ads API |
Biblioteka klienta dla .NET |
v26 |
Min: 27.5.0Max: – |
v25 |
Min: 26.1.0Max: – |
v24 |
Min: 25.3.0Max: – |
v23 |
Min: 25.1.0Max: – |
PHP
Interfejs Google Ads API |
Biblioteka klienta dla języka PHP |
v26 |
Min: 35.2.0Max: – |
v25 |
Min: 33.6.0Max: – |
v24 |
Min: 33.3.0Max: – |
v23 |
Min: 32.2.0Max: – |
Python
Interfejs Google Ads API |
Biblioteka klienta dla Pythona |
v26 |
Min: 34.0.0Max: – |
v25 |
Min: 31.2.0Max: – |
v24 |
Min: 30.1.0Max: – |
v23 |
Min: 29.2.0Max: – |
Ruby
Interfejs Google Ads API |
Biblioteka klienta dla Ruby |
v26 |
Min: 46.0.0Max: – |
v25 |
Min: 43.0.0Max: – |
v24 |
Min: 40.0.0Max: – |
v23 |
Min: 38.0.0Max: – |
Perl
Interfejs Google Ads API |
Biblioteka klienta dla Perla |
v26 |
Min: 36.0.0Max: – |
v25 |
Min: 33.0.0Max: – |
v24 |
Min: 32.0.0Max: – |
v23 |
Min: 31.0.0Max: – |
Wycofanie i zmiany funkcji
Ta strona skupia się na cyklach życia na poziomie wersji interfejsu API, ale wycofanie poszczególnych funkcji (np. kampanii inteligentnych) i zmiany w przepływie pracy bez wersji (np. nowe wymagania dotyczące budżetu kampanii generujących popyt) są śledzone osobno.
Aby sprawdzić nadchodzące cykle życia funkcji i zmiany zachowania w aktywnych wersjach, zapoznaj się z przewodnikiem Wycofanie funkcji i zmiany bez wersji.