Einstellung und Einstellung

Mit der Veröffentlichung einer neuen Version wird eine eingestellte Version ein Ablaufdatum erhält, nach dem diese Version nicht mehr verfügbar. 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 höchstens zwei Upgrades pro Jahr durchführen, in strikter sequenzieller Reihenfolge durchführen. So können Sie zum Beispiel direkt von Version (N) in Version (N+2) zu wechseln.
  • Die Überschneidung zwischen dem Datum, an dem alle Clientbibliotheken für den aktuelle Version und die auslaufende Version mindestens 20 Wochen.

Unsere Clientbibliotheken unterstützen alle verfügbaren Versionen eines ein, sodass Sie schrittweise Upgrades durchführen können, indem Sie verschiedene Versionen der verwendeten Dienstleistungen.

Fahrplan

In der folgenden Tabelle sind die jeweiligen Einstellungs- und Ablauftermine der einzelnen verfügbare Version und prognostizierte Veröffentlichungsdaten für zukünftige Versionen. Mi. empfehlen wir Ihnen, so schnell wie möglich ein Upgrade auf die neueste Version Veröffentlichung.

API-Version Veröffentlichungsdatum Einstellungsdatum Ablaufdatum Leitfaden zur Umstellung
v18 September/Okt. 2024 Jan./Feb. 2025 September 2025
v17.1 7. August 2024 September/Okt. 2024 Mai 2025
v17 June 5, 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 Upgrade von Version 16 auf Version 17 durchführen
v15 18. Oktober 2023 21. Februar 2024 25. September 2024 Upgrade von Version 15 auf Version 16 durchführen

Von Ihrem Projekt verwendete Versionen ansehen

Sie können eine Liste der Methoden und Dienste aufrufen, die Ihr Projekt zuletzt aufgerufen hat mit der Google Cloud Console:

  1. Öffnen Sie die Seite APIs und Dienste.
  2. Klicken Sie in der Tabelle auf Google Ads API.
  3. Auf dem Unter-Tab METRICS sollten Ihre letzten Anfragen für jedes Diagramm. An welche Methoden Sie Anfragen gesendet haben, finden Sie in der Methoden. Der Methodenname eine Google Ads API-Version, einen Dienst und einen Methodennamen wie google.ads.googleads.v17.services.GoogleAdsService.Mutate
  4. Optional: Wählen Sie den Zeitraum aus, den Sie für Ihre Anfragen anzeigen möchten.

Unterschiede zwischen Einstellung und Einstellung

LaufzeitEinstellungSonnenuntergang
Definition Die eingestellte Version ist nicht die aktuelle. Sobald eine neue Version veröffentlicht wurde, werden alle vorherigen Versionen markiert. verworfen. Die veraltete Version kann nicht mehr verwendet werden. Anfragen an dieses Version schlägt am oder nach dem Ablaufdatum fehl.
Logische Schlussfolgerung Sie können die verworfenen Versionen weiterhin verwenden, bis sie eingestellt werden. Die Verweise auf die veralteten Versionen werden jedoch entfernt, dass sie nicht mehr die aktuelle Version sind.

Wir empfehlen Ihnen, so schnell wie möglich ein Upgrade auf die neueste Version durchzuführen, neue Funktionen nutzen können.

Sie müssen das Upgrade von den eingestellten Versionen sofort in um die Google Ads API zu verwenden.

Wir empfehlen dringend, ein Upgrade auf die neueste Version (siehe Upgradeleitfaden).

Dauer Wir veröffentlichen durchschnittlich alle drei bis vier Monate eine neue Version. wird nach etwa 3 bis 4 Monaten verworfen. Wir planen, eine Version ein Jahr nach ihrer Veröffentlichung einzustellen.
API API-Endpunkte für die eingestellten Versionen funktionieren weiterhin als

Sie können über unsere Clientbibliotheken, REST usw. auf unsere API-Endpunkte zugreifen. aktiviert; Allerdings werden veralteten Versionen keine neuen Funktionen hinzugefügt.

API-Endpunkte für die eingestellten Versionen funktionieren nach dem Ablauftermine. Die Google Ads API gibt einen Fehler aus, wenn Sie versuchen, auf die API-Endpunkte der eingestellten Versionen.
Clientbibliotheken Zum Zweck der Bereitstellung kompakter Clientbibliotheken beenden wir Einbeziehung der eingestellten API-Versionen in eine neue Version der Clientbibliothek nach dem Einstellungsdatum. So sparen Sie Platz, wenn Sie in Ihren Projekten verwenden. Die eingestellten API-Versionen in Clientbibliotheken werden nicht mehr unterstützt. neue Client-Bibliotheksversionen nach dem Ablaufdatum zu löschen.
Support Für die eingestellten Versionen bieten wir regelmäßig Support. Die eingestellten Versionen werden nach der Einstellung nicht mehr unterstützt Datum.

Unterstützte Versionen der Clientbibliothek

Die Tabelle zeigt, welche Clientbibliotheken mit welchen API-Versionen funktionieren.

Java

Clientbibliothek für Java
v17 Min:, 32.0.0 und
Max: –
v16 Min:, 30.0.0 und
Max: –
v15 Min: 28.0.0
Max: 32.0.0

C#

Clientbibliothek für .NET
v17 Min:, 20.1.0 und
Max: –
v16 Min:, 18.1.0 und
Max: –
v15 Min: 17.1.0
Max: 20.1.0

PHP

Clientbibliothek für PHP
v17 Min:, 23.1.0 und
Max: –
v16 Min:, 22.1.0 und
Max: –
v15 Min: 21.1.0
Max: 23.1.0

Python

Clientbibliothek für Python
v17 Min:, 24.1.0 und
Max: –
v16 Min:, 23.1.0 und
Max: –
v15 Min:, 22.1.0 und
Max: –

Ruby

Clientbibliothek für Ruby
v17 Min:, 29.0.0 und
Max: –
v16 Min:, 27.0.0 und
Max: –
v15 Min:, 25.0.0 und
Max: –

Perl

Clientbibliothek für Perl
v17 Min:, 23.0.0 und
Max: –
v16 Min:, 21.0.0 und
Max: –
v15 Min:, 19.0.0 und
Max: –

Verworfene Features

Lesen Sie regelmäßig den Google Ads Developer Blog. können Sie als Erster von der bevorstehenden Einstellung von Funktionen erfahren.

In der folgenden Tabelle sind die aktuell eingestellten Funktionen aufgeführt. Google Ads API geplant. Weitere Informationen zu den einzelnen Einstellungen in den verlinkten Blogposts.

Funktion Beschreibung Gültig seit Zusätzliche Hinweise
Gebotsstrategie für Provisionen Google Ads API unterstützt das Erstellen von Hotelkampagnen mit COMMISSION nicht mehr Gebotsstrategie . 30. April 2024 Anfragen zum Erstellen neuer Hotelkampagnen oder zum Anwenden der COMMISSION für bestehende Kampagnen führt, führt das zu einer BiddingStrategyError.BIDDING_STRATEGY_NOT_SUPPORTED Fehler. Bestehende Kampagnen mit der Gebotsstrategie „COMMISSION“ wird die Strategie noch bis zum 31. Oktober 2024 angewendet. Nach diesem Tag Kampagnen werden erst wieder ausgeliefert, wenn die Gebotsstrategie aktualisiert wurde.