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:
- Ö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 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. - 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 | 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
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.