Interfejs Google Ads API utrzymuje wiele aktywnych wersji głównych w każdym momencie, a wersja jest uważana za wycofaną tylko wtedy, gdy jest wyraźnie oznaczona jako wycofana. Interfejs Google Ads API publikuje daty wydania i wycofania z wyprzedzeniem, aby pomóc Ci zaplanować uaktualnienia. Po dacie wyłączenia wersja nie jest już dostępna. Pamiętaj o tych wskazówkach dotyczących wersji:
- Interfejs Google Ads API dąży do tego, aby w każdej chwili było dostępnych maksymalnie 5 wersji głównych.
- Wersje główne są obsługiwane przez około 12 miesięcy. Okres ważności wersji podrzędnych interfejsu API nie jest śledzony osobno. Zamiast tego wersje podrzędne mają tę samą datę wycofania co odpowiadająca im wersja główna.
- Każda wersja podrzędna stopniowo aktualizuje odpowiadającą jej wersję główną.
- Wszystkie wywołania interfejsu API do określonej wersji głównej zawsze trafiają do najnowszej odpowiadającej jej wersji podrzędnej. Interfejs Google Ads API nie obsługuje wywoływania konkretnych wersji podrzędnych.
- Możesz 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).
- Jeśli dopiero zaczynasz korzystać z interfejsu Google Ads API, zacznij od wersji 26.
Biblioteki klienta interfejsu Google Ads API 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 wydania i wycofania każdej dostępnej wersji oraz przewidywane daty wydania przyszłych wersji. Jak najszybciej po wydaniu najnowszej wersji przejdź na nią. Wstępna data oznacza, że wycofanie może nastąpić w dowolnym momencie danego miesiąca, a daty mogą ulec zmianie. Zasubskrybuj bloga, aby otrzymywać przypomnienia o wycofaniu 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 proto w wersji 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 proto w wersji 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 proto w wersji 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 proto w wersji 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. | Maj 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 proto 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 proto 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 proto 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 |
| v26.2 | 11 listopada 2026 r. | Listopad 2027 r. | Brak (wersja podrzędna) | Funkcje i aktualizacje w wersji 26.2 | Różnice między plikami proto w wersjach 25 i 26 |
| Nadchodzące wersje | |||||
| 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 | Czerwiec 2027 r. | maju 2028 r. | – | – | – |
| v28.5 | Czerwiec 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, ponieważ pokrywają się z sezonem świątecznym.
Myślnik (–) oznacza, że szczegóły dotyczące nadchodzących wersji nie są jeszcze dostępne.
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:
- Otwórz panel Interfejsy API i usługi w konsoli Google Cloud.
- W tabeli kliknij interfejs Google Ads API.
- Na podkarcie WSKAŹNIKI na każdym wykresie są widoczne ostatnie żądania.
W tabeli Metody możesz sprawdzić, które metody otrzymały żądania. Każdy wpis zawiera wersję interfejsu Google Ads API, usługę i metodę, np. metodę
google.ads.googleads.v26.services.GoogleAdsService.Mutate. - Opcjonalnie: wybierz przedział czasowy, dla którego chcesz wyświetlić prośby.
Różnice między wycofaniem a zakończeniem obsługi
| Okres obowiązywania | Wycofanie | Zachód słońca |
|---|---|---|
| Definicja | Wersja jest uznawana za wycofaną tylko wtedy, gdy jest wyraźnie oznaczona jako wycofana. Interfejs Google Ads API zawsze obsługuje wiele aktywnych wersji głównych. | Wersji wyłączonej nie można już używać. Żądania wysyłane do wyłączonej wersji nie będą realizowane w dniu wyłączenia ani po nim. |
| Konsekwencje | Możesz nadal korzystać z wycofanych wersji do daty ich wycofania, ale dokumentacja referencyjna wycofanych wersji jest oznaczona jako nieaktualna, aby pokazać, że nie są to najnowsze wersje.
Jak najszybciej przejdź na najnowszą wersję, aby korzystać z nowych funkcji. |
Aby nadal korzystać z interfejsu Google Ads API, natychmiast przejdź na nowszą wersję.
Przejdź na najnowszą wersję, korzystając z przewodnika po uaktualnianiu. |
| Timing | Daty wycofania są publikowane z wyprzedzeniem, a wersja jest uznawana za wycofaną tylko wtedy, gdy jest wyraźnie oznaczona jako wycofana. | Wersje główne mają docelowy okres ważności wynoszący 1 rok od daty wydania. |
| API | Punkty końcowe interfejsu API w przypadku wycofanych wersji nadal działają normalnie.
Dostęp do punktów końcowych interfejsu API możesz uzyskać za pomocą bibliotek klienta i REST. Jednak do wycofanych wersji nie są dodawane nowe funkcje. |
Punkty końcowe interfejsu API w wycofanych wersjach przestają działać po dacie wycofania. Jeśli wyślesz żądania do punktów końcowych wycofanej wersji, interfejs Google Ads API zwróci błąd. |
| Biblioteki klienta | Aby biblioteki klienta były kompaktowe, nowe wersje bibliotek klienta nie zawierają już wycofanych wersji interfejsu API. Usunięcie wycofanych wersji pomaga zaoszczędzić miejsce podczas dodawania bibliotek klienta do projektów. | Nowe wersje biblioteki klienta nie obsługują już wycofanych wersji interfejsu API po dacie ich wycofania. |
| Pomoc | Wycofane wersje nadal będą objęte standardową pomocą. | 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 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 koncentruje się na cyklach życia na poziomie wersji interfejsu API, ale wycofanie poszczególnych funkcji (np. wycofanie kampanii inteligentnych) i zmiany w procesach 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.