wycofanie i wycofanie

Po wydaniu nowej wersji wycofana wersja otrzymuje datę wyłączenia, po której nie będzie już dostępna. Pamiętaj o tych wytycznych:

  • 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 2 aktualizacje. Nie musisz też aktualizować 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 nadal 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 udostępnienia przyszłych wersji. Zachęcamy do przejścia na najnowszą wersję jak najszybciej po jej udostępnieniu. Data orientacyjna oznacza, że zakończenie obsługi może nastąpić w dowolnym momencie w danym miesiącu, a daty mogą ulec zmianie. Subskrybuj bloga, aby otrzymywać przypomnienia o zakończeniu obsługi wersji interfejsu API.

Wersja interfejsu APIData premieryData wycofaniaPrzewodnik po uaktualnianiu
Wersje opublikowane
v204 czerwca 2025 r.10 czerwca 2026 r.Przechodzenie z wersji 19 na wersję 20
v20.16 sierpnia 2025 r.Czerwiec 2026 r. (wstępnie)Przechodzenie z wersji 19 na wersję 20
v216 sierpnia 2025 r.Sierpień 2026 r. (wstępnie)Przechodzenie z wersji 20 na wersję 21
v2215 października 2025 r.Październik 2026 r. (wstępnie)Przechodzenie z wersji 21 na wersję 22
v2328 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
v24.1 13 maja 2026 r. maj 2027 r. Przechodzenie z wersji 24 na wersję 24.1
Nadchodzące wersje
v24.2 Czerwiec 2026 r. maj 2027 r.  
v25 lipca 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. Listopad 2027 r.  
wersja 26.1* Listopad 2026 r. Listopad 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:

  1. Otwórz Interfejsy API i usługi w konsoli Google Cloud.
  2. W tabeli kliknij Google Ads API.
  3. Na podzakładce METRICS (DANE) powinny być widoczne ostatnie żądania na każdym wykresie. W tabeli Methods (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.v24.services.GoogleAdsService.Mutate.
  4. (Opcjonalnie) Wybierz okres, w którym chcesz wyświetlać prośby.

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

HasłoWycofanieZachód słońca
Definicja Wycofana wersja to wersja, która nie jest najnowsza. Gdy pojawi się nowa wersja, 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ć wycofanych wersji, dopóki nie zostaną wycofane, ale odniesienia do wycofanych wersji 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.

Zdecydowanie zalecamy uaktualnienie do najnowszej wersji 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 wersji wycofanych.

 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 dodawania 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

Biblioteka klienta Java
v24 Min: 43.0.0
Max: -
v23 Min: 42.0.0
Max: -
v22 Min: 41.0.0
Max: -
v21 Min: 39.0.0
Max: -
v20 Min: 38.0.0
Max: 42.2.0

C#

Biblioteka klienta dla .NET
v24 Min: 25.3.0
Max: -
v23 Min: 25.1.0
Max: -
v22 Min: 24.1.0
Max: -
v21 Min: 24.0.0
Max: -
v20 Min: 23.0.0
Max: -

PHP

Biblioteka klienta PHP
v24 Min: 33.3.0
Max: -
v23 Min: 32.2.0
Max: -
v22 Min: 31.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 26.1.0
Max: -

Python

Biblioteka klienta Python
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -
v22 Min: 28.1.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: -

Ruby

Biblioteka klienta dla Ruby
v24 Min: 40.0.0
Max: -
v23 Min: 38.0.0
Max: -
v22 Min: 36.0.0
Max: -
v21 Min: 35.0.0
Max: -
v20 Min: 34.0.0
Max: -

Perl

Biblioteka klienta Perl
v24 Min: 32.0.0
Max: -
v23 Min: 31.0.0
Max: -
v22 Min: 29.0.0
Max: -
v21 Min: 28.0.0
Max: -
v20 Min: 27.0.0
Max: 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 zostaną wycofane z interfejsu Google Ads API. Więcej informacji o każdej z nich znajdziesz w powiązanych postach na blogu.

Funkcja Opis Data wejścia w życie Uwagi dodatkowe
Zmiana zasad przechowywania danych Okres przechowywania szczegółowych danych do raportu (dziennych, godzinowych, tygodniowych) zostanie skrócony do 37 miesięcy. Dane ogólne (miesięczne, kwartalne, roczne) pozostaną dostępne przez 11 lat. 1 czerwca 2026 r. Więcej informacji znajdziesz w naszym poście na blogu.
Zmiany w pomocy dotyczącej konwersji offline

Od 15 czerwca 2026 r. tokeny deweloperów, które nie wysyłały ostatnio żądań konwersji offline, muszą używać interfejsu Data Manager API w przypadku przepływów pracy związanych z konwersjami offline.

15 czerwca 2026 r. Więcej informacji znajdziesz w naszym poście na blogu.
Zmiany w zakresie pomocy dotyczącej 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.

  • Jeśli Twój token programisty wysłał w okresie od 1 października 2025 r. do 31 marca 2026 r. żądanie OfflineUserDataJobService lub UserDataService dotyczące odbiorców objętych kierowaniem na listę klientów, możesz nadal używać tego tokena programisty z interfejsem Google Ads API w przypadku procesów związanych z kierowaniem na listę klientów. Zalecamy jednak przejście na interfejs Data Manager API, aby zwiększyć komfort pracy i uzyskać dostęp do dodatkowych funkcji.
  • W przeciwnym razie od 1 kwietnia 2026 r. każde żądanie OfflineUserDataJobService lub UserDataService dotyczące odbiorców z kierowania na listę klientów zakończy się niepowodzeniem i wyświetli się błąd CUSTOMER_NOT_ALLOWLISTED_FOR_THIS_FEATURE. W przypadku procesów związanych z kierowaniem na listę klientów używaj interfejsu Data Manager API zamiast interfejsu Google Ads API.
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.