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-Version | Releasedatum | Ablaufdatum | Leitfaden zur Umstellung |
|---|---|---|---|
| Release-Versionen | |||
| v22 | 15. Oktober 2025 | Oktober 2026 | 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 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:
- Öffnen Sie in der Google Cloud Console die Seite APIs & Dienste.
- Klicken Sie in der Tabelle auf Google Ads API.
- 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. - Optional: Wählen Sie den Zeitraum aus, für den Sie Ihre Anfragen aufrufen möchten.
Unterschiede zwischen Einstellung und Einstellung
| Begriff | Einstellung | Sonnenuntergang |
|---|---|---|
| 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
Google Ads API |
Clientbibliothek für Java |
v25 |
Min: 44.0.0Max: – |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: – |
C#
Google Ads API |
Clientbibliothek für .NET |
v25 |
Min: 26.1.0Max: - |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: – |
PHP
Google Ads API |
Clientbibliothek für PHP |
v25 |
Min: 33.6.0Max: – |
v24 |
Min: 33.3.0Max: – |
v23 |
Min: 32.2.0Max: - |
Python
Google Ads API |
Clientbibliothek für Python |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: - |
v23 |
Min: 29.2.0Max: - |
Ruby
Google Ads API |
Clientbibliothek für Ruby |
v25 |
Min: 43.0.0Max: – |
v24 |
Min: 40.0.0Max: – |
v23 |
Min: 38.0.0Max: – |
Perl
Google Ads API |
Clientbibliothek für Perl |
v25 |
Min: 33.0.0Max: – |
v24 |
Min: 32.0.0Max: – |
v23 |
Min: 31.0.0Max: - |
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.