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 von 10 Monaten.
- Sie müssen maximal zwei Upgrades pro Jahr ausfü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:
- Öffnen Sie in der Google Cloud Console die Seite APIs & Dienste.
- Klicken Sie in der Tabelle auf Google Ads API.
- Auf dem Untertab MESSWERTE 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. - Optional: Wählen Sie den Zeitraum aus, für den Sie die Anfragen aufrufen möchten.
Unterschiede zwischen Einstellung und Einstellungsdatum
| Begriff | 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 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 den Einstellungsdaten werden die eingestellten API-Versionen in neuen Clientbibliotheksversionen nicht mehr unterstützt. |
| Support | Wir bieten für die eingestellten Versionen regelmäßig 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
Google Ads API |
Clientbibliothek für Java |
v18 |
Min: 34.0.0Max: – |
v17 |
Min: 32.0.0Max: – |
v16 |
Min: 30.0.0Max: 34.0.0 |
C#
Google Ads API |
Clientbibliothek für .NET |
v18 |
Min: 21.1.0Max: – |
v17 |
Min: 20.1.0Max: – |
v16 |
Min: 18.1.0Max: – |
PHP
Google Ads API |
Clientbibliothek für PHP |
v18 |
Min: 25.0.0Max: – |
v17 |
Min: 23.1.0Max: – |
v16 |
Min: 22.1.0Max: – |
Python
Google Ads API |
Clientbibliothek für Python |
v18 |
Min: 25.1.0Max: – |
v17 |
Min: 24.1.0Max: – |
v16 |
Min: 23.1.0Max: – |
Ruby
Google Ads API |
Clientbibliothek für Ruby |
v18 |
Min: 31.0.0Max: – |
v17 |
Min: 29.0.0Max: – |
v16 |
Min: 27.0.0Max: – |
Perl
Google Ads API |
Clientbibliothek für Perl |
v18 |
Min: 25.0.1Max: – |
v17 |
Min: 23.0.0Max: – |
v16 |
Min: 21.0.0Max: – |
Verworfene Features
Im Google Ads Developer Blog erfahren Sie als Erstes, welche Funktionen eingestellt werden.
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 |
|---|---|---|---|
| Aktualisierung der Berichte zu Suchbegriffen in der Google Ads API und in Google Ads-Scripts ab dem 3. März 2025 | Ab dem 3. März 2025 werden in der Google Ads API und in Google Ads-Scripts in Berichten zu Suchbegriffen alle Unterkategorien der Suchanfragen als leer zurückgegeben. Dieses Feld wurde bereits aus der Google Ads-Benutzeroberfläche entfernt und wird auch in der API eingeführt, um für Einheitlichkeit in Google Ads zu sorgen. | 3. März 2025 | Ab dem 3. März 2025 sind voraussichtlich alle Werte für
segments.search_subcategory leer. Wenn Sie segments.search_subcategory in den Berichten
campaign_search_term_insight oder
customer_search_term_insight abfragen, prüfen Sie, ob Ihr Code einen leeren Wert in segments.search_subcategory verarbeiten kann.
Ein leerer String ist bereits ein All-Catch-String. Daher sollte Ihr Code dies bereits verarbeiten. Wir empfehlen, segments.search_subcategory aus Ihrer Suchanfrage zu entfernen.
|
| 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. |
| Aktualisierung der Ablauffrist für die Mitgliedschaft beim Kundenabgleich | Ab dem 7. April 2025 sind im Feld UserList.membership_life_span keine Werte mehr zulässig, die größer als 540 sind. |
7. April 2025 | Vom 7. April 2025 bis zum 15. April 2025 führen wir nach und nach eine Änderung am Feld UserList.membership_life_span ein. Bei Anfragen, die das Feld auf einen Wert über 540 setzen, wird der Fehler RangeError.TOO_HIGH zurückgegeben. Alle vorhandenen Nutzerlisten mit einem Feldwert von mehr als 540 werden automatisch so migriert, dass die Gültigkeitsdauer der Mitgliedschaft maximal 540 Tage beträgt. Weitere Informationen finden Sie unter Änderung beim Ablauf der Mitgliedschaft für den Kundenabgleich.
|