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. Hier sind einige weitere Richtlinien, 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, Nebenversionen von 10 Monaten.
  • 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.

Unsere Clientbibliotheken unterstützen alle verfügbaren Versionen eines Dienstes, sodass Sie schrittweise ein Upgrade durchführen können, 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 Releasedaten für zukünftige Versionen. Wir empfehlen, 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 Daten ändern können. Abonnieren Sie den Blog, um Erinnerungen zu Ankündigungen zur Einstellung von API-Versionen zu erhalten.

API-VersionReleasedatumAblaufdatumLeitfaden zur Umstellung
Release-Versionen
v2215. Oktober 2025Oktober 2026Upgrade von v21 auf v22
v2328. Januar 2026Februar 2027Upgrade von v22 auf v23
v23.1 25. Februar 2026 Februar 2027 Upgrade von Version 23 auf Version 23.1
v23.2 25. März 2026 Februar 2027 Upgrade von Version 23.1 auf Version 23.2
v24 22. April 2026 Mai 2027 Upgrade von v23.2 auf v24
v24.1 13. Mai 2026 Mai 2027 Upgrade von Version 24 auf Version 24.1
v24.2 24. Juni 2026 Juni 2027 Upgrade von Version 24.1 auf Version 24.2
v25 22. Juli 2026 August 2027 Upgrade von v24.2 auf v25
v25.1 19. August 2026 August 2027 Upgrade von Version 25 auf Version 25.1
v25.2 23. September 2026 August 2027 Upgrade von Version 25.1 auf Version 25.2
Zukünftige Versionen
v26 Oktober 2026 November 2027  
v26.1 Oktober 2026 November 2027  
v26.2 November 2026 November 2027  
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 aufgrund der Überschneidung mit der Weihnachtszeit als optionale Releases gekennzeichnet.

Verwendete Versionen Ihres Projekts ansehen

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

  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 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.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 Einstellung

BegriffEinstellungSonnenuntergang
Definition Die verworfene Version ist eine Version, die nicht die aktuelle ist. Sobald eine neue Version veröffentlicht wird, werden alle vorherigen Versionen als verworfen markiert. 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 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, ein Upgrade auf die aktuelle Version durchzuführen. Verwenden Sie dazu die Upgrade-Anleitung.

Dauer Im Durchschnitt veröffentlichen wir alle 3 bis 4 Monate eine neue Version. Die jeweilige Version wird also nach etwa 3 bis 4 Monaten eingestellt. 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. In eingestellten 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 Speicherplatz, wenn Sie unsere Clientbibliotheken in Ihre Projekte einbinden. Clientbibliotheken unterstützen die veralteten API-Versionen in neuen Clientbibliotheksversionen nach den Ablaufdaten nicht mehr.
Support Wir bieten regulären Support für die eingestellten Versionen. Die veralteten Versionen werden nach dem Ablaufdatum nicht mehr unterstützt.

Unterstützte Versionen der Clientbibliothek

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. v25) ausreichend. Die erforderliche Version der Clientbibliothek für Nebenversionen finden Sie im verknüpften Änderungsprotokoll.

Java

Änderungsprotokoll

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

C#

Änderungsprotokoll

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

PHP

Änderungsprotokoll

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

Python

Changelog

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

Ruby

Changelog

Clientbibliothek für Ruby
v25 Min: 43.0.0
Max: –
v24 Min: 40.0.0
Max: –
v23 Min: 38.0.0
Max: –

Perl

Änderungsprotokoll

Clientbibliothek für Perl
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 hauptsächlich um den Lebenszyklus auf API-Versionsebene. Die Einstellung einzelner Funktionen (z. B. smarter Kampagnen) und Änderungen an Workflows ohne Versionsangabe (z. B. neue Kampagnenbudgetanforderungen 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.