Mit der Veröffentlichung einer neuen Version wird die eingestellte Version zu einem Ablaufdatum versehen, nach dem die Version nicht mehr verfügbar ist. Beachten Sie auch die folgenden Richtlinien:
- Es sind maximal drei Hauptversionen gleichzeitig verfügbar.
- Hauptversionen haben eine Lebensdauer von etwa 12 Monaten, Nebenversionen: 10 Monate.
- Sie müssen maximal zwei Upgrades pro Jahr durchführen und müssen kein Upgrade in strikter sequenzieller Reihenfolge durchführen. Sie können beispielsweise ein Upgrade von Version (N) direkt auf Version (N+2) ausführen.
- Die Überschneidung zwischen dem Datum, an dem alle Clientbibliotheken für die neueste Version veröffentlicht werden, und der Version, die eingestellt werden soll, beträgt mindestens 20 Wochen.
Unsere Clientbibliotheken unterstützen alle verfügbaren Versionen eines Dienstes. Sie können also schrittweise Upgrades durchführen, indem Sie verschiedene Versionen der verwendeten Dienste angeben.
Fahrplan
In der folgenden Tabelle sind für jede verfügbare Version das jeweilige Einstellungs- und Ablaufdatum sowie das geplante Veröffentlichungsdatum für zukünftige Versionen aufgeführt. Wir empfehlen Ihnen, so schnell wie möglich nach der Veröffentlichung ein Upgrade auf die neueste Version durchzuführen.
API-Version | Veröffentlichungsdatum | Einstellungsdatum | Ablaufdatum | Leitfaden zur Umstellung |
---|---|---|---|---|
v18 | September/Okt. 2024 | Jan./Feb. 2025 | September 2025 | |
v17.1 | Juli/Aug. 2024 | September/Okt. 2024 | Mai 2025 | |
v17 | Mai/Juni 2024 | September/Okt. 2024 | Mai 2025 | |
v16.1 | 24. April 2024 | Mai/Juni 2024 | Januar 2025 | |
v16 | 21. Februar 2024 | Mai/Juni 2024 | Januar 2025 | |
v15 | 18. Oktober 2023 | 21. Februar 2024 | 25. September 2024 | Upgrade von Version 15 auf Version 16 durchführen |
v14.1 | 9. August 2023 | 18. Oktober 2023 | 5. Juni 2024 | |
v14 | 7. Juni 2023 | 18. Oktober 2023 | 5. Juni 2024 | Upgrade von Version 14 auf Version 15 durchführen |
Von Ihrem Projekt verwendete Versionen ansehen
Mit der Google Cloud Console können Sie eine Liste der Methoden und Dienste aufrufen, die Ihr Projekt kürzlich aufgerufen hat:
- Öffnen Sie in der Google Cloud Console die Seite APIs und Dienste.
- Klicken Sie in der Tabelle auf Google Ads API.
- Auf dem Unter-Tab MESSWERTE sollten in jedem Diagramm Ihre letzten Anfragen angezeigt 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, beispielsweise
google.ads.googleads.v17.services.GoogleAdsService.Mutate
. - Optional: Wählen Sie den Zeitraum aus, den Sie für Ihre Anfragen anzeigen möchten.
Unterschiede zwischen Einstellung und Einstellung
Laufzeit | Einstellung | Sonnenuntergang |
---|---|---|
Definition | Die eingestellte Version ist nicht die aktuelle. Sobald eine neue Version veröffentlicht wird, werden alle vorherigen Versionen als verworfen gekennzeichnet. | Die veraltete Version kann nicht mehr verwendet werden. Anfragen, die an diese Version gesendet werden, schlagen am oder nach dem Ablaufdatum fehl. |
Logische Schlussfolgerung | Sie können die verworfenen Versionen weiterhin verwenden, bis sie eingestellt werden. Die Verweise auf die verworfenen Versionen werden jedoch entfernt, um darauf hinzuweisen, dass es sich nicht mehr um die neueste Version handelt.
Wir empfehlen, so schnell wie möglich ein Upgrade auf die neueste Version durchzuführen, um von den neuen Funktionen zu profitieren. |
Sie müssen sofort ein Upgrade der eingestellten Versionen durchführen, um die Google Ads API nutzen zu können.
Wir empfehlen dringend, ein Upgrade auf die neueste Version gemäß dem Upgrade-Leitfaden durchzuführen. |
Dauer | Im Durchschnitt veröffentlichen wir alle drei bis vier Monate eine neue Version, sodass die jeweilige Version nach etwa drei bis vier Monaten verworfen wird. | Wir planen, eine Version ein Jahr nach ihrer Veröffentlichung einzustellen. |
API | API-Endpunkte für die verworfenen Versionen funktionieren weiterhin wie gewohnt.
Sie können über unsere Clientbibliotheken, REST usw. auf unsere API-Endpunkte zugreifen. Allerdings werden den verworfenen Versionen keine neuen Funktionen hinzugefügt. |
Nach dem Ablauf funktionieren die API-Endpunkte für die eingestellten Versionen nicht mehr. Die Google Ads API gibt einen Fehler aus, wenn Sie versuchen, auf die API-Endpunkte der eingestellten Versionen zuzugreifen. |
Clientbibliotheken | Zum Zweck der Bereitstellung kompakter Clientbibliotheken nehmen wir verworfene API-Versionen nach dem Einstellungsdatum nicht mehr in eine neue Version der Clientbibliothek auf. So sparen Sie Platz, wenn Sie unsere Clientbibliotheken in Ihre Projekte einbinden. | Nach dem Ablaufdatum unterstützen Clientbibliotheken die eingestellten API-Versionen in neuen Clientbibliotheksversionen nicht mehr. |
Support | Für die eingestellten Versionen bieten wir regelmäßig Support. | Die eingestellten Versionen werden nach dem Ablaufdatum nicht mehr unterstützt. |
Unterstützte Versionen der Clientbibliothek
Die Tabelle zeigt, welche Clientbibliotheken mit welchen API-Versionen funktionieren.
Java
Google Ads API |
Clientbibliothek für Java |
v16 |
Min: 30.0.0 Max: – |
v15 |
Min: 28.0.0 Max: – |
v14 |
Min: 26.0.0 Max: 30.0.0
|
C#
Google Ads API |
Clientbibliothek für .NET |
v16 |
Min: 18.1.0 Max: – |
v15 |
Min: 17.1.0 Max: – |
v14 |
Min: 16.1.0 Max: 19.0.1 |
PHP
Google Ads API |
Clientbibliothek für PHP |
v16 |
Min: 22.1.0 Max: – |
v15 |
Min: 21.1.0 Max: – |
Python
Google Ads API |
Clientbibliothek für Python |
v16 |
Min: 23.1.0 Max: – |
v15 |
Min: 22.1.0 Max: – |
Ruby
Google Ads API |
Clientbibliothek für Ruby |
v16 |
Min: 27.0.0 Max: – |
v15 |
Min: 25.0.0 Max: – |
v14 |
Min: 23.0.0 Max: 27.0.0
|
Perl
Google Ads API |
Clientbibliothek für Perl |
v16 |
Min: 21.0.0 Max: – |
v15 |
Min: 19.0.0 Max: – |
v14 |
Min: 17.0.0 Max: 21.0.0 |
Verworfene Features
Sie sollten regelmäßig den Google Ads Developer Blog lesen, um als Erster von anstehenden Funktionen zu erfahren.
In der folgenden Tabelle sind die Einstellungen aufgeführt, die derzeit für die Google Ads API eingestellt werden. Weitere Informationen zu den einzelnen Einstellungen finden Sie in den verlinkten Blogposts.
Feature | Beschreibung | Gültig seit | Ergänzende Hinweise |
---|---|---|---|
Gebotsstrategie für Provisionen |
Die Google Ads API
unterstützt das Erstellen von Hotelkampagnen mit der Gebotsstrategie COMMISSION nicht mehr
.
|
30. April 2024 |
Anfragen zum Erstellen neuer Hotelkampagnen oder zum Anwenden der Gebotsstrategie COMMISSION auf vorhandene Kampagnen führen zu einem BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED -Fehler. Bestehende Kampagnen mit der Gebotsstrategie COMMISSION laufen bis zum 31. Oktober 2024 weiter. Nach diesem Tag werden die Anzeigen der Kampagnen erst wieder ausgeliefert, wenn die Gebotsstrategie aktualisiert wurde.
|