Wraz z opublikowaniem nowej wersji wycofana wersja otrzymuje datę wycofania, 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ło co najwyżej 5 wersji głównych.
- Główne wersje są dostępne przez około 12 miesięcy , a pomocnicze wersje – przez 10 miesięcy.
- Będziesz musiał(-a) przeprowadzić co najwyżej 2 uaktualnienia rocznie i nie musisz ich wykonywać w ścisłej kolejności – możesz na przykład przejść z wersji (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 jazdy
W tabeli poniżej znajdziesz konkretne daty wycofania i wyłączenia każdej dostępnej wersji oraz przewidywane daty premiery przyszłych wersji. Zachęcamy do jak najszybszego uaktualnienia do najnowszej wersji po jej opublikowaniu. Data przybliżona oznacza, że wycofanie może nastąpić w dowolnym momencie w danym miesiącu, a daty mogą ulec zmianie. Aby otrzymywać przypomnienia o wycofaniu wersji interfejsu API, zasubskrybuj bloga.
| Wersja interfejsu API | Data premiery | Data wycofania | Przewodnik po uaktualnianiu |
|---|---|---|---|
| Wersje | |||
| v22 | 15 października 2025 r. | Październik 2026 r. (przybliżona data) | Uaktualnianie z wersji 21 do 22 |
| v23 | 28 stycznia 2026 r. | Luty 2027 r. | Uaktualnianie z wersji 22 do 23 |
| v23.1 | 25 lutego 2026 r. | Luty 2027 r. | Uaktualnianie z wersji 23 do 23.1 |
| v23.2 | 25 marca 2026 r. | Luty 2027 r. | Uaktualnianie z wersji 23.1 do 23.2 |
| v24 | 22 kwietnia 2026 r. | Maj 2027 r. | Uaktualnianie z wersji 23.2 do 24 |
| v24.1 | 13 maja 2026 r. | Maj 2027 r. | Uaktualnianie z wersji 24 do 24.1 |
| v24.2 | 24 czerwca 2026 r. | Czerwiec 2027 r. | Uaktualnianie z wersji 24.1 do 24.2 |
| v25 | 22 lipca 2026 r. | Sierpień 2027 r. | Uaktualnianie z wersji 24.2 do 25 |
| Nadchodzące wersje | |||
| v25.1 | Sierpień 2026 r. | Sierpień 2027 r. | |
| v25.2 | Wrzesień 2026 r. | Sierpień 2027 r. | |
| v26 | Październik 2026 r. | Listopad 2027 r. | |
| v26.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 przez projekt
Listę metod i usług, z których projekt korzystał ostatnio, możesz wyświetlić w konsoli Google Cloud:
- Otwórz Interfejsy API i usługi w konsoli Google Cloud.
- W tabeli kliknij Interfejs Google Ads API.
- Na podkarcie METRYKI powinny być widoczne Twoje ostatnie żądania 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.v25.services.GoogleAdsService.Mutate. - (Opcjonalnie) Wybierz okres, w którym chcesz wyświetlić żądania.
Różnice między wycofaniem a wyłączeniem
| Okres obowiązywania | Wycofanie | Wyłączenie |
|---|---|---|
| Definicja | Wycofana wersja to wersja, która nie jest najnowsza. Gdy zostanie opublikowana nowa wersja, wszystkie poprzednie wersje zostaną oznaczone jako wycofane. | Wersja wyłączona nie może być już używana. Żądania wysyłane do tej wersji będą kończyć się niepowodzeniem w dniu wyłączenia lub po nim. |
| Implikacje | Możesz nadal używać wycofanych wersji, dopóki nie zostaną wyłączone,
ale odniesienia do wycofanych wersji są wyróżnione, aby pokazać
że nie są już najnowsze.
Zachęcamy do jak najszybszego uaktualnienia do najnowszej wersji, aby korzystać z nowych funkcji. |
Aby korzystać z interfejsu Google Ads API, musisz natychmiast przejść z wersji wyłączonych.
Zdecydowanie zalecamy uaktualnienie do najnowszej wersji za pomocą 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. | Wersję wyłączamy zwykle rok po jej opublikowaniu. |
| API | Punkty końcowe interfejsu API dla wycofanych wersji nadal działają
normalnie.
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 dla wersji wyłączonych przestają działać po datach wyłączenia. Jeśli spróbujesz uzyskać dostęp do punktów końcowych interfejsu API wersji wyłączonych, 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 po dacie wycofania. Dzięki temu oszczędzisz miejsce podczas wdrażania naszych bibliotek klienta w swoich projektach. | Biblioteki klienta nie obsługują już wyłączonych wersji interfejsu API w żadnych nowych wersjach biblioteki klienta po datach wyłączenia. |
| Pomoc | Zapewniamy regularną pomoc dotyczącą wycofanych wersji. | Wersje wyłączone nie będą obsługiwane po dacie wyłączenia. |
Obsługiwane wersje biblioteki klienta
W tabeli znajdziesz informacje o tym, 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 pomocniczych, 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 .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 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: – |
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 Perl |
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 cyklu życia na poziomie wersji interfejsu API, ale wycofanie poszczególnych funkcji (np. wycofanie kampanii inteligentnych) i zmiany w przepływie 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 Wycofanie funkcji i zmiany bez wersji.