wycofanie i wycofanie

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:

  1. Otwórz panel Interfejsy API i usługi w konsoli Google Cloud.
  2. W tabeli kliknij interfejs Google Ads API.
  3. 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.
  4. Opcjonalnie: wybierz przedział czasowy, dla którego chcesz wyświetlić prośby.

Różnice między wycofaniem a zakończeniem obsługi

Okres obowiązywaniaWycofanieZachó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

Lista zmian

Biblioteka klienta dla Javy
v26 Min: 48.0.0
Max: –
v25 Min: 44.0.0
Max: –
v24 Min: 43.0.0
Max: –
v23 Min: 42.0.0
Max: –

C#

Lista zmian

Biblioteka klienta dla .NET
v26 Min: 27.5.0
Max: –
v25 Min: 26.1.0
Max: –
v24 Min: 25.3.0
Max: –
v23 Min: 25.1.0
Max: –

PHP

Lista zmian

Biblioteka klienta dla PHP
v26 Min: 35.2.0
Max: –
v25 Min: 33.6.0
Max: –
v24 Min: 33.3.0
Max: –
v23 Min: 32.2.0
Max: –

Python

Lista zmian

Biblioteka klienta dla Pythona
v26 Min: 34.0.0
Max: –
v25 Min: 31.2.0
Max: –
v24 Min: 30.1.0
Max: –
v23 Min: 29.2.0
Max: –

Ruby

Lista zmian

Biblioteka klienta dla Ruby
v26 Min: 46.0.0
Max: –
v25 Min: 43.0.0
Max: –
v24 Min: 40.0.0
Max: –
v23 Min: 38.0.0
Max: –

Perl

Lista zmian

Biblioteka klienta dla Perla
v26 Min: 36.0.0
Max: –
v25 Min: 33.0.0
Max: –
v24 Min: 32.0.0
Max: –
v23 Min: 31.0.0
Max: –

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.