In diesem Leitfaden wird erläutert, wie die Merchant API mit Versionierung, Releases und dem Lebenszyklus der verschiedenen Versionen umgeht.
Versionsverwaltungsschema
Die Merchant API verwendet eine Versionierungsstrategie auf Sub-API-Ebene. Das bedeutet, dass jede Merchant API, z. B. Produkte innerhalb der Merchant API, einen eigenen Versionslebenszyklus hat.
Versionierungsformat und -darstellung
Stabile Sub-API-Versionen:Wenn eine Sub-API in einer stabilen Version vorliegt, sind alle ihre Methoden in einer stabilen Version. Eine stabile Sub-API-Version wird dargestellt als vX (z. B. v1, v2). Das sind produktionsreife Hauptversionen.
Alpha-Sub-API-Versionen:Wenn eine Sub-API in einer Alpha-Version vorliegt, sind alle ihre Methoden in der Alpha-Version. Eine Alpha-Sub-API-Version wird als vXalpha dargestellt (z. B. v1alpha, v2alpha). Sie enthalten experimentelle Funktionen für den Vorabzugriff, die für Tests und schnelle Iterationen vorgesehen sind. Für Alpha-Versionen gibt es keine Stabilitätsgarantie, keine definierte Lebensdauer und sie können mit einer Frist von 30 Tagen geändert oder eingestellt werden.
Versionsänderungen
- Erhöhung der Hauptversion (z. B. von v1 zu v2): Diese signalisieren nicht abwärtskompatible und funktionsgefährdende Änderungen, die Maßnahmen von Entwicklern erfordern. Nur funktionsgefährdende Änderungen stabiler Sub-APIs erhalten eine neue Versionsnummer. Beispiel: v1 zu v2.
- Kleinere Änderungen:Abwärtskompatible Ergänzungen oder Fehlerkorrekturen werden als Änderungen an der vorhandenen Hauptversion dargestellt. Solche Änderungen werden in den Versionshinweisen für diese Hauptversion detailliert beschrieben. Nicht funktionsgefährdende Ergänzungen einer Sub-API werden im Alpha-Channel der neuesten stabilen Version oder direkt in der neuesten stabilen Version veröffentlicht.
Einstellungsrichtlinie
Wir stellen regelmäßig ältere Merchant-Sub-API-Versionen ein. Wir garantieren einen 12-monatigen Zeitraum für die Einstellung stabiler Hauptversionen (vX), beginnend mit der offiziellen Ankündigung der Einstellung.
Wenn wir beispielsweise die Sub-API „Produkte“ am 15. Januar 2026 einstellen, wird sie frühestens am 15. Januar 2027 eingestellt. Nach diesem Datum ist die frühere Version der Sub-API nicht mehr verfügbar.
Sub-API-Version und Lebenszyklusstatus
In der folgenden Tabelle sind die neuesten Versionen der einzelnen Sub-APIs der Merchant API aufgeführt:
| Sub-API | Versionen | Status |
|---|---|---|
| Konten | v1 v1alpha v1beta |
Aktiv Aktiv Am 28. Februar 2026 eingestellt |
| Conversions | v1 v1beta |
Aktiv Am 28. Februar 2026 eingestellt |
| Datenquellen | v1 v1beta |
Aktiv Am 28. Februar 2026 eingestellt |
| Inventare | v1 v1beta |
Aktiv Am 28. Februar 2026 eingestellt |
| Problembehebung | v1 v1beta |
Aktiv Am 28. Februar 2026 eingestellt |
| Partnerprogramm für lokale Feeds | v1 v1beta |
Aktiv Am 28. Februar 2026 eingestellt |
| Benachrichtigungen | v1 v1beta |
Aktiv Am 28. Februar 2026 eingestellt |
| Sendungsverfolgung | v1 v1beta |
Aktiv Am 28. Februar 2026 eingestellt |
| Produkte | v1 v1beta |
Aktiv Am 28. Februar 2026 eingestellt |
| Product Studio | v1alpha | Aktiv |
| Werbung | v1 v1beta |
Aktiv Am 28. Februar 2026 eingestellt |
| Quota | v1 v1beta |
Aktiv Am 28. Februar 2026 eingestellt |
| Berichte | v1 v1beta |
Aktiv Am 28. Februar 2026 eingestellt |
| Rezensionen | v1alpha v1beta |
Aktiv Am 28. Februar 2026 eingestellt |
Best Practices
- Prüfen Sie regelmäßig die Versionshinweise und neuesten Updates auf neue Versionen, wichtige Updates, Verbesserungen und Ankündigungen zu Sub-API-Releases und -Einstellungen.
- Wenn für eine Sub-API zwei oder mehr stabile Versionen verfügbar sind, empfehlen wir, immer die neueste Version zu verwenden.
- Entwerfen Sie Ihre Anwendung so, dass verschiedene Sub-API-Fehler ordnungsgemäß verarbeitet werden, einschließlich Netzwerkproblemen, Ratenlimits und den neuen Fehlercodes oder ‑meldungen, die mit neueren Sub-API-Versionen eingeführt werden können.
- Warten Sie nicht, bis eine Sub-API-Version eingestellt wird, um mit der Planung des Upgrades zu beginnen. Beginnen Sie mit der Bewertung und dem Testen neuer Versionen, sobald sie verfügbar sind.
- Bei Funktionsanfragen oder Bedenken bezüglich der Roadmap einer Sub-API können Sie sich mit Fragen oder Feedback an uns wenden. Informationen dazu, wie Sie sich an das Merchant API-Team wenden, um technischen Support zu erhalten, finden Sie unter Hilfe zur Merchant API.