Einstellung und Einstellungsdatum

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 sind bestrebt, jederzeit maximal drei Hauptversionen 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 müssen nicht in streng sequenzieller Reihenfolge upgraden. Sie können beispielsweise direkt von Version (N) auf Version (N+2) upgraden.
  • Die Überschneidung zwischen dem Datum, an dem alle Clientbibliotheken für die neueste Version veröffentlicht werden, und der Version, die eingestellt wird, beträgt mindestens 20 Wochen.

Unsere Clientbibliotheken unterstützen alle verfügbaren Versionen eines Dienstes. Sie können also ein schrittweises 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öffentlichungsdaten für zukünftige Versionen. Nach der Veröffentlichung einer neuen Version sollten Sie schnellstmöglich auf diese Version migrieren.

API-VersionVeröffentlichungsdatumEinstellungsdatumAblaufdatumLeitfaden zur Umstellung
v204. Juni 2025Juni 2026 (vorläufig)Upgrade von Version 19 auf Version 20
v19.116. April 2025 Februar 2026 (vorläufig)
v1926. Februar 2025 Februar 2026 (vorläufig)Upgrade von Version 18 auf Version 19
v1816. Oktober 2024Juni 2025August 2025Upgrade von v17 auf v18

Verwendete Versionen Ihres Projekts ansehen

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

  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 MESSWERTE sollten Ihre letzten Anfragen in den einzelnen Diagrammen 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.v20.services.GoogleAdsService.Mutate.
  4. Optional: Wählen Sie den Zeitraum aus, für den Sie die Anfragen aufrufen möchten.

Unterschiede zwischen Einstellung und Ende des Supports

BegriffEinstellungSonnenuntergang
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 veraltete 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 eingestellten Versionen weiterhin verwenden, bis sie eingestellt werden. Die Verweise auf die eingestellten 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 auf die neueste Version zu aktualisieren, um von den neuen Funktionen zu profitieren.

 Sie müssen sofort ein Upgrade von den eingestellten Versionen vornehmen, um die Google Ads API verwenden zu können.

Wir empfehlen dringend, dass Sie mithilfe des Upgrade-Leitfadens auf die neueste Version aktualisieren.
Dauer Im Durchschnitt veröffentlichen wir alle 3 bis 4 Monate eine neue Version. Die angegebene Version wird also nach etwa 3 bis 4 Monaten eingestellt. Wir möchten eine Version ein Jahr nach ihrer Veröffentlichung einstellen.
API API-Endpunkte für die eingestellten Versionen funktionieren weiterhin wie gewohnt.

Sie können über unsere Clientbibliotheken, REST usw. auf unsere API-Endpunkte zugreifen. Neuen Funktionen werden jedoch keine eingestellten Versionen hinzugefügt.

 API-Endpunkte für die eingestellten Versionen funktionieren nach dem Datum der Einstellung 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 eingestellte API-Versionen nach dem Einstellungsdatum nicht mehr in eine neue Clientbibliotheksversion aufgenommen. So sparen Sie Speicherplatz, wenn Sie unsere Clientbibliotheken in Ihre Projekte einbinden. Clientbibliotheken unterstützen die eingestellten API-Versionen in neuen Clientbibliotheksversionen nach den Ablaufdaten nicht mehr.
Support Wir bieten regulären Support für die eingestellten Versionen. Veraltete 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
v20 Min: 38.0.0
Max: –
v19 Min: 36.0.0
Max: –
v18 Min: 34.0.0
Max: –
v17 Min: 31.0.0
Max: 36.1.0

C#

Clientbibliothek für .NET
v20 Min: 23.0.0
Max: –
v19 Min: 22.1.0
Max: –
v18 Min: 21.1.0
Max: –
v17 Min: 20.1.0
Max: 22.2.0

PHP

Clientbibliothek für PHP
v20 Min: 28.0.0
Max: –
v19 Min: 26.1.0
Max: –
v18 Min: 25.0.0
Max: –
v17 Min: 23.1.0
Max: 27.2.0

Python

Clientbibliothek für Python
v20 Min: 27.0.0
Max: –
v19 Min: 25.2.0
Max: –
v18 Min: 25.1.0
Max: –
v17 Min: 24.1.0
Max: 26.1.0

Ruby

Clientbibliothek für Ruby
v20 Min: 34.0.0
Max: –
v19 Min: 32.0.0
Max: –
v18 Min: 31.0.0
Max: –

Perl

Clientbibliothek für Perl
v20 Min: 27.0.0
Max: –
v19 Min: 26.0.0
Max: –
v18 Min: 25.0.1
Max: –

Verworfene Features

Behalten Sie den Google Ads Developer Blog im Blick, um als Erster über bevorstehende Einstellungen von Funktionen informiert zu werden.

In der folgenden Tabelle sind die spezifischen Einstellungen von Funktionen aufgeführt, die für die Google Ads API geplant sind. Weitere Informationen zu den einzelnen Einstellungen finden Sie in den verlinkten Blogposts.

Funktion Beschreibung Datum des Inkrafttretens Zusätzliche Hinweise
Neue Fehlermeldungen für ungültige Entwicklertokens Ab dem 28. April 2025 wird bei einem ungültigen Entwicklertoken DEVELOPER_TOKEN_INVALID für Version 19.1 und höher und DEVELOPER_TOKEN_NOT_APPROVED für Versionen vor 19.1 zurückgegeben. Ungültige Entwicklertokens haben zuvor OAUTH_TOKEN_HEADER_INVALID zurückgegeben, was weiterhin für ungültige OAuth-Header verwendet wird. 28. April 2025 Diese Änderung wirkt sich nicht auf Nutzer aus, die bereits funktionierende API-Aufrufe haben.