Wycofanie i wycofanie

Wraz z wydaniem nowej wersji wycofana wersja otrzymuje datę wycofania, po której nie będzie ona już dostępna. Oto kilka dodatkowych wskazówek, o których warto pamiętać:

  • Jednocześnie dostępne są maksymalnie trzy główne wersje.
  • Główne wersje mają okres ważności przez około 12 miesięcy, a wersje mniejsze: 10 miesięcy.
  • Musisz wykonać maksymalnie 2 uaktualnienia rocznie. Nie musisz też przeprowadzać uaktualnień w ścisłej kolejności sekwencyjnej. Możesz na przykład przejść z wersji (N) bezpośrednio na wersję (N+2).
  • Okres pokrywania się daty udostępnienia wszystkich bibliotek klienta dla najnowszej wersji do daty wycofania wersji wynosi co najmniej 20 tygodni.

Nasze biblioteki klienta obsługują wszystkie dostępne wersje usługi, więc możesz stopniowo uaktualniać usługę, określając różne wersje używanych usług.

Rozkład

W tabeli poniżej znajdziesz konkretne daty wycofania i wycofania każdej dostępnej wersji oraz przewidywane daty wydania kolejnych wersji. Zachęcamy do uaktualnienia do najnowszej wersji jak najszybciej po jej opublikowaniu.

Wersja interfejsu API Data premiery Data wycofania Data zachodu słońca Przewodnik po uaktualnianiu
v18 wrzesień/październik 2024 r. Styczeń/luty 2025 r. Wrzesień 2025 r.
v17.1 lipiec/sierpień 2024 r. wrzesień/październik 2024 r. Maj 2025 r.
v17 maj/czerwiec 2024 r. wrzesień/październik 2024 r. Maj 2025 r.
v16.1 24 kwietnia 2024 r. maj/czerwiec 2024 r. Styczeń 2025 r.
v16 21 lutego 2024 r. maj/czerwiec 2024 r. Styczeń 2025 r.
v15 18 października 2023 r. 21 lutego 2024 r. 25 września 2024 r. Uaktualnienie z wersji 15 do 16
v14.1 9 sierpnia 2023 r. 18 października 2023 r. 5 czerwca 2024 r.
v14 7 czerwca 2023 r. 18 października 2023 r. 5 czerwca 2024 r. Uaktualnienie z wersji 14 do 15

Wyświetlanie wersji używanych przez projekt

W konsoli Google Cloud możesz wyświetlić listę metod i usług ostatnio wywoływanych przez Twój projekt:

  1. W konsoli Google Cloud otwórz Interfejsy API i usługi.
  2. W tabeli kliknij Interfejs Google Ads API.
  3. Na podkarcie DANE możesz zobaczyć ostatnie żądania przedstawione na 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.v17.services.GoogleAdsService.Mutate.
  4. (Opcjonalnie) Wybierz przedział czasowy dla żądań.

Różnice między wycofaniem a wycofaniem

TerminWycofanieZachód słońca
Definicja To wycofana wersja, która nie jest najnowsza. Po opublikowaniu nowej wersji wszystkie poprzednie wersje będą oznaczone jako wycofane. Nie można już używać wersji wyłączonej. Żądania wysyłane do tej wersji będą kończyć się niepowodzeniem od daty wycofania tej wersji lub później.
Konsekwencje Możesz używać wycofanych wersji do momentu ich wycofania, ale odniesienia do wycofanych wersji zostaną odznaczone, aby wskazać, że nie są już one najnowszą wersją.

Zachęcamy do jak najszybszego przejścia na najnowszą wersję, aby móc korzystać z nowych funkcji.

Aby korzystać z interfejsu Google Ads API, musisz natychmiast przejść z wycofanej wersji na wycofaną.

Zdecydowanie zalecamy uaktualnienie do najnowszej wersji. Możesz skorzystać z przewodnika po uaktualnianiu.

Termin Nową wersję udostępniamy średnio co 3–4 miesiące, więc dana wersja zostanie wycofana po około 3–4 miesiącach. Staramy się wycofać wersję po roku od jej premiery.
API Punkty końcowe interfejsu API w przypadku wycofanych wersji nadal działają jak zwykle.

Możesz uzyskiwać dostęp do naszych punktów końcowych interfejsu API za pomocą naszych bibliotek klienta, REST itp., jednak do wycofanych wersji nie są dodawane nowe funkcje.

Punkty końcowe interfejsu API dla wycofanych wersji przestaną działać po datach wycofania. Jeśli spróbujesz uzyskać dostęp do punktów końcowych interfejsu API w wycofanych wersjach, interfejs Google Ads API zwróci błąd.
Biblioteki klienta Na potrzeby udostępniania kompaktowych bibliotek klienta po dacie wycofania przestaniemy uwzględniać wycofane wersje interfejsów API w nowej wersji biblioteki klienta. Pomoże Ci to zaoszczędzić miejsce podczas wdrażania naszych bibliotek klienta w projektach. Biblioteki klienta nie obsługują już wycofywanych wersji interfejsów API w nowych wersjach bibliotek klienta po dacie wycofania.
Pomoc W przypadku wycofanych wersji zapewniamy standardową pomoc. Wycofane wersje nie będą już obsługiwane po dacie wycofania.

Obsługiwane wersje biblioteki klienta

Tabela pokazuje, które biblioteki klienta współpracują z poszczególnymi wersjami interfejsu API.

Java

Biblioteka klienta dla języka Java
v16 Min: 30.0.0
Max: –
v15 Min: 28.0.0
Max: –
v14 Min: 26.0.0
Max: 30.0.0

C#

Biblioteka klienta dla .NET
v16 Min: 18.1.0
Max: –
v15 Min: 17.1.0
Max: –
v14 Min: 16.1.0
Max: 19.0.1

PHP

Biblioteka klienta dla PHP
v16 Min: 22.1.0
Max: –
v15 Min: 21.1.0
Max: –

Python

Biblioteka klienta dla Pythona
v16 Min: 23.1.0
Max: –
v15 Min: 22.1.0
Max: –

Ruby

Biblioteka klienta dla języka Ruby
v16 Min: 27.0.0
Max: –
v15 Min: 25.0.0
Max: –
v14 Min: 23.0.0
Max: 27.0.0

Perl

Biblioteka klienta dla języka Perl
v16 Min: 21.0.0
Max: –
v15 Min: 19.0.0
Max: –
v14 Min: 17.0.0
Max: 21.0.0

Wycofane funkcje

Regularnie obserwuj bloga dla deweloperów Google Ads, by dowiadywać się o zbliżającym się wycofaniu funkcji.

W tabeli poniżej znajdziesz planowane wycofanie konkretnych funkcji interfejsu Google Ads API. Więcej informacji o każdym wycofaniu znajdziesz w postach na blogu, do których prowadzą linki.

Funkcja Opis Zaczyna obowiązywać Dodatkowe uwagi
Strategia ustalania stawek na podstawie prowizji Interfejs Google Ads API nie obsługuje już tworzenia kampanii reklam hoteli ze strategią ustalania stawek COMMISSION . 30 kwietnia 2024 r. Prośby o utworzenie nowych kampanii reklam hoteli lub zastosowanie strategii ustalania stawek COMMISSION w dotychczasowych kampaniach będą powodować błąd BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED. Dotychczasowe kampanie korzystające ze strategii ustalania stawek COMMISSION będą działać do 31 października 2024 r. Po tym dniu kampanie przestaną wyświetlać reklamy, dopóki ich strategia ustalania stawek nie zostanie zaktualizowana.