Einstellung und Einstellungsdatum

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

  • Wir bemühen uns, jederzeit höchstens vier Hauptversionen verfügbar zu halten.
  • Hauptversionen haben eine Lebensdauer von etwa 12 Monaten, Nebenversionen von 10 Monaten.
  • Sie müssen maximal zwei Upgrades pro Jahr durchführen und müssen nicht in streng sequenzieller Reihenfolge upgraden. 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 veröffentlicht werden, und der Version, die eingestellt wird, beträgt mindestens 20 Wochen.

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

Fahrplan

Die folgende Tabelle enthält die entsprechenden Datumsangaben für alle verfügbaren Versionen sowie die voraussichtlichen Veröffentlichungsdaten für zukünftige Versionen. Nach der Veröffentlichung einer neuen Version sollten Sie schnellstmöglich auf diese Version migrieren. Das vorläufige Datum bedeutet, dass die Einstellung jederzeit in diesem Monat erfolgen kann und sich die Daten ändern können. Abonnieren Sie den Blog, um Erinnerungen an die Einstellung von API-Versionen zu erhalten.

API-VersionVeröffentlichungsdatumEinstellungsdatumAblaufdatumLeitfaden zur Umstellung
v216. August 2025Upgrade von Version 20 auf Version 21
v20.16. August 2025Juni 2026 (vorläufig)Upgrade von Version 19 auf Version 20
v204. Juni 2025Juni 2026 (vorläufig)Upgrade von Version 19 auf Version 20
v19.26. August 2025 Februar 2026 (vorläufig)Upgrade von Version 18 auf Version 19
v19.116. April 2025 Februar 2026 (vorläufig)Upgrade von Version 18 auf Version 19
v1926. Februar 2025 Februar 2026 (vorläufig)Upgrade von Version 18 auf Version 19
v1816. Oktober 2024Juni 202520. August 2025

Verwendete Versionen Ihres Projekts ansehen

Sie können eine Liste der Methoden und Dienste, die in Ihrem Projekt in letzter Zeit aufgerufen wurden, in der Google Cloud Console aufrufen:

  1. Öffnen Sie in der Google Cloud Console die Seite APIs & Dienste.
  2. Klicken Sie in der Tabelle auf Google Ads API.
  3. Auf dem Untertab MESSWERTE sollten Ihre letzten Anfragen in den einzelnen Diagrammen dargestellt 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, z. B. google.ads.googleads.v21.services.GoogleAdsService.Mutate.
  4. Optional: Wählen Sie den Zeitraum aus, für den Sie die Anfragen aufrufen möchten.

Unterschiede zwischen Einstellung und Ende des Supports

BegriffEinstellungSonnenuntergang
Definition Die verworfene Version ist eine Version, die nicht die neueste ist. Sobald eine neue Version veröffentlicht wird, werden alle vorherigen Versionen als veraltet gekennzeichnet. Die veraltete Version kann nicht mehr verwendet werden. Anfragen, die an diese Version gesendet werden, schlagen am oder nach dem Ablaufdatum fehl.
Auswirkung Sie können die eingestellten Versionen weiterhin verwenden, bis sie eingestellt werden. Die Verweise auf die eingestellten Versionen werden jedoch nicht mehr hervorgehoben, um zu zeigen, dass sie nicht mehr die aktuelle Version sind.

Wir empfehlen Ihnen, so schnell wie möglich auf die neueste Version zu aktualisieren, um von den neuen Funktionen zu profitieren.

 Sie müssen sofort ein Upgrade von den eingestellten Versionen vornehmen, um die Google Ads API verwenden zu können.

Wir empfehlen dringend, dass Sie mithilfe des Upgrade-Leitfadens auf die neueste Version aktualisieren.
Dauer Im Durchschnitt veröffentlichen wir alle 3 bis 4 Monate eine neue Version. Die angegebene Version wird also nach etwa 3 bis 4 Monaten eingestellt. Wir möchten eine Version ein Jahr nach ihrer Veröffentlichung einstellen.
API API-Endpunkte für die eingestellten Versionen funktionieren weiterhin wie gewohnt.

Sie können über unsere Clientbibliotheken, REST usw. auf unsere API-Endpunkte zugreifen. Neuen Funktionen werden jedoch keine eingestellten Versionen hinzugefügt.

 API-Endpunkte für die eingestellten Versionen funktionieren nach dem Datum der Einstellung nicht mehr. Die Google Ads API gibt einen Fehler aus, wenn Sie versuchen, auf die API-Endpunkte der eingestellten Versionen zuzugreifen.
Clientbibliotheken Um kompakte Clientbibliotheken bereitzustellen, werden eingestellte API-Versionen nach dem Einstellungsdatum nicht mehr in eine neue Clientbibliotheksversion aufgenommen. So sparen Sie Speicherplatz, wenn Sie unsere Clientbibliotheken in Ihre Projekte einbinden. Clientbibliotheken unterstützen die eingestellten API-Versionen in neuen Clientbibliotheksversionen nach den Ablaufdaten nicht mehr.
Support Wir bieten regulären Support für die eingestellten Versionen. Veraltete Versionen werden nach dem Ablaufdatum nicht mehr unterstützt.

Unterstützte Clientbibliotheksversionen

In der Tabelle sehen Sie, welche Clientbibliotheken mit welchen API-Versionen funktionieren.

Java

Clientbibliothek für Java
v21 Min: 39.0.0
Max: –
v20 Min: 38.0.0
Max: –
v19 Min: 36.0.0
Max: –

C#

Clientbibliothek für .NET
v21 Min: 24.0.0
Max: –
v20 Min: 23.0.0
Max: –
v19 Min: 22.1.0
Max: –
v18 Min: 21.1.0
Max: 23.0.0

PHP

Clientbibliothek für PHP
v21 Min: 31.0.0
Max: –
v20 Min: 28.0.0
Max: –
v19 Min: 26.1.0
Max: –
v18 Min: 25.0.0
Max: 30.0.0

Python

Clientbibliothek für Python
v21 Min: 28.0.0
Max: –
v20 Min: 27.0.0
Max: –
v19 Min: 25.2.0
Max: –

Ruby

Clientbibliothek für Ruby
v21 Min: 35.0.0
Max: –
v20 Min: 34.0.0
Max: –
v19 Min: 32.0.0
Max: –
v18 Min: 31.0.0
Max: –

Perl

Clientbibliothek für Perl
v21 Min: 28.0.0
Max: –
v20 Min: 27.0.0
Max: –
v19 Min: 26.0.0
Max: –
v18 Min: 25.0.1
Max: 28.0.0

Verworfene Features

Behalten Sie den Google Ads Developer Blog im Blick, um als Erster über bevorstehende Einstellungen von Funktionen informiert zu werden.

In der folgenden Tabelle sind die spezifischen Einstellungen von Funktionen aufgeführt, die für die Google Ads API geplant sind. Weitere Informationen zu den einzelnen Einstellungen finden Sie in den verlinkten Blogposts.

Funktion Beschreibung Datum des Inkrafttretens Zusätzliche Hinweise
Conversion-Umgebung zur Beeinflussung der Leistung von App-Kampagnen Ab dem 30. September 2025 werden wir nach und nach eine Änderung an Gebotsmodellen einführen. Damit können sie Daten zur Conversion-Umgebung verwenden, die in importierten Conversions enthalten sind, um die Kampagnenleistung zu optimieren. 3. Oktober 2025 Weitere Informationen finden Sie in unserem Blogpost.
Conversions können sowohl `gclid`- als auch `gbraid`-Werte enthalten. Ab dem 3. Oktober 2025 wird für importierte Conversions kein `VALUE_MUST_BE_UNSET`-Fehler mehr zurückgegeben, wenn sowohl das Feld `gclid` als auch das Feld `gbraid` festgelegt sind. 3. Oktober 2025 Weitere Informationen finden Sie in unserem Blogpost.