Einstellung und Außerbetriebnahme

Mit der Veröffentlichung einer neuen Version erhält die verworfene Version ein Ablaufdatum, nach dem sie nicht mehr verfügbar ist. Beachten Sie außerdem die folgenden Richtlinien:

• Wir bemühen uns, jederzeit höchstens fünf Hauptversionen verfügbar zu halten.
• Hauptversionen haben eine Lebensdauer von etwa 12 Monaten—Nebenversionen von 10 Monaten.
• Sie müssen höchstens zweimal pro Jahr ein Upgrade durchführen. Dabei müssen Sie die Upgrades nicht in streng sequenzieller Reihenfolge ausführen. Sie können beispielsweise direkt von Version (N) auf Version (N+2) aktualisieren.

Unsere Clientbibliotheken unterstützen alle verfügbaren Versionen eines Dienstes. Sie können also schrittweise aktualisieren, 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öffentlichungstermine 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 zur Einstellung von API Versionen zu erhalten.

API-Version	Erscheinungsdatum	Ablaufdatum	Leitfaden zur Umstellung
Veröffentlichte Versionen
v21	6. August 2025	August 2026 (vorläufig)	Upgrade von v20 auf v21
v22	15. Oktober 2025	Oktober 2026 (vorläufig)	Upgrade von v21 auf v22
v23	28. Januar 2026	Februar 2027	Upgrade von v22 auf v23
v23.1	25. Februar 2026	Februar 2027	Upgrade von v23 auf v23.1
v23.2	25. März 2026	Februar 2027	Upgrade von v23.1 auf v23.2
v24	22. April 2026	Mai 2027	Upgrade von v23.2 auf v24
v24.1	13. Mai 2026	Mai 2027	Upgrade von v24 auf v24.1
v24.2	24. Juni 2026	Juni 2027	Upgrade von v24.1 auf v24.2
v25	22. Juli 2026	August 2027	Upgrade von v24.2 auf v25
Anstehende Versionen
v25.1	August 2026	August 2027
v25.2	September 2026	August 2027
v26	Oktober 2026	November 2027
v26.1*	November 2026	November 2027

* v26.1 ist aufgrund der Überschneidung mit der Weihnachtszeit als optionale Version gekennzeichnet.

Verwendete Versionen für Ihr Projekt ansehen

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

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 sein. 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.v25.services.GoogleAdsService.Mutate.
4. Optional: Wählen Sie den Zeitraum aus, für den Sie Ihre Anfragen aufrufen möchten.

Unterschiede zwischen Einstellung und Ablauf

Begriff	Einstellung	Ablauf
Definition	Die eingestellte Version ist eine Version, die nicht die neueste ist. Sobald eine neue Version veröffentlicht wird, werden alle vorherigen Versionen als eingestellt.	Die abgelaufene Version kann nicht mehr verwendet werden. Anfragen, die an diese Version gesendet werden, schlagen ab dem Ablaufdatum fehl.
Auswirkungen	Sie können die eingestellten Versionen weiterhin verwenden, bis sie abgelaufen sind, aber die Verweise auf die eingestellten Versionen werden hervorgehoben, um zu zeigen, dass sie nicht mehr die neueste Version sind. Wir empfehlen, so schnell wie möglich auf die neueste Version zu aktualisieren, um von neuen Funktionen zu profitieren.	Sie müssen von den abgelaufenen Versionen sofort aktualisieren, um die Google Ads API verwenden zu können. Wir empfehlen dringend, mithilfe des Leitfadens zur Umstellung auf die neueste Version zu aktualisieren.
Zeitangaben	Im Durchschnitt veröffentlichen wir alle drei bis vier Monate eine neue Version. Die angegebene Version wird also nach etwa drei bis vier Monaten eingestellt.	Wir versuchen, eine Version ein Jahr nach ihrer Veröffentlichung einzustellen.
API	API-Endpunkte für die eingestellten Versionen funktionieren weiterhin wie gewohnt. Sie können über unsere Clientbibliotheken und REST auf unsere API-Endpunkte zugreifen. Eingestellten Versionen werden jedoch keine neuen Funktionen hinzugefügt.	API-Endpunkte für die abgelaufenen Versionen funktionieren nach dem Ablaufdatum nicht mehr. Die Google Ads API gibt einen Fehler zurück, wenn Sie versuchen, auf die API-Endpunkte der abgelaufenen Versionen zuzugreifen.
Clientbibliotheken	Um kompakte Clientbibliotheken bereitzustellen, werden wir eingestellte API-Versionen nach dem Datum der Einstellung nicht mehr in eine neue Clientbibliotheksversionaufnehmen. So können Sie Speicherplatz sparen, wenn Sie unsere Clientbibliotheken in Ihre Projekte einbinden.	Clientbibliotheken unterstützen die abgelaufenen API-Versionen nach dem Ablaufdatum in keiner neuen Clientbibliotheksversion 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.

Die aufgeführte Mindestversion der Clientbibliothek reicht für die Hauptversion der Google Ads API (z. B. v25) aus. Die erforderliche Clientbibliotheksversion für Nebenversionen finden Sie im verlinkten Änderungslog.

Verworfene Features und Änderungen

Auf dieser Seite werden die Lebenszyklen auf API-Versionsebene behandelt. Die Einstellung einzelner Features (z. B. die Einstellung von smarten Kampagnen) und Änderungen an Workflows ohne Versionsangabe (z. B. neue Kampagnenbudgetanforderungen für Demand Gen-Kampagnen) werden separat erfasst.

Informationen zu anstehenden Lebenszyklen von Features und Verhaltensänderungen in aktiven Versionen finden Sie im Leitfaden Verworfene Features und Änderungen ohne Versionsangabe.