Einstellung und Einstellung

Mit der Veröffentlichung einer neuen Version wird die eingestellte Version zu einem Ablaufdatum versehen, nach dem die Version nicht mehr verfügbar ist. Beachten Sie auch die folgenden Richtlinien:

  • 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 kein Upgrade in strikter sequenzieller Reihenfolge durchführen. Sie können beispielsweise ein Upgrade von Version (N) direkt auf Version (N+2) ausführen.
  • Die Überschneidung zwischen dem Datum, an dem alle Clientbibliotheken für die neueste Version veröffentlicht werden, und der Version, die eingestellt werden soll, beträgt mindestens 20 Wochen.

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

Fahrplan

In der folgenden Tabelle sind für jede verfügbare Version das jeweilige Einstellungs- und Ablaufdatum sowie das geplante Veröffentlichungsdatum 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 Leitfaden zur Umstellung
v18 September/Okt. 2024 Jan./Feb. 2025 September 2025
v17.1 Juli/Aug. 2024 September/Okt. 2024 Mai 2025
v17 Mai/Juni 2024 September/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

Von Ihrem Projekt verwendete Versionen ansehen

Mit der Google Cloud Console können Sie eine Liste der Methoden und Dienste aufrufen, die Ihr Projekt kürzlich 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 in jedem Diagramm Ihre letzten Anfragen angezeigt werden. In der Tabelle Methoden sehen Sie, an welche Methoden Sie Anfragen gesendet haben. Der Methodenname enthält eine Google Ads API-Version, einen Dienst und einen Methodennamen, beispielsweise google.ads.googleads.v17.services.GoogleAdsService.Mutate.
  4. Optional: Wählen Sie den Zeitraum aus, den Sie für Ihre Anfragen anzeigen möchten.

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 verworfen gekennzeichnet. Die veraltete Version kann nicht mehr verwendet werden. Anfragen, die an diese Version gesendet werden, schlagen am oder nach dem Ablaufdatum fehl.
Logische Schlussfolgerung Sie können die verworfenen Versionen weiterhin verwenden, bis sie eingestellt werden. Die Verweise auf die verworfenen Versionen werden jedoch entfernt, um darauf hinzuweisen, dass es sich nicht mehr um die neueste Version handelt.

Wir empfehlen, so schnell wie möglich ein Upgrade auf die neueste Version durchzuführen, um von den neuen Funktionen zu profitieren.

Sie müssen sofort ein Upgrade der eingestellten Versionen durchführen, um die Google Ads API nutzen zu können.

Wir empfehlen dringend, ein Upgrade auf die neueste Version gemäß dem Upgrade-Leitfaden durchzuführen.

Dauer Im Durchschnitt veröffentlichen wir alle drei bis vier Monate eine neue Version, sodass die jeweilige Version nach etwa drei bis vier Monaten verworfen wird. Wir planen, 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. Allerdings werden den verworfenen Versionen keine neuen Funktionen hinzugefügt.

Nach dem Ablauf funktionieren die API-Endpunkte für die eingestellten Versionen nicht mehr. Die Google Ads API gibt einen Fehler aus, wenn Sie versuchen, auf die API-Endpunkte der eingestellten Versionen zuzugreifen.
Clientbibliotheken Zum Zweck der Bereitstellung kompakter Clientbibliotheken nehmen wir verworfene API-Versionen nach dem Einstellungsdatum nicht mehr in eine neue Version der Clientbibliothek auf. So sparen Sie Platz, wenn Sie unsere Clientbibliotheken in Ihre Projekte einbinden. Nach dem Ablaufdatum unterstützen Clientbibliotheken die eingestellten API-Versionen in neuen Clientbibliotheksversionen nicht mehr.
Support Für die eingestellten Versionen bieten wir regelmäßig Support. Die eingestellten Versionen werden nach dem Ablaufdatum nicht mehr unterstützt.

Unterstützte Versionen der Clientbibliothek

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

Java

Clientbibliothek für Java
v17 Min: 32.0.0
Max: –
v16 Min: 30.0.0
Max: –
v15 Min: 28.0.0
Max: –

C#

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

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: –

Perl

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

Verworfene Features

Sie sollten regelmäßig den Google Ads Developer Blog lesen, um als Erster von anstehenden Funktionen zu erfahren.

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

Feature Beschreibung Gültig seit Ergänzende Hinweise
Gebotsstrategie für 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 zu einem BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED-Fehler. Bestehende Kampagnen mit der Gebotsstrategie COMMISSION laufen bis zum 31. Oktober 2024 weiter. Nach diesem Tag werden die Anzeigen der Kampagnen erst wieder ausgeliefert, wenn die Gebotsstrategie aktualisiert wurde.