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 Veröffentlichungsdaten 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 | 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 Version 24 | 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 |
| Zukünftige Versionen | |||||
| 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 optionale Releases, da sie in die Weihnachtszeit fallen.
Von Ihrem Projekt verwendete Versionen 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.v26.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 nicht die neueste Version. Sobald eine neue Version veröffentlicht wird, werden alle vorherigen Versionen als verworfen markiert. | 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, 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. 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 eingestellten API-Versionen mehr in eine neue Clientbibliotheksversion aufnehmen. So sparen Sie Platz, wenn Sie unsere Clientbibliotheken in Ihre Projekte einbinden. | Die veralteten 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 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. v26) ausreichend. Die erforderliche Version der Clientbibliothek für Nebenversionen finden Sie im verknüpften Änderungsprotokoll.
Java
Google Ads API |
Clientbibliothek für Java |
v26 |
Min: 48.0.0Max: – |
v25 |
Min: 44.0.0Max: – |
v24 |
Min: 43.0.0Max: - |
v23 |
Min: 42.0.0Max: - |
C#
Google Ads API |
Clientbibliothek für .NET |
v26 |
Min: 27.5.0Max: - |
v25 |
Min: 26.1.0Max: – |
v24 |
Min: 25.3.0Max: - |
v23 |
Min: 25.1.0Max: - |
PHP
Google Ads API |
Clientbibliothek für PHP |
v26 |
Min: 35.2.0Max: – |
v25 |
Min: 33.6.0Max: – |
v24 |
Min: 33.3.0Max: - |
v23 |
Min: 32.2.0Max: – |
Python
Google Ads API |
Clientbibliothek für Python |
v26 |
Min: 34.0.0Max: - |
v25 |
Min: 31.2.0Max: - |
v24 |
Min: 30.1.0Max: – |
v23 |
Min: 29.2.0Max: - |
Ruby
Google Ads API |
Clientbibliothek für Ruby |
v26 |
Min: 46.0.0Max: – |
v25 |
Min: 43.0.0Max: – |
v24 |
Min: 40.0.0Max: - |
v23 |
Min: 38.0.0Max: - |
Perl
Google Ads API |
Clientbibliothek für Perl |
v26 |
Min: 36.0.0Max: - |
v25 |
Min: 33.0.0Max: - |
v24 |
Min: 32.0.0Max: – |
v23 |
Min: 31.0.0Max: – |
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.