API-Änderungsprotokoll

​

23. Oktober 2026

​

Geändert

• Veraltungsdaten: Veraltete Operationen, Parameter und Felder der öffentlichen API nennen jetzt das Datum, an dem sie als veraltet markiert wurden. Die Daten unten sind der erste Zeitpunkt, zu dem jedes Element in der öffentlichen OpenAPI-Spezifikation markiert wurde.
  • POST /public/v1/toptimize/forecasting/campaign — 2026-08-06. Verwenden Sie POST /public/v1/toptimize/forecasting/campaigns/listing.
  • DELETE /public/v1/media-service/slots/{slot_id}/fallback — 2026-09-10. Der Endpunkt gibt immer 403 zurück. Banner-Fallbacks im Topsort-Dashboard verwalten.
  • sort_by_date bei GET /public/v1/campaign-service/campaigns — 2025-06-19. Verwenden Sie order_by.
  • amountRemaining, amountCarryover und amountUsed in budget — 2025-12-19.
  • bidCount in Kampagnenantworten — 2025-12-19.
  • externalVendorId in Kampagnenantworten — 2022-11-30. Verwenden Sie vendorId.
  • campaignBehaviorData und campaignBehaviorDataByDay in Kampagnenantworten — 2023-08-31.
  • bidsBehaviorData in Gebotsantworten — 2023-09-22.
  • parentId bei Kategorien — 2026-02-09. Verwenden Sie path.
  • ean bei Produkten und teilweisen Produktaktualisierungen — 2026-08-06. Verwenden Sie gtin.

​

16. Oktober 2026

​

Hinzugefügt

• Asynchrone Exporte: Wählen und kombinieren Sie unterstützte Dimensionen und Kennzahlen, einschließlich neuer Optionen, die über frühere Reporting-Endpunkte nicht verfügbar waren. Exportieren Sie größere Datensätze als einzelne Parquet-Datei von bis zu 1 GiB, mit Zeitfenstern von bis zu 31 Tagen und Daten, die bis zu 120 Tage zurückreichen. Exporte laufen im Hintergrund: Fordern Sie einen Export an, erhalten Sie eine ID und laden Sie die Datei herunter, sobald sie bereit ist. Siehe Benutzerdefinierte Datenexporte.
  • /public/v1/export-service/exports (POST)
  • /public/v1/export-service/datasets (GET)
  • /public/v1/export-service/exports/{export_id} (GET)

​

9. Oktober 2026

​

Geändert

• Kampagnenbudget-Antworten: amountRemaining, amountCarryover und amountUsed in den budget-Objekten von Kampagnen sind veraltet. Am 19. Oktober 2026 werden diese Felder vollständig aus den Antworten entfernt. amount und type bleiben unverändert. Dasselbe budget-Objekt wird für Sponsored-Brand-Kampagnen zurückgegeben. Siehe die Referenz zu Get campaigns.

​

Geändert

• Assets-API-Sammlungen: Die fünf Beta-Collection-Endpunkte unten sind seit dem 18. August 2026 veraltet. Sie funktionieren bis zu ihrer Entfernung am 27. August 2026 wie bisher; danach schlagen Anfragen an diese Endpunkte fehl. Endpunkte für einzelne Assets sind nicht betroffen. Siehe die Referenz zur Assets API.
  • /public/v1/assets/collection (POST)
  • /public/v1/assets/collections (GET)
  • /public/v1/assets/collection/{collection-id} (GET, PATCH, DELETE)

​

Geändert

• Kampagnenantworten: promotionType ist seit dem 21. November 2024 als veraltet markiert; verwenden Sie stattdessen adFormat in Kampagnenantworten und formatProperties in Gebotsantworten. Siehe die Referenz zu Get campaigns. Ab dem 23. April 2026 wird promotionType als null zurückgegeben; die Entfernung aus Anfragen und Antworten ist für den 30. April 2026 geplant (vorbehaltlich Bestätigung).

​

Entfernt

• /public/v1/campaign-service/estimated-clicks wurde nach 1 Jahr Deprecation entfernt. Es hat seit 7 Monaten keinen Traffic mehr erhalten.

​

Hinzugefügt

• Endpoint /public/v1/offsite-ads/audiences/user-list zur Verwaltung von Benutzerlisten-Audiences in Offsite-Anzeigen.

​

Geändert

• /v2/auctions: filter-Feld mit AttributesFilter-Schema für die Filterung von Produktattributen hinzugefügt (unterstützt and/or-Operatoren mit Attribut-Array).

​

Geändert

• /v2/auctions: page-Objekt zu Sponsored Listings- und Banner-Auktionsanfragen hinzugefügt.
• /v2/auctions/sponsored-brand: Optionales page-Feld zur Anfrage hinzugefügt.

​

Hinzugefügt

• Endpoints /public/v1/campaign-service/campaigns/exclusive-banner (POST) und /public/v1/campaign-service/campaigns/exclusive-banner/{campaign-id} (GET, PATCH) zur Verwaltung exklusiver Banner-Kampagnen.
• Endpoints /public/v1/campaign-service/campaigns/exclusive-listing (POST) und /public/v1/campaign-service/campaigns/exclusive-listing/{campaign-id} (GET, PATCH) zur Verwaltung exklusiver Listing-Kampagnen.
• Endpoint /public/v1/media-service/slots/{slot-id} mit DELETE- und PATCH-Methoden zur individuellen Slot-Verwaltung.
• POST-Methode zu /public/v1/offsite-ads/audiences hinzugefügt, um Audience-Aufgaben zu erstellen.

​

Hinzugefügt

• Endpoints /public/v1/campaign-service/json-templates (GET, POST) und /public/v1/campaign-service/json-templates/{json-template-id} (GET, PATCH) zur Verwaltung von Kampagnen-JSON-Templates.
• Endpoint /public/v1/media-service/slots (GET, POST) zum Auflisten und Erstellen von Media-Slots.
• Endpoint /public/v1/media-service/slots/{slot-id}/fallback (DELETE) zur Konfiguration des Slot-Fallback-Verhaltens.
• Endpoint /public/v1/offsite-ads/audiences (GET) zum Auflisten von Audiences in Offsite-Anzeigen.
• DELETE-Methode zu /public/v1/campaign-service/campaigns/{campaign-id}/bids hinzugefügt, um alle Gebote zu löschen.

​

Hinzugefügt

• Endpoint /public/v1/toppie/reporting/file-reports/daily-kpis-by-product (GET) zum Export täglicher KPIs nach Produkt.
• Endpoint /public/v1/campaign-service/campaigns/{campaign-id}/products (GET, PUT) zur Verwaltung von Produkten innerhalb einer Kampagne.
• Öffentliche Offsite-Anzeigen-API-Endpoints unter /public/v1/offsite-ads

​

Hinzugefügt

• Endpoints /public/v1/toptimize/forecasting/campaign (POST), /public/v1/toptimize/forecasting/inventory (POST) und /public/v1/toptimize/forecasting/marketplace (GET) für Kampagnen- und Bestandsprognosen.

​

Hinzugefügt

• Beta Offsite-Anzeigen-Endpoints (/v2/offsite-ads/)
• Beta-Endpoint /toptimize/v1/predictions für CTR/CVR-Vorhersagen.
• Beta-Endpoint /toptimize/v1/retrieval für Objekt-Retrieval.
• Endpoint /public/v1/segment-service/segments/{segment-id}/upload (POST) zum Hochladen von Segment-Daten.
• Endpoints /public/v1/campaign-service/campaigns/{campaign-id}/restrictions (GET, POST) und /public/v1/campaign-service/campaigns/{campaign-id}/restrictions/{restriction-id} (PATCH) zur Verwaltung von Kampagnenbeschränkungen.
• Endpoints /public/v1/campaign-service/restriction-types (GET) und /public/v1/campaign-service/restriction-types/{restriction-type-id} (GET) zur Verwaltung von Restriction-Type-Definitionen.
• Endpoint /public/v1/reporting-service/file-reports/scored-attribution (GET) für Scored-Attribution-Dateiberichte.
• Endpoint /public/v1/reporting-service/file-reports/interactions (GET) zum Export von Interaktionsdaten.
• DELETE-Methode zu /public/v1/toppie/campaigns/{campaign-id} hinzugefügt, um Kampagnen zu löschen.

​

Geändert

• Events: Fehlende Referenzen für das neue Pageview-Objekt hinzugefügt.
• /v2/events: Optionale Felder deviceType und channel für Impressions, Clicks, Purchases und Pageviews hinzugefügt.

​

Hinzugefügt

• Beta-Endpoint /toptimize/v1/rank zum Ranking von Objekten.
• Endpoints /public/v1/segment-service/segments (GET, PUT) und /public/v1/segment-service/segments/{segment-id} (DELETE) zur Segment-Verwaltung.
• Endpoint /public/v1/segment-service/segments/{segment-id}/signed-url (GET) zum Abrufen signierter URLs für Segment-Uploads.
• Endpoint /public/v1/toppie/products (GET) zum Auflisten von Vendor-Produkten in Toppie.
• Endpoint /public/v1/reporting-service/interactions (GET) zur Abfrage von Interaktionsdaten.
• Endpoint /public/v1/toppie/account/balance (GET) zum Anzeigen des Kontostands.
• Endpoint /public/v1/toppie/account/topups (GET) zum Anzeigen von Kontoaufladungen.
• Endpoint /public/v1/billing-service/campaign-billing-contact (GET, PUT).
• Endpoints /public/v1/billing-service/billing-contacts (GET) und /public/v1/billing-service/billing-contacts/{billing-contact-id} (GET, PUT) zur Verwaltung von Billing-Kontakten auf Marketplace-Ebene.
• Endpoints /public/v1/billing-service/vendor-billing-contact (PUT) und /public/v1/billing-service/vendors/{external-vendor-id}/vendor-billing-contact/{billing-contact-id} (DELETE) für Billing-Kontakte auf Vendor-Ebene.
• PATCH-Methode zu /public/v1/toppie/campaigns/{campaign-id} hinzugefügt, um Kampagnen zu aktualisieren.

​

Geändert

• /v2/auctions/sponsored-brand: Optionale Felder opaqueUserId und vendorId hinzugefügt.
• Events: Beispiel für Placement-Tracking für Carousel-Analyse hinzugefügt.
• /v2/auctions/travel: Erweitert, um neben Hotels auch Flüge zu unterstützen.

​

Hinzugefügt

• Endpoints /public/v1/toppie/campaigns (GET, POST) und /public/v1/toppie/campaigns/{campaign-id} (GET) zur Verwaltung von Toppie-Kampagnen.
• Endpoint /public/v1/toppie/campaigns/{campaign-id}/bids (GET) zur Verwaltung von Kampagnengeboten.
• Toppie-Reporting-Endpoints (/public/v1/toppie/reporting)
• Endpoints /public/v1/billing-service/vendors/{external-vendor-id}/wallets (GET, POST) und /public/v1/billing-service/vendors/{external-vendor-id}/wallets/{wallet-id}/adjust (POST) zur Verwaltung von Vendor-Wallets.
• PATCH-Methode zu /public/v1/catalog-search-service/catalogs/products hinzugefügt, um Produkte zu aktualisieren.

​

Geändert

• Events: Dokumentiert, dass Halo-Attribution vendorId erfordert.

​

Hinzugefügt

• Endpoint /v2/auctions/travel für Hotel-Reise-Auktionen.
• Beta-Endpoint /v2/events/beta/link-users zum Verknüpfen von Benutzerkonten.
• Endpoints /public/v1/reporting-service/marketplace/campaigns-kpis (GET) und /public/v1/reporting-service/marketplace/vendors-kpis (GET) für KPI-Berichte auf Marketplace-Ebene.