Google Ad Manager API v202602 → v202605 Übergangsleitfaden

Warum ist dieses Upgrade obligatorisch?

Die Google Ad Manager API folgt einem vierteljährlichen Veröffentlichungszyklus mit strikter Lebensdauerpolitik. Jede API-Version (Format v20YYQQ) wird nur für etwa ein Jahr unterstützt. Danach wird die Version deaktiviert und alle SOAP/REST-Anfragen schlagen sofort fehl.

Der Quartalskalender ist vorhersehbar: v202602 (Feb. 2026), v202605 (Mai 2026), v202608 (Aug. 2026), v202611 (Nov. 2026). OrbiAds zielt immer auf die neueste verfügbare Version, aktuell v202605.

Wichtigste Änderungen in v202602

Einstellung von Smart-Banner-Feldern: Veraltete Smart-Banner-Felder auf Creative- und LineItem-Objekten wurden endgültig entfernt. Integrationen müssen auf Adaptive Banners und Fluid-Größen umstellen.
Neue GA4-Dimensionen im ReportService: Sichtbarkeitsdimensionen und GA4-Auktionsmetriken wurden in den SOAP ReportService integriert.
Stärkere OAuth2-Prüfungen: Strengere Sicherheitsprüfungen auf Netzwerkebene für mutative Schreibanfragen.

Was sich zwischen v202602 und v202605 ändert

v202605 bringt wichtige Änderungen, insbesondere in der REST Reporting API. Hier sind die kritischen Punkte aus unseren Integrationstests:

DELETE-Endpunkt aus REST Reporting API entfernt: Es gibt keinen funktionierenden DELETE /v1/networks/{nc}/reports/{id}-Endpunkt. Die URL gibt HTTP 404 zurück. Das Löschen erfolgt nun ausschließlich per PATCH auf das Feld visibility: "HIDDEN" (Soft-Delete).
Strikter REST-Metrikkatalog: 75 SOAP-Ära-Metriken (TOTAL_*, AD_SERVER_ALL_REVENUE…) werden vom REST-Engine abgelehnt. Der v202605-Katalog definiert 68 gültige Metriken und 79 gültige Dimensionen.
Korrigierte REST-Datumsbereichsfelder: REST-Payloads verwenden jetzt "relative" (nicht "relativeDateRange") und "fixed" (nicht "fixedDateRange"). Das Filterfeld heißt "filters", nicht "dimensionFilters".
Keine Empfänger-API für Berichte: Das Hinzufügen von E-Mail-Empfängern zu REST-Berichten ist nicht über die API verfügbar — nur über die GAM-Oberfläche.

Die vollständige Liste der Änderungen finden Sie in den offiziellen Google Ad Manager API Release Notes .

OrbiAds-Kompatibilität — v202605

OrbiAds hat seine gesamte Infrastruktur und seinen MCP-Server auf v202605 aktualisiert. Unsere Nutzer müssen keine einzige Zeile Code ändern, um von der neuesten API-Version zu profitieren.

Schritte zur Aktualisierung Ihrer Integrationen

Wenn Sie eigene Skripte über das Python Googleads SDK verwalten, aktualisieren Sie die Version in jedem Service-Aufruf:

# Vorher (Februar 2026)
from googleads import ad_manager
client = ad_manager.AdManagerClient.LoadFromStorage()
line_item_service = client.GetService('LineItemService', version='v202602')

# Nachher (Mai 2026 — aktuelles Ziel)
from googleads import ad_manager
client = ad_manager.AdManagerClient.LoadFromStorage()
line_item_service = client.GetService('LineItemService', version='v202605')

Aktualisieren Sie auch das SDK, um die neuesten WSDL-Schemas zu erhalten:

pip install --upgrade googleads

← Zurück zur Akademie