Einstellung und Einstellung

Mit der Veröffentlichung einer neuen Version erhält eine verworfene Version ein Ablaufdatum, nach dem diese Version nicht mehr verfügbar ist. Hier sind einige weitere Richtlinien, die es zu beachten gilt:

  • Es sind maximal drei Hauptversionen gleichzeitig verfügbar.
  • Hauptversionen haben eine Lebensdauer von etwa 12 Monaten, Nebenversionen: 10 Monate.
  • Sie müssen maximal zwei Upgrades pro Jahr durchführen und müssen nicht in strikter sequenzieller Reihenfolge durchgeführt werden. Sie können beispielsweise direkt von Version (N) auf Version (N+2) upgraden.
  • Die Überschneidung zwischen dem Datum, an dem alle Clientbibliotheken für die neueste Version freigegeben werden, und dem Datum, an dem alle Clientbibliotheken eingestellt werden, beträgt mindestens 20 Wochen.

Unsere Clientbibliotheken unterstützen alle verfügbaren Versionen eines Dienstes. Sie können also schrittweise ein Upgrade durchführen, indem Sie verschiedene Versionen der verwendeten Dienste angeben.

Fahrplan

In der folgenden Tabelle sind die jeweiligen Einstellungs- und Ablauftermine für jede verfügbare Version sowie die voraussichtlichen Veröffentlichungsdaten für zukünftige Versionen aufgeführt. Wir empfehlen Ihnen, so schnell wie möglich nach der Veröffentlichung ein Upgrade auf die neueste Version durchzuführen.

API-Version Veröffentlichungsdatum Einstellungsdatum Ablaufdatum Upgrade-Leitfaden
v18 Sept/Okt. 2024 Jan./Feb. 2025 September 2025
v17.1 Juli/Aug. 2024 Sept/Okt. 2024 Mai 2025
v17 Mai/Juni 2024 Sept/Okt. 2024 Mai 2025
v16.1 24. April 2024 Mai/Juni 2024 Januar 2025
v16 21. Februar 2024 Mai/Juni 2024 Januar 2025
v15 18. Oktober 2023 21. Februar 2024 25. September 2024 Upgrade von Version 15 auf Version 16 durchführen
v14.1 9. August 2023 18. Oktober 2023 5. Juni 2024
v14 7. Juni 2023 18. Oktober 2023 5. Juni 2024 Upgrade von Version 14 auf Version 15

Von Ihrem Projekt verwendete Versionen ansehen

Mit der Google Cloud Console können Sie eine Liste der Methoden und Dienste aufrufen, die Ihr Projekt zuletzt aufgerufen hat:

  1. Öffnen Sie in der Google Cloud Console die Seite APIs und Dienste.
  2. Klicken Sie in der Tabelle auf Google Ads API.
  3. Auf dem Unter-Tab MESSWERTE sollten Ihre letzten Anfragen in jedem Diagramm dargestellt werden. In der Tabelle Methods können Sie sehen, an welche Methoden Sie Anfragen gesendet haben. Der Methodenname enthält eine Google Ads API-Version, einen Dienst und einen Methodennamen, z. B. google.ads.googleads.v16.services.GoogleAdsService.Mutate.
  4. Optional: Wählen Sie den Zeitraum aus, der für Ihre Anfragen angezeigt werden soll.

Unterschiede zwischen Einstellung und Einstellung

LaufzeitEinstellungSonnenuntergang
Definition Die eingestellte Version ist nicht die aktuelle. Sobald eine neue Version veröffentlicht wird, werden alle vorherigen Versionen als eingestellt gekennzeichnet. Die eingestellte Version kann nicht mehr verwendet werden. An diese Version gesendete Anfragen schlagen am oder nach dem Einstellungsdatum fehl.
Auswirkungen Sie können die verworfenen Versionen weiterhin verwenden, bis sie eingestellt werden. Die Verweise auf die verworfenen Versionen sind jedoch nicht mehr hervorgehoben, um zu zeigen, dass sie nicht mehr die aktuelle Version sind.

Wir empfehlen Ihnen, so schnell wie möglich ein Upgrade auf die neueste Version durchzuführen, um die neuen Funktionen nutzen zu können.

Sie müssen die eingestellten Versionen sofort aktualisieren, um die Google Ads API nutzen zu können.

Wir empfehlen dringend, dass Sie ein Upgrade auf die neueste Version durchführen. Verwenden Sie dazu den Upgradeleitfaden.

Dauer Im Durchschnitt veröffentlichen wir alle drei bis vier Monate eine neue Version, sodass die betreffende Version nach etwa 3 bis 4 Monaten verworfen wird. Wir versuchen, eine Version ein Jahr nach ihrer Veröffentlichung einzustellen.
API API-Endpunkte für die verworfenen Versionen funktionieren weiterhin wie gewohnt.

Sie können über unsere Clientbibliotheken, REST usw. auf unsere API-Endpunkte zugreifen. Die verworfenen Versionen werden jedoch nicht um neue Features erweitert.

API-Endpunkte für die eingestellten Versionen funktionieren nicht mehr nach den entsprechenden Datumsangaben. Die Google Ads API gibt einen Fehler aus, wenn Sie versuchen, auf die API-Endpunkte der eingestellten Versionen zuzugreifen.
Clientbibliotheken Zur Bereitstellung kompakter Clientbibliotheken werden nach dem Einstellungsdatum verworfene API-Versionen nicht mehr in eine neue Version der Clientbibliothek aufgenommen. So sparen Sie Platz, wenn Sie unsere Clientbibliotheken in Ihre Projekte einbinden. Die eingestellten API-Versionen in neuen Clientbibliotheksversionen werden nach dem Einstellungsdatum nicht mehr von den Clientbibliotheken unterstützt.
Support Die eingestellten Versionen werden regelmäßig unterstützt. Diese Versionen werden nach dem Einstellungsdatum nicht mehr unterstützt.

Unterstützte Versionen der Clientbibliotheken

Die Tabelle zeigt, welche Clientbibliotheken mit welchen API-Versionen funktionieren.

Java

Clientbibliothek für Java
v16 Min: 30.0.0
Max: –
v15 Min: 28.0.0
Max: –
v14 Min: 26.0.0
Max: 30.0.0

C#

Clientbibliothek für .NET
v16 Min: 18.1.0
Max: –
v15 Min: 17.1.0
Max: –
v14 Min: 16.1.0
Max: 19.0.1

PHP

Clientbibliothek für PHP
v16 Min: 22.1.0
Max: –
v15 Min: 21.1.0
Max: –

Python

Clientbibliothek für Python
v16 Min: 23.1.0
Max: –
v15 Min: 22.1.0
Max: –

Ruby

Clientbibliothek für Ruby
v16 Min: 27.0.0
Max: –
v15 Min: 25.0.0
Max: –
v14 Min: 23.0.0
Max: –

Perl

Clientbibliothek für Perl
v16 Min: 21.0.0
Max: –
v15 Min: 19.0.0
Max: –
v14 Min: 17.0.0
Max: 21.0.0

Verworfene Features

Im Google Ads-Entwicklerblog sollten Sie regelmäßig über geplante Funktionen informiert werden, die bald eingestellt werden.

In der folgenden Tabelle sind die Funktionen aufgeführt, die derzeit für die Google Ads API eingestellt werden. Weitere Informationen zu jeder Einstellung finden Sie in den verlinkten Blogposts.

Funktion Beschreibung Gültig seit Ergänzende Hinweise
Gebotsstrategie „Provisionen“ Die Google Ads API unterstützt das Erstellen von Hotelkampagnen mit der Gebotsstrategie COMMISSION nicht mehr . 30. April 2024 Anfragen zum Erstellen neuer Hotelkampagnen oder zum Anwenden der Gebotsstrategie COMMISSION auf vorhandene Kampagnen führen zum Fehler BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED. Bestehende Kampagnen mit der Gebotsstrategie COMMISSION laufen noch bis zum 31. Oktober 2024. Nach diesem Tag werden Kampagnen erst wieder ausgeliefert, wenn die Gebotsstrategie aktualisiert wurde.