Po udostępnieniu nowej wersji wycofana wersja otrzymuje datę wyłączenia, po której nie będzie już dostępna. Oto dodatkowe wskazówki, o których warto pamiętać:
- Staramy się, aby w danym momencie dostępnych było maksymalnie 5 wersji głównych.
- Wersje główne są obsługiwane przez około 12 miesięcy, a wersje podrzędne – przez 10 miesięcy.
- W ciągu roku musisz przeprowadzić maksymalnie 2 uaktualnienia. Nie musisz też uaktualniać wersji w ściśle określonej 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, więc możesz stopniowo uaktualniać wersje, 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 premiery przyszłych wersji. Zachęcamy do uaktualnienia do najnowszej wersji jak najszybciej po jej wydaniu. 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 wycofaniu wersji interfejsu API.
| Wersja interfejsu API | Data premiery | Data wycofania | Przewodnik po uaktualnianiu |
|---|---|---|---|
| Wersje | |||
| v22 | 15 października 2025 r. | Październik 2026 r. (wstępnie) | Przejście z wersji 21 na wersję 22 |
| v23 | 28 stycznia 2026 r. | Luty 2027 r. | Przechodzenie z wersji 22 na wersję 23 |
| v23.1 | 25 lutego 2026 r. | Luty 2027 r. | Uaktualnianie z wersji 23 do wersji 23.1 |
| v23.2 | 25 marca 2026 r. | Luty 2027 r. | Uaktualnianie z wersji 23.1 do wersji 23.2 |
| v24 | 22 kwietnia 2026 r. | Maj 2027 r. | Przechodzenie z wersji 23.2 na wersję 24 |
| v24.1 | 13 maja 2026 r. | Maj 2027 r. | Przechodzenie z wersji 24 na wersję 24.1 |
| v24.2 | 24 czerwca 2026 r. | czerwcu 2027 r. | Przechodzenie z wersji 24.1 na wersję 24.2 |
| v25 | 22 lipca 2026 r. | Sierpień 2027 r. | Przechodzenie z wersji 24.2 na wersję 25 |
| v25.1 | 19 sierpnia 2026 r. | Sierpień 2027 r. | Przejście z wersji 25 na wersję 25.1 |
| v25.2 | 23 września 2026 r. | Sierpień 2027 r. | Przechodzenie z wersji 25.1 na wersję 25.2 |
| Nadchodzące wersje | |||
| v26 | październiku 2026 r. | Listopad 2027 r. | |
| wersja 26.1* | Listopad 2026 r. | Listopad 2027 r. | |
* Wersja 26.1 jest oznaczona jako opcjonalna ze względu na nakładanie się z okresem świątecznym.
Wyświetlanie wersji używanych w projekcie
Listę metod i usług, które były ostatnio wywoływane w Twoim projekcie, 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 METRICS (WSKAŹNIKI) powinny być widoczne Twoje ostatnie prośby 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.v25.services.GoogleAdsService.Mutate. - (Opcjonalnie) Wybierz okres, w którym chcesz wyświetlać prośby.
Różnice między wycofaniem a zakończeniem
| Okres obowiązywania | Wycofanie | Zachód słońca |
|---|---|---|
| Definicja | Wersja wycofana to wersja, która nie jest najnowsza. Gdy pojawi się nowa wersja, wszystkie poprzednie wersje zostaną oznaczone jako przestarzałe. | Wersji wycofanej nie można już używać. Żądania wysyłane do tej wersji będą zwracać błąd w dacie wycofania lub po niej. |
| Implikacja | Możesz nadal używać wycofanych wersji, dopóki nie zostaną wycofane, ale odniesienia do nich są mniej widoczne, aby pokazać, że nie są już najnowszą wersją.
Zachęcamy do jak najszybszego przejścia na najnowszą wersję, aby korzystać z nowych funkcji. |
Aby korzystać z interfejsu Google Ads API, musisz natychmiast przejść z wersji wycofanych z użycia.
Zdecydowanie zalecamy przejście na najnowszą wersję zgodnie z przewodnikiem po uaktualnianiu. |
| Timing | Nową wersję publikujemy średnio co 3–4 miesiące, więc podana wersja zostanie wycofana po około 3–4 miesiącach. | Planujemy wycofać wersję rok po jej wydaniu. |
| API | Punkty końcowe interfejsu API w przypadku wycofanych wersji nadal działają jak zwykle.
Do naszych punktów końcowych interfejsu API możesz uzyskać dostęp za pomocą bibliotek klienta i interfejsu REST. Nowe funkcje nie są jednak dodawane do wycofanych wersji. |
Punkty końcowe interfejsu API w wersjach wycofanych przestaną działać po datach wycofania. Jeśli spróbujesz uzyskać dostęp do punktów końcowych interfejsu API wycofanych wersji, 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 podczas włączania bibliotek klienta do projektów. | Biblioteki klienta nie obsługują już wyłączonych wersji interfejsu API w żadnych nowych wersjach bibliotek klienta po datach wyłączenia. |
| Pomoc | Zapewniamy regularną pomoc dotyczącą wycofanych wersji. | Wersje wyłączone nie będą już 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 w przypadku głównej wersji interfejsu Google Ads API (np. v25). Aby sprawdzić wymaganą wersję biblioteki klienta w przypadku wersji podrzędnych, zapoznaj się z połączonym dziennikiem zmian.
Java
Interfejs Google Ads API |
Biblioteka klienta Java |
v25 |
Min: 44.0.0Max: - |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
v22 |
Min: 41.0.0Max: - |
C#
Interfejs Google Ads API |
Biblioteka klienta dla .NET |
v25 |
Min: 26.1.0Max: - |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
v22 |
Min: 24.1.0Max: - |
PHP
Interfejs Google Ads API |
Biblioteka klienta dla PHP |
v25 |
Min: 33.6.0Max: - |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: - |
v22 |
Min: 31.0.0Max: - |
Python
Interfejs Google Ads API |
Biblioteka klienta Python |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
v22 |
Min: 28.1.0Max: 32.0.0
|
Ruby
Interfejs Google Ads API |
Biblioteka klienta Ruby |
v25 |
Min: 43.0.0Max: - |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
v22 |
Min: 36.0.0Max: - |
Perl
Interfejs Google Ads API |
Biblioteka klienta w Perlu |
v25 |
Min: 33.0.0Max: - |
v24 |
Min: 32.0.0Max: - |
v23 |
Min: 31.0.0Max: - |
v22 |
Min: 29.0.0Max: - |
Wycofanie funkcji i zmiany
Ta strona koncentruje się na cyklach życia na poziomie wersji interfejsu API, ale wycofanie poszczególnych funkcji (np. wycofanie kampanii inteligentnych) i zmiany w przepływach pracy bez wersji (np. nowe wymagania dotyczące budżetu kampanii generujących popyt) są śledzone oddzielnie.
Aby sprawdzić nadchodzące cykle życia funkcji i zmiany w zachowaniu w aktywnych wersjach, zapoznaj się z przewodnikiem Wycofywanie funkcji i zmiany bez wersji.