In diesem Leitfaden wird erläutert, wie die Merchant API die Versionsverwaltung, Releases und den Lebenszyklus der verschiedenen Versionen handhabt.
Versionsverwaltungsschema
Für die Merchant API wird eine Versionsverwaltungsstrategie auf Sub-API-Ebene verwendet. Das bedeutet, dass jede Merchant API, z. B. Produkte innerhalb der Merchant API, einen eigenen Versionslebenszyklus hat.
Versionsformat 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 als vX dargestellt (z. B. v1, v2). Dies sind produktionsreife Hauptversionen.
Alpha-Unter-API-Versionen:Wenn sich eine Unter-API in der Alphaphase befindet, sind alle ihre Methoden in der Alphaphase. Eine Alpha-Unter-API-Version wird als vXalpha dargestellt (z. B. v1alpha, v2alpha). Sie enthalten experimentelle Early Access-Funktionen, die für Tests und schnelle Iterationen vorgesehen sind. Für Alpha-Versionen gibt es keine Stabilitätsgarantie, sie haben keine definierte Lebensdauer und können mit einer Frist von 30 Tagen geändert oder eingestellt werden.
Versionsänderungen
- Erhöhungen der Hauptversion (z. B. von v1 auf v2): Diese signalisieren abwärtsinkompatible und schwerwiegende Änderungen, die Maßnahmen von Entwicklern erfordern. Nur Breaking Changes von stabilen untergeordneten APIs erhalten eine neue Versionsnummer. Zum Beispiel v1 zu v2.
- Geringfügige Änderungen:Abwärtskompatible Ergänzungen oder Korrekturen werden als Änderungen an der bestehenden Hauptversion dargestellt. Solche Änderungen werden in den Versionshinweisen für die jeweilige Hauptversion beschrieben. Nicht abwärtskompatible Ergänzungen einer untergeordneten API werden in der Alpha-Version der neuesten stabilen Version oder direkt in der neuesten stabilen Version veröffentlicht.
Richtlinie zur Einstellung von Produkten
Wir stellen regelmäßig ältere Versionen der Merchant-Unter-APIs ein. Wir verpflichten uns zu einem 12-monatigen Einstellungszeitraum für stabile Hauptversionen (vX), der mit der offiziellen Einstellungsankündigung beginnt.
Wenn wir beispielsweise die v1-Unter-API für Produkte am 15. Januar 2026 einstellen, wird sie frühestens am 15. Januar 2027 eingestellt. Danach ist die frühere Version der untergeordneten API nicht mehr verfügbar.
Unter-API-Version und Lebenszyklusstatus
In der folgenden Tabelle sind die neuesten Versionen der einzelnen untergeordneten APIs der Merchant API aufgeführt:
| Unter-API | Versionen | Status |
|---|---|---|
| Konten | v1 v1alpha v1beta |
Aktiv Aktiv Eingestellt am 28. Februar 2026 |
| Conversions | v1 v1beta |
Aktiv Eingestellt am 28. Februar 2026 |
| Datenquellen | v1 v1beta |
Aktiv Eingestellt am 28. Februar 2026 |
| Inventare | v1 v1beta |
Aktiv Eingestellt am 28. Februar 2026 |
| Problembehebung | v1 v1beta |
Aktiv Eingestellt am 28. Februar 2026 |
| Partnerprogramm für lokale Feeds | v1 v1beta |
Aktiv Eingestellt am 28. Februar 2026 |
| Benachrichtigungen | v1 v1beta |
Aktiv Eingestellt am 28. Februar 2026 |
| Bestellverfolgung | v1 v1beta |
Aktiv Eingestellt am 28. Februar 2026 |
| Produkte | v1 v1beta |
Aktiv Eingestellt am 28. Februar 2026 |
| Product Studio | v1alpha | Aktiv |
| Werbung | v1 v1beta |
Aktiv Eingestellt am 28. Februar 2026 |
| Kontingent | v1 v1beta |
Aktiv Eingestellt am 28. Februar 2026 |
| Berichte | v1 v1beta |
Aktiv Eingestellt am 28. Februar 2026 |
| Rezensionen | v1alpha v1beta |
Aktiv Eingestellt am 28. Februar 2026 |
Best Practices
- Sehen Sie sich regelmäßig die Versionshinweise und neuesten Updates an, um Informationen zu neuen Versionen, wichtigen Updates, Verbesserungen und Ankündigungen zu Sub-API-Einführungen und ‑Einstellung zu erhalten.
- Wenn eine untergeordnete API zwei oder mehr stabile Versionen hat, empfehlen wir, immer die neueste Version zu verwenden.
- Entwickeln Sie Ihre Anwendung so, dass sie verschiedene Sub-API-Fehler ordnungsgemäß verarbeitet, einschließlich Netzwerkproblemen, Ratenbeschränkungen und den neuen Fehlercodes oder ‑meldungen, die mit neueren Sub-API-Versionen eingeführt werden können.
- Warten Sie nicht, bis eine untergeordnete API-Version eingestellt wird, bevor Sie mit der Planung des Upgrades beginnen. Beginnen Sie mit der Bewertung und dem Testen neuer Versionen, sobald sie verfügbar sind.
- Wenn Sie Funktionsanfragen haben oder Bedenken bezüglich einer Roadmap für eine untergeordnete API äußern möchten, wenden Sie sich mit Fragen oder Feedback an uns. Informationen dazu, wie Sie das Merchant API-Team für technischen Support kontaktieren können, finden Sie unter Support für die Merchant API.