Einstellung und Einstellung

Mit der Veröffentlichung einer neuen Version erhält die verworfene Version ein Ablaufdatum, nach dem sie nicht mehr verfügbar ist. Beachten Sie außerdem Folgendes:

• Es sind jeweils maximal drei Hauptversionen 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) durchführen.
• Zwischen dem Datum, an dem alle Clientbibliotheken für die neueste Version veröffentlicht werden, und dem Datum, an dem die eingestellte Version eingestellt wird, liegen 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, 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	16. Oktober 2024	Februar 2025	24. September 2025
v17.1	7. August 2024	September/Okt. 2024	4. Juni 2025	Upgrade von Version 17 auf Version 18
v17	June 5, 2024	September/Oktober 2024	4. Juni 2025	Upgrade von Version 17 auf Version 18 durchführen
v16.1	24. April 2024	June 5, 2024	5. Februar 2025	Upgrade von Version 16 auf Version 17
v16	21. Februar 2024	June 5, 2024	5. Februar 2025	Upgrade von Version 16 auf Version 17

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:

1. Öffnen Sie in der Google Cloud Console die Seite APIs und Dienste.
2. Klicken Sie in der Tabelle auf Google Ads API.
3. Auf dem Unter-Tab METRICS 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.v18.services.GoogleAdsService.Mutate.
4. Optional: Wählen Sie den Zeitraum aus, für den Sie die Anfragen aufrufen möchten.

Unterschiede zwischen Einstellung und Einstellungsdatum

Laufzeit	Einstellung	Sonnenuntergang
Definition	Die verworfene Version ist eine Version, die nicht die neueste ist. 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 eingestellten Versionen noch bis zu ihrer Einstellung verwenden. Die Verweise auf die eingestellten Versionen werden jedoch nicht mehr hervorgehoben, um anzuzeigen, dass es sich nicht mehr um die neueste Version handelt. Wir empfehlen Ihnen, 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 3 bis 4 Monate eine neue Version, sodass die jeweilige Version nach etwa 3 bis 4 Monaten verworfen wird.	Wir planen, eine Version ein Jahr nach der 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. Es werden jedoch keine neuen Funktionen zu eingestellten Versionen 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	Um kompakte Clientbibliotheken bereitzustellen, werden wir eingestellte API-Versionen nach dem Einstellungsdatum nicht mehr in eine neue Clientbibliotheksversion aufnehmen. So sparen Sie Speicherplatz, wenn Sie unsere Clientbibliotheken in Ihre Projekte einbinden.	Nach dem jeweiligen Ablaufdatum werden die eingestellten API-Versionen in neuen Clientbibliotheksversionen nicht mehr unterstützt.
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

In der Tabelle sehen Sie, welche Clientbibliotheken mit welchen API-Versionen funktionieren.

Verworfene Features

Lesen Sie regelmäßig den Google Ads-Entwicklerblog, um als Erster von anstehenden Funktionen zu erfahren.

In der folgenden Tabelle sind die Funktionen aufgeführt, die derzeit für die Google Ads API eingestellt werden sollen. Weitere Informationen zu den einzelnen Einstellungsvorhaben finden Sie in den verlinkten Blogposts.

Funktion	Beschreibung	Datum des Inkrafttretens	Zusätzliche Hinweise
Bevorstehende Änderungen an der Seitengröße in der Google Ads API	Wenn Version 16 eingestellt wird, können Sie das Feld page_size nicht mehr bei GoogleAdsService.Search-Anfragen festlegen.	Januar 2025	Wird Version 16 eingestellt, wird für alle GoogleAdsService.Search-Anfragen eine feste Seitengröße von 10.000 Zeilen angenommen.
Auto-optimierte CPC-Gebotsstrategie	Die Google Ads API unterstützt den auto-optimierten CPC nicht mehr als Gebotsstrategie für Such- und Displaykampagnen.	Oktober 2024	Anfragen, das Feld enhanced_cpc_enabled in einer Gebotsstrategie auf TRUE zu setzen, führen zu einem BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED-Fehler. Vorhandene Kampagnen mit der Gebotsstrategie „Auto-optimierter CPC“ werden noch bis zum 15. März 2025 ausgeliefert. Danach werden sie automatisch auf manuelle CPC-Gebote (Cost-per-Click) umgestellt.