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:
- W konsoli Google Cloud otwórz Interfejsy API i usługi.
- W tabeli kliknij Interfejs Google Ads API.
- 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
. - (Opcjonalnie) Wybierz przedział czasowy dla żądań.
Różnice między wycofaniem a wycofaniem
Termin | Wycofanie | Zachó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
Interfejs Google Ads API |
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#
Interfejs Google Ads API |
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
Interfejs Google Ads API |
Biblioteka klienta dla PHP |
v16 |
Min: 22.1.0 Max: – |
v15 |
Min: 21.1.0 Max: – |
Python
Interfejs Google Ads API |
Biblioteka klienta dla Pythona |
v16 |
Min: 23.1.0 Max: – |
v15 |
Min: 22.1.0 Max: – |
Ruby
Interfejs Google Ads API |
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
Interfejs Google Ads API |
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.
|