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. Das Upgrade muss nicht in strikter sequenzieller Reihenfolge erfolgen. Sie können beispielsweise von Version N direkt auf Version N+2 upgraden.
  • 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 nach und nach ein Upgrade durchführen, 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öffentlichungstermine für zukünftige Versionen. 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 16. Oktober 2024 4. Juni 2025 Upgrade von Version 17 auf Version 18
v17 June 5, 2024 16. Oktober 2024 4. Juni 2025 Upgrade von Version 17 auf Version 18
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

Versionen ansehen, die in Ihrem Projekt verwendet werden

In der Google Cloud Console können Sie eine Liste der Methoden und Dienste aufrufen, die in Ihrem Projekt in letzter Zeit aufgerufen wurden:

  1. Öffnen Sie in der Google Cloud Console die Seite APIs & Dienste.
  2. Klicken Sie in der Tabelle auf Google Ads API.
  3. Auf dem Untertab METRICS sollten Ihre letzten Anfragen in jeder Grafik 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.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

LaufzeitEinstellungSonnenuntergang
Definition Die verworfene Version ist eine Version, die nicht die neueste ist. Sobald eine neue Version veröffentlicht wird, werden alle vorherigen Versionen als veraltet gekennzeichnet. Die eingestellte Version kann nicht mehr verwendet werden. Anfragen, die an diese Version gesendet werden, schlagen am oder nach dem Ablaufdatum fehl.
Implikation 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 von den eingestellten Versionen durchführen, um die Google Ads API verwenden zu können.

Wir empfehlen dringend, mithilfe des Upgrade-Leitfadens auf die aktuelle Version zu aktualisieren.
Dauer Im Durchschnitt veröffentlichen wir alle drei bis vier Monate eine neue Version. Die jeweilige Version wird also nach etwa drei bis vier Monaten eingestellt. Wir planen, eine Version ein Jahr nach der Veröffentlichung einzustellen.
API Die API-Endpunkte für die eingestellten 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.

 Die API-Endpunkte für die eingestellten Versionen funktionieren nach dem Einstellungsdatum nicht mehr. Die Google Ads API gibt einen Fehler zurück, wenn Sie versuchen, auf die API-Endpunkte der eingestellten Versionen zuzugreifen.
Clientbibliotheken Um kompakte Clientbibliotheken bereitzustellen, werden eingestellte API-Versionen nach dem Einstellungsdatum nicht mehr in neue Clientbibliotheksversionen aufgenommen. 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 Wir bieten für die eingestellten Versionen weiterhin regelmäßigen Support an. Die eingestellten Versionen werden nach dem Ablaufdatum nicht mehr unterstützt.

Unterstützte Clientbibliotheksversionen

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

Java

Clientbibliothek für Java
v18 Min: 34.0.0
Max: –
v17 Min: 32.0.0
Max: –
v16 Min: 30.0.0
Max: –

C#

Clientbibliothek für .NET
v18 Min: 21.1.0
Max: –
v17 Min: 20.1.0
Max: –
v16 Min: 18.1.0
Max: –

PHP

Clientbibliothek für PHP
v18 Min: 25.0.0
Max: –
v17 Min: 23.1.0
Max: –
v16 Min: 22.1.0
Max: –

Python

Clientbibliothek für Python
v18 Min: 25.1.0
Max: –
v17 Min: 24.1.0
Max: –
v16 Min: 23.1.0
Max: –

Ruby

Clientbibliothek für Ruby
v18 Min: 31.0.0
Max: –
v17 Min: 29.0.0
Max: –
v16 Min: 27.0.0
Max: –

Perl

Clientbibliothek für Perl
v18 Min: 25.0.0
Max: –
v17 Min: 23.0.0
Max: –
v16 Min: 21.0.0
Max: –

Verworfene Features

Wenn Sie als Erstes über anstehende Einstellung von Funktionen informiert werden möchten, sollten Sie den Google Ads Developer Blog regelmäßig lesen.

In der folgenden Tabelle sind die Funktionen aufgeführt, die für die Google Ads API eingestellt werden. 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. Februar 2025 Wenn Version 16 eingestellt wird, wird für alle GoogleAdsService.Search-Anfragen eine feste Seitengröße von 10.000 Zeilen verwendet.
Gebotsstrategie „Auto-optimierter CPC“ Die Google Ads API unterstützt nicht mehr die Festlegung des auto-optimierten CPC als Gebotsstrategie für Such- und Displaykampagnen. Oktober 2024 Anfragen, das Feld enhanced_cpc_enabled in einer Gebotsstrategie auf TRUE festzulegen, 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.