Einstellung und Außerbetriebnahme

In der Google Ads API sind jederzeit mehrere aktive Hauptversionen verfügbar. Eine Version gilt nur dann als veraltet, wenn sie explizit als veraltet gekennzeichnet ist. Wir veröffentlichen die Veröffentlichungs- und Einstellungsdaten im Voraus, damit Sie Upgrades planen können. Nach dem Ablaufdatum einer Version ist diese nicht mehr verfügbar. Hier sind einige wichtige Richtlinien zur Versionsverwaltung, die Sie beachten sollten:

  • Wir bemühen uns, maximal fünf Hauptversionen gleichzeitig verfügbar zu halten.
  • Hauptversionen haben eine Lebensdauer von etwa 12 Monaten. Die Lebensdauer von Nebenversionen der API wird nicht separat erfasst. Stattdessen haben Nebenversionen dasselbe Einstellungsdatum wie die entsprechende Hauptversion.
  • Mit jeder Nebenversion wird die entsprechende Hauptversion inkrementell aktualisiert.
  • Alle API-Aufrufe an eine bestimmte Hauptversion werden immer an die neueste entsprechende Nebenversion weitergeleitet. Die Google Ads API unterstützt nicht den Aufruf bestimmter Nebenversionen.
  • Sie müssen maximal zwei Upgrades pro Jahr durchführen und die Upgrades müssen nicht in einer streng sequenziellen Reihenfolge erfolgen. Sie können beispielsweise direkt von Version (N) auf Version (N+2) upgraden.
  • Wenn Sie die Google Ads API noch nicht kennen, empfehlen wir Ihnen, mit v26 zu beginnen.

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 Release- und Einstellungsdaten für jede verfügbare Version sowie die voraussichtlichen Releasedaten für zukünftige Versionen aufgeführt. Wir empfehlen Ihnen, so schnell wie möglich nach der Veröffentlichung ein Upgrade auf die aktuelle Version durchzuführen. Das vorläufige Datum bedeutet, dass die Einstellung jederzeit in diesem Monat erfolgen kann und sich die Termine ändern können. Abonnieren Sie den Blog, um Erinnerungen zu Ankündigungen zur Einstellung von API-Versionen zu erhalten.

API-Version Releasedatum Ablaufdatum Funktionsgefährdende Änderungen und Upgrade Funktionen und Updates Proto-Differenztabelle
Release-Versionen
v23 28. Januar 2026 Februar 2027 Funktionsgefährdende Änderungen in Version 23 (Upgrade-Leitfaden) Funktionen und Updates in Version 23 Unterschiede zwischen v22- und v23-Protokollen
v23.1 25. Februar 2026 Februar 2027 Keine (Nebenversion) Funktionen und Updates in Version 23.1 Unterschiede zwischen v22- und v23-Protokollen
v23.2 25. März 2026 Februar 2027 Keine (Nebenversion) Funktionen und Updates in Version 23.2 Unterschiede zwischen v22- und v23-Protokollen
v23.3 24. Juni 2026 Februar 2027 Keine (Nebenversion) Funktionen und Updates in Version 23.3 Unterschiede zwischen v22- und v23-Protokollen
v24 22. April 2026 Mai 2027 Funktionsgefährdende Änderungen in v24 (Upgrade-Leitfaden) Funktionen und Updates in v24 v23 versus v24 proto diffs
v24.1 13. Mai 2026 Mai 2027 Keine (Nebenversion) Funktionen und Updates in Version 24.1 v23 versus v24 proto diffs
v24.2 24. Juni 2026 Juni 2027 Keine (Nebenversion) Funktionen und Updates in Version 24.2 v23 versus v24 proto diffs
v25 22. Juli 2026 August 2027 Funktionsgefährdende Änderungen in Version 25 (Upgrade-Leitfaden) Funktionen und Updates in Version 25 Unterschiede zwischen v24- und v25-Protokollen
v25.1 19. August 2026 August 2027 Keine (Nebenversion) Funktionen und Updates in Version 25.1 Unterschiede zwischen v24- und v25-Protokollen
v25.2 23. September 2026 August 2027 Keine (Nebenversion) Funktionen und Updates in Version 25.2 Unterschiede zwischen v24- und v25-Protokollen
v26 (aktuellste Version) 14. Oktober 2026 November 2027 Funktionsgefährdende Änderungen in Version 26 (Upgrade-Leitfaden) Funktionen und Updates in Version 26 Unterschiede zwischen v25- und v26-Protokollen
v26.1 28. Oktober 2026 November 2027 Keine (Nebenversion) Funktionen und Updates in Version 26.1 Unterschiede zwischen v25- und v26-Protokollen
v26.2 11. November 2026 November 2027 Keine (Nebenversion) Funktionen und Updates in Version 26.2 Unterschiede zwischen v25- und v26-Protokollen
Zukünftige Versionen
v26.3* Dezember 2026 November 2027      
v27 Januar 2027 Februar 2028      
v27.1 Februar 2027 Februar 2028      
v27.2 Februar 2027 Februar 2028      
v27.3 März 2027 Februar 2028      
v27.4 März 2027 Februar 2028      
v28 April 2027 Mai 2028      
v28.1 April 2027 Mai 2028      
v28.2 Mai 2027 Mai 2028      
v28.3 Mai 2027 Mai 2028      
v28.4 Juni 2027 Mai 2028      
v28.5 Juni 2027 Mai 2028      
v29 Juli 2027 August 2028      
v29.1 Juli 2027 August 2028      
v29.2 August 2027 August 2028      
v29.3 August 2027 August 2028      
v29.4 September 2027 August 2028      
v29.5 September 2027 August 2028      
v30 Oktober 2027 November 2028      
v30.1 Oktober 2027 November 2028      
v30.2 November 2027 November 2028      
v30.3* Dezember 2027 November 2028      

* v26.3 und v30.3 sind optionale Releases, da sie in die Weihnachtszeit fallen.

Von Ihrem Projekt verwendete Versionen ansehen

Sie können eine Liste der Methoden und Dienste, die Ihr Projekt vor Kurzem aufgerufen hat, über die 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 jedem Diagramm 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.v26.services.GoogleAdsService.Mutate.
  4. Optional: Wählen Sie den Zeitraum aus, für den Sie Ihre Anfragen aufrufen möchten.

Unterschiede zwischen Einstellung und Einstellung

BegriffEinstellungSonnenuntergang
Definition Eine Version gilt nur dann als veraltet, wenn sie explizit als veraltet gekennzeichnet ist. In der Google Ads API sind immer mehrere Hauptversionen aktiv. Die eingestellte 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 verworfenen Versionen weiterhin verwenden, bis sie eingestellt werden. Die Verweise auf die verworfenen Versionen werden jedoch nicht mehr hervorgehoben, um zu zeigen, dass es sich nicht mehr um die aktuelle Version handelt.

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

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

Wir empfehlen dringend, dass Sie mithilfe der Upgrade-Anleitung ein Upgrade auf die aktuelle Version durchführen.

Dauer Die Termine für die Einstellung werden im Voraus veröffentlicht. Eine Version gilt nur dann als veraltet, wenn sie ausdrücklich als veraltet gekennzeichnet ist. Wir planen, 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. Verworfenen Versionen werden jedoch keine neuen Funktionen hinzugefügt.

API-Endpunkte für die eingestellten Versionen funktionieren nach dem Ablaufdatum 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 wir nach dem Datum der Einstellung keine veralteten API-Versionen mehr in eine neue Clientbibliotheksversion aufnehmen. So sparen Sie Platz, wenn Sie unsere Clientbibliotheken in Ihre Projekte einbinden. Die eingestellten API-Versionen werden in neuen Clientbibliotheksversionen nach dem Ablaufdatum nicht mehr unterstützt.
Support Wir bieten regelmäßigen Support für die verworfenen Versionen. Die veralteten 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 ist für die Hauptversion der Google Ads API (z. B. v26) ausreichend. Die erforderliche Version der Clientbibliothek für Nebenversionen finden Sie im verknüpften Änderungsprotokoll.

Java

Änderungsprotokoll

Clientbibliothek für Java
v26 Min: 48.0.0
Max: -
v25 Min: 44.0.0
Max: -
v24 Min: 43.0.0
Max: -
v23 Min: 42.0.0
Max: -

C#

Änderungsprotokoll

Clientbibliothek für .NET
v26 Min: 27.5.0
Max: -
v25 Min: 26.1.0
Max: -
v24 Min: 25.3.0
Max: -
v23 Min: 25.1.0
Max: -

PHP

Änderungsprotokoll

Clientbibliothek für PHP
v26 Min: 35.2.0
Max: -
v25 Min: 33.6.0
Max: -
v24 Min: 33.3.0
Max: -
v23 Min: 32.2.0
Max: -

Python

Änderungsprotokoll

Clientbibliothek für Python
v26 Min: 34.0.0
Max: -
v25 Min: 31.2.0
Max: -
v24 Min: 30.1.0
Max: -
v23 Min: 29.2.0
Max: -

Ruby

Änderungsprotokoll

Clientbibliothek für Ruby
v26 Min: 46.0.0
Max: -
v25 Min: 43.0.0
Max: -
v24 Min: 40.0.0
Max: -
v23 Min: 38.0.0
Max: -

Perl

Änderungsprotokoll

Clientbibliothek für Perl
v26 Min: 36.0.0
Max: -
v25 Min: 33.0.0
Max: -
v24 Min: 32.0.0
Max: -
v23 Min: 31.0.0
Max: -

Verworfene Funktionen und Änderungen

Auf dieser Seite geht es um den Lebenszyklus von API-Versionen. Die Einstellung einzelner Funktionen (z. B. die Einstellung von smarten Kampagnen) und nicht versionierte Workflow-Änderungen (z. B. neue Budgetanforderungen für Demand Gen-Kampagnen) werden separat erfasst.

Informationen zu anstehenden Feature-Lebenszyklen und Verhaltensänderungen in aktiven Versionen finden Sie im Leitfaden Einstellung von Features und nicht versionierte Änderungen.