Po opublikowaniu 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ępne były maksymalnie 4 wersje główne.
- Wersje główne są obsługiwane przez około 12 miesięcy, a wersje pomocnicze przez 10 miesięcy.
- W ciągu roku możesz przeprowadzić maksymalnie dwie aktualizacje. Nie musisz też aktualizować kolejnych wersji w ściśle określonej kolejności – możesz na przykład przejść z wersji N bezpośrednio do wersji N+2.
- Okres, w którym wszystkie biblioteki klienta są dostępne w najnowszej wersji, a wersja, która ma zostać wycofana, jest dostępna, wynosi co najmniej 20 tygodni.
Nasze biblioteki klienta obsługują wszystkie dostępne wersje usługi, więc możesz stopniowo przeprowadzać aktualizację, 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 jak najszybszego uaktualnienia do najnowszej wersji 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 ogłoszeniach o wycofaniu wersji interfejsu API.
| Wersja interfejsu API | Data premiery | Data wycofania | Przewodnik po uaktualnianiu |
|---|---|---|---|
| Wersje | |||
| v20 | 4 czerwca 2025 r. | Czerwiec 2026 r. (wstępnie) | Przechodzenie z wersji 19 na wersję 20 |
| v20.1 | 6 sierpnia 2025 r. | Czerwiec 2026 r. (wstępnie) | Przechodzenie z wersji 19 na wersję 20 |
| v21 | 6 sierpnia 2025 r. | Sierpień 2026 r. (wstępnie) | Przechodzenie z wersji 20 na wersję 21 |
| v22 | 15 października 2025 r. | Październik 2026 r. (wstępnie) | Przechodzenie 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. | Przechodzenie z wersji 23 na wersję 23.1 |
| v23.2 | 25 marca 2026 r. | Luty 2027 r. | Przechodzenie z wersji 23.1 na wersję 23.2 |
| v24 | 22 kwietnia 2026 r. | Maj 2027 r. | Przechodzenie z wersji 23.2 na wersję 24 |
| Nadchodzące wersje | |||
| v24.1 | maju 2026 r. | Maj 2027 r. | |
| v24.2 | czerwcu 2026 r. | Maj 2027 r. | |
| v25 | lipiec 2026 r. | Sierpień 2027 r. | |
| v25.1 | Sierpień 2026 r. | Sierpień 2027 r. | |
| v25.2 | Wrzesień 2026 r. | Sierpień 2027 r. | |
| v26 | październiku 2026 r. | listopadzie 2027 r. | |
| wersja 26.1* | Listopad 2026 r. | listopadzie 2027 r. | |
* Wersja 26.1 jest oznaczona jako opcjonalna ze względu na sezon świąteczny.
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 Google Ads API.
- Na karcie METRICS (DANE) powinny być widoczne Twoje ostatnie prośby na każdym wykresie. W tabeli Metody możesz sprawdzić, do których metod zostały wysłane prośby. Nazwa metody zawiera wersję interfejsu Google Ads API, usługę i nazwę metody, np.
google.ads.googleads.v24.services.GoogleAdsService.Mutate. - (Opcjonalnie) Wybierz okres, dla którego chcesz wyświetlić prośby.
Różnice między wycofaniem a zakończeniem
| Hasło | Wycofanie | Zachód słońca |
|---|---|---|
| Definicja | Wersja wycofana to wersja, która nie jest najnowsza. Gdy nowa wersja zostanie udostępniona, wszystkie poprzednie wersje zostaną oznaczone jako wycofane. | Wersji wyłączonej nie można już używać. Żądania wysyłane do tej wersji po dacie wyłączenia będą zwracać błąd. |
| Implikacja | Możesz nadal używać przestarzałych 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ść na nowszą wersję.
Zdecydowanie zalecamy uaktualnienie do najnowszej wersji, korzystając z przewodnika po uaktualnianiu. |
| Timing | Nową wersję publikujemy średnio co 3–4 miesiące, więc dana 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 wycofywanych 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 są 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.
Java
Interfejs Google Ads API |
Biblioteka klienta Java |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
v22 |
Min: 41.0.0Max: - |
v21 |
Min: 39.0.0Max: - |
v20 |
Min: 38.0.0Max: 42.2.0 |
C#
Interfejs Google Ads API |
Biblioteka klienta dla .NET |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
v22 |
Min: 24.1.0Max: - |
v21 |
Min: 24.0.0Max: - |
v20 |
Min: 23.0.0Max: - |
PHP
Interfejs Google Ads API |
Biblioteka klienta PHP |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: - |
v22 |
Min: 31.0.0Max: - |
v21 |
Min: 28.0.0Max: - |
v20 |
Min: 26.1.0Max: - |
Python
Interfejs Google Ads API |
Biblioteka klienta Python |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
v22 |
Min: 28.1.0Max: - |
v21 |
Min: 28.0.0Max: - |
v20 |
Min: 27.0.0Max: - |
Ruby
Interfejs Google Ads API |
Biblioteka klienta do Ruby |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
v22 |
Min: 36.0.0Max: - |
v21 |
Min: 35.0.0Max: - |
v20 |
Min: 34.0.0Max: - |
Perl
Interfejs Google Ads API |
Biblioteka klienta Perl |
v24 |
Min: 32.0.0Max: - |
v23 |
Min: 31.0.0Max: - |
v22 |
Min: 29.0.0Max: - |
v21 |
Min: 28.0.0Max: - |
v20 |
Min: 27.0.0Max: 32.0.0 |
Wycofanie funkcji
Regularnie sprawdzaj Blog dla programistów Google Ads, aby jako pierwszy dowiadywać się o wycofywaniu funkcji.
W tabeli poniżej znajdziesz listę konkretnych funkcji, które planujemy wycofać z interfejsu Google Ads API. Więcej informacji o każdym wycofaniu znajdziesz w linkowanych postach na blogu.
| Funkcja | Opis | Data wejścia w życie | Uwagi dodatkowe |
|---|---|---|---|
| Zmiany w obsłudze kierowania na listę klientów |
Od 1 kwietnia 2026 r. tokeny deweloperskie, które nie mają ostatnich żądań kierowania na listę klientów, muszą używać interfejsu Data Manager API w przypadku procesów związanych z kierowaniem na listę klientów.
|
1 kwietnia 2026 r. | Więcej informacji znajdziesz w naszym poście na blogu. |
| Zmiany w obsłudze atrybutów adresu IP i sesji | Interfejs Google Ads API nie obsługuje już nowych użytkowników chcących korzystać z atrybutów sesji lub danych adresu IP w ramach importowania konwersji. Dotychczasowi użytkownicy powinni przejść na interfejs Data Manager API. | 2 lutego 2026 r. | Więcej informacji znajdziesz w poście na naszym blogu. |
| Wycofanie reklam typu „tylko połączenie” | Nie można tworzyć nowych reklam typu „tylko połączenie”. W lutym 2027 r. reklamy typu „tylko połączenie” przestaną się wyświetlać, a obsługa interfejsu API zostanie wycofana. Zamiast nich reklamodawcy powinni używać elastycznych reklam w wyszukiwarce z komponentami do wykonywania połączeń. | Styczeń 2026 | Więcej informacji znajdziesz w poście na naszym blogu. |