Wycofanie i wycofanie

Wraz z opublikowaniem nowej wersji wycofano wersji ma datę wycofania, po której nie będzie ona już i dostępności informacji. 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 aktualizacje rocznie i nie masz w ściśle określonej kolejności, np. z wersji (N) bezpośrednio na wersję (N+2).
  • Nakładanie się zakresu dat, w którym wszystkie biblioteki klienta zostały udostępnione dla Najnowsza wersja i wersja do wycofania to co najmniej 20 tygodni.

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

Rozkład

W tabeli poniżej znajdziesz konkretne daty wycofania i wycofania poszczególnych funkcji oraz przewidywane daty wydania kolejnych wersji. Śr zachęcamy do uaktualnienia go do najnowszej wersji jak najszybciej po wersji.

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 7 sierpnia 2024 r. wrzesień/październik 2024 r. Maj 2025 r.
v17 5 czerwca 2024 r. wrzesień/październik 2024 r. Maj 2025 r.
v16.1 24 kwietnia 2024 r. 5 czerwca 2024 r. Styczeń 2025 r. Uaktualnienie z wersji 16 do wersji 17
v16 21 lutego 2024 r. 5 czerwca 2024 r. Styczeń 2025 r. Uaktualnienie z wersji 16 do wersji 17
v15 18 października 2023 r. 21 lutego 2024 r. 25 września 2024 r. Uaktualnienie z wersji 15 do 16

Wyświetlanie wersji używanych przez projekt

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

  1. Otwórz interfejsy API i usług w konsoli Google Cloud.
  2. W tabeli kliknij Interfejs Google Ads API.
  3. Na podkarcie DANE powinny być widoczne ostatnie żądania podane na wykresie. każdego wykresu. Metody, do których zostały wysłane prośby, możesz sprawdzić w Tabela Metody. 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 wycofane. Nie można już używać wersji wyłączonej. Wysłane do tego a nie w dniu wycofania tej wersji ani po tej dacie.
Konsekwencje Możesz używać wycofanych wersji do czasu ich wycofania. ale odniesienia do wycofanych wersji są usuwane, aby można było je wyświetlić że nie są już dostępne w najnowszej wersji.

Zachęcamy do jak najszybszego uaktualnienia korzystanie z nowych funkcji.

Musisz natychmiast przejść na wersję standardową, aby móc korzystać z interfejsu Google Ads API.

Zdecydowanie zalecamy uaktualnienie do najnowszej wersji , korzystając z przewodnika po uaktualnieniu.

Termin Nową wersję publikujemy średnio co 3-4 miesiące, zostanie wycofana po około 3–4 miesiącach. Staramy się wycofać wersję po roku od jej premiery.
API Punkty końcowe interfejsu API dla wycofanych wersji nadal działają jak zwykle.

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

Punkty końcowe interfejsu API dla wersji wycofanych z programu przestaną działać po na datach wycofania. Interfejs Google Ads API zwróci błąd, jeśli spróbujesz uzyskać dostęp do Punkty końcowe interfejsu API wycofanych wersji.
Biblioteki klienta Ze względu na udostępnianie kompaktowych bibliotek klienckich przestaniemy w tym wycofane wersje interfejsów API w nowej wersji biblioteki klienta. po dacie ich wycofania. Pomaga to zaoszczędzić miejsce podczas nasze biblioteki klienta w Twoich projektach. Biblioteki klienta nie obsługują już wycofywanych wersji interfejsów API wszystkich nowych wersji biblioteki klienta po wycofaniu usługi.
Pomoc W przypadku wycofanych wersji zapewniamy standardową pomoc. Wersje wyłączone z użytku nie będą już obsługiwane po wycofaniu usługi datę.

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
v17 Min: 32.0.0
Max:
v16 Min: 30.0.0
Max:
v15 Min: 28.0.0
Max: 32.0.0

C#

Biblioteka klienta dla .NET
v17 Min: 20.1.0
Max:
v16 Min: 18.1.0
Max:
v15 Min: 17.1.0
Max: 20.1.0

PHP

Biblioteka klienta dla PHP
v17 Min: 23.1.0
Max:
v16 Min: 22.1.0
Max:
v15 Min: 21.1.0
Max: 23.1.0

Python

Biblioteka klienta dla Pythona
v17 Min: 24.1.0
Max:
v16 Min: 23.1.0
Max:
v15 Min: 22.1.0
Max:

Ruby

Biblioteka klienta dla języka Ruby
v17 Min: 29.0.0
Max:
v16 Min: 27.0.0
Max:
v15 Min: 25.0.0
Max:

Perl

Biblioteka klienta dla języka Perl
v17 Min: 23.0.0
Max:
v16 Min: 21.0.0
Max:
v15 Min: 19.0.0
Max:

Wycofane funkcje

Regularnie obserwuj bloga dla deweloperów Google Ads. , którzy jako pierwsi dowiadują się o zbliżającym się wycofaniu funkcji.

Tabela poniżej zawiera listę wycofanych funkcji, które są obecnie planowane na potrzeby interfejsu Google Ads API. Więcej informacji o każdym wycofanym okresie znajdziesz w linkach na blogu.

Funkcja Opis Data wejścia w życie Uwagi dodatkowe
Strategia ustalania stawek na podstawie prowizji Interfejs Google Ads API nie obsługuje już tworzenia kampanii reklam hoteli na podstawie modelu COMMISSION strategia ustalania stawek . 30 kwietnia 2024 r. Prośby o utworzenie nowych kampanii reklam hoteli lub zastosowanie tych zasad (COMMISSION) strategii ustalania stawek w istniejących kampaniach przyniesie BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED . Dotychczasowe kampanie ze strategią ustalania stawek COMMISSION będzie obowiązywać do 31 października 2024 r. Po tym dniu kampanie przestaną wyświetlać reklamy do czasu zaktualizowania ich strategii ustalania stawek.