Vehicles API v2024-11-01 Anwendungsfallleitfaden
So verwenden Sie die Fahrzeug-API.
API-Version: 2020-11-01
Was ist die Fahrzeug-API?
Mit der Vertriebspartner-API für Fahrzeuge (Fahrzeug-API) können Sie Informationen über Fahrzeuge abrufen, einschließlich ihrer eindeutigen Identifikatoren. Sie können diese Informationen verwenden, um Kompatibilitätsinformationen für aufgelistete ASINs mit der Listings API bereitzustellen.
Für Artikel, für die Informationen zur Fahrzeugausstattung erforderlich sind, ist eine Liste von Fahrzeugtypen erforderlich. Diese API bietet eine Liste von Fahrzeugen und ihren KTYPE, mit der Sie jeden Artikel in Ihrem Katalog unabhängig voneinander einer Liste von KTypes zuordnen können. Diese Zuordnung kann Amazon dann mithilfe der Listings API zur Verfügung gestellt werden.
Was ist in diesem Handbuch?
In dieser Anleitung wird beschrieben, wie Sie:
- Verwenden Sie die Fahrzeug-API, um die neueste Fahrzeugliste abzurufen.
- Aktualisieren Sie die Passungsinformationen für eine ASIN mithilfe der Listings API.
Terminologie
- ASIN: Amazon-Standard-Identifikationsnummer, die einen Artikel im Amazon-Katalog identifiziert.
- K-TYP: Eine numerische Kennung, die einer Fahrzeugdefinition (Marke, Modell, Typ, Jahr) zugeordnet ist und von verschiedenen Marken verwendet wird, um ihre Produkte miteinander zu verknüpfen.
Tutorial 1: Passinformationen zu ASINs angeben
Geben Sie Kompatibilitätsinformationen für Artikel in Ihrem Katalog an.
Voraussetzungen
Um dieses Tutorial abzuschließen, benötigen Sie:
- Autorisierung durch den Verkaufspartner, für den Sie Aufrufe tätigen. Weitere Informationen finden Sie in der Autorisierung von Verkaufspartner-API-Anwendungen.
- Zulassung für die Produktliste Rolle in deinem Entwicklerprofil.
- Die Rolle Produktliste, die auf der App-Registrierungsseite für Ihre App ausgewählt wurde.
Schritt 1. Rufen Sie eine Liste der Fahrzeuge und ihrer KTypes ab
Um eine Liste der Fahrzeuge zu erhalten, rufen Sie die getVehicles Betrieb.
Parameter abfragen
| Name | Beschreibung | Erforderlich |
|---|---|---|
marketplaceId | Eine Kennung für den Marktplatz, auf dem die Ressource tätig ist. Die ID für eine Marketplace-Site finden Sie unter Marktplatz-IDs. Typ: Schnur | Ja |
vehicleType | Der Fahrzeugtyp. Mögliche Werte sind CAR und MOTORBIKE.Typ: Aufzählung ( VehicleType) | Ja |
pageToken | Ein Token, das Sie verwenden können, um die nächste oder vorherige Ergebnisseite abzurufen. Die Antwort beinhaltet pagination wenn die Anzahl der Ergebnisse die Seitengröße überschreitet. Um die nächste Seite mit Ergebnissen abzurufen, rufen Sie den Vorgang mit dem nextToken und fügen Sie dieselben Argumente ein wie der Aufruf, der das Token generiert hat. Um eine vollständige Liste zu erhalten, rufen Sie diese Operation auf, bis keine nextToken in der Antwort. Beachten Sie, dass dieser Vorgang leere Seiten zurückgeben kann.Typ: Schnur | Nein |
updatedAfter | Geben Sie dieses Feld ein, um nur Fahrzeuge abzurufen, die nach dem von Ihnen angegebenen Datum geändert oder zum Amazon-Katalog hinzugefügt wurden. Muss drin sein ISO 8601 Datums-/Uhrzeitformat. Typ: Schnur | Nein |
Beispiel anfordern
GET https://sellingpartnerapi-eu.amazon.com/catalog/2024-11-01/automotive/vehicles?marketplaceId=A1F83G8C2ARO7P&updatedAfter=2024-11-01T01:00:00+01:00&vehicleType=CAR
Antwort
Eine erfolgreiche Antwort umfasst die folgenden Eigenschaften:
| Name | Beschreibung |
|---|---|
pagination | Das nextToken und previousToken Werte, die erforderlich sind, um die nächste oder vorherige Ergebnisseite abzurufen, falls verfügbar.Typ: Pagination |
vehicles | Eine Liste der Fahrzeuge aus dem Amazon-Katalog. Typ: < Vehicle > Reihe |
Beispiel für eine Antwort
{
"pagination": {
"nextToken": "AQICAHhviiXpt-KG7DcOWDoXPW4_B4xAKk9r-8oi43dEh_cI4QF"
},
"vehicles": [
{
"bodyStyle": "MPV",
"driveType": "Front-Wheel Drive",
"energy": "Petrol/Liquified Petroleum Gas (LPG)",
"engineOutput": [
{
"unit": "KILOWATT",
"value": 61.0
},
{
"unit": "HORSEPOWER",
"value": 83.0
}
],
"identifiers": [
{
"standard": "KTYPE",
"value": "100408"
}
],
"lastProcessedDate": "2024-11-01T01:00:00+01:00",
"make": "Dacia",
"manufacturingStartDate": {
"month": 11,
"year": 2013
},
"manufacturingStopDate": {
"month": 12,
"year": 2015
},
"model": "Dokker",
"status": "ACTIVE",
"variantName": "1.6 LPG"
},
{
"bodyStyle": "Closed Off-Road Vehicle",
"driveType": "All-wheel Drive",
"energy": "Petrol",
"engineOutput": [
{
"unit": "KILOWATT",
"value": 100.0
},
{
"unit": "HORSEPOWER",
"value": 136.0
}
],
"identifiers": [
{
"standard": "KTYPE",
"value": "10232"
}
],
"lastProcessedDate": "2024-11-01T01:00:00+01:00",
"make": "Vauxhall",
"manufacturingStartDate": {
"month": 10,
"year": 1998
},
"manufacturingStopDate": {
"month": 10,
"year": 2004
},
"model": "Frontera",
"status": "ACTIVE",
"variantName": "2.2 I"
},
{
"bodyStyle": "Closed Off-Road Vehicle",
"driveType": "All-wheel Drive",
"energy": "Petrol",
"engineOutput": [
{
"unit": "KILOWATT",
"value": 151.0
},
{
"unit": "HORSEPOWER",
"value": 205.0
}
],
"identifiers": [
{
"standard": "KTYPE",
"value": "10233"
}
],
"lastProcessedDate": "2024-11-01T01:00:00+01:00",
"make": "Vauxhall",
"manufacturingStartDate": {
"month": 10,
"year": 1998
},
"manufacturingStopDate": {
"month": 10,
"year": 2004
},
"model": "Frontera",
"status": "ACTIVE",
"variantName": "3.2 I"
},
{
"bodyStyle": "Closed Off-Road Vehicle",
"driveType": "All-wheel Drive",
"energy": "Diesel",
"engineOutput": [
{
"unit": "KILOWATT",
"value": 85.0
},
{
"unit": "HORSEPOWER",
"value": 116.0
}
],
"identifiers": [
{
"standard": "KTYPE",
"value": "10234"
}
],
"lastProcessedDate": "2024-11-01T01:00:00+01:00",
"make": "Vauxhall",
"manufacturingStartDate": {
"month": 10,
"year": 1998
},
"manufacturingStopDate": {
"month": 9,
"year": 2004
},
"model": "Frontera",
"status": "ACTIVE",
"variantName": "2.2 DTI"
}
]
}
Schritt 2. Ordnen Sie Ihre Artikel KTypes zu
Verwenden Sie die Antwort aus dem vorherigen Schritt, um Fahrzeuge auszuwählen, zu denen Ihre Artikel passen. Notieren Sie für jeden Artikel den KTYPE der Fahrzeuge, die zu ihm passen. Diese Liste der KTypes stellen Sie im nächsten Schritt bereit.
Schritt 3. Aktualisieren Sie die Ausstattung mit der Listings API
Um die Passungsinformationen für eine ASIN zu aktualisieren, rufen Sie den patchListingsItem Betrieb. Das patches Der Parameter im Anforderungstext sollte den haben path gleich /attributes/vehicle_fitment und enthalten die Liste der KTypes in value.
Pfadparameter
| Name | Beschreibung | Erforderlich |
|---|---|---|
sellerId | Eine Verkaufspartner-ID, z. B. ein Händlerkonto oder ein Lieferantencode. Typ: Schnur | Ja |
sku | Ein Vertriebspartner hat eine Kennung für ein Amazon-Angebot bereitgestellt. Typ: Schnur | Ja |
Parameter abfragen
| Name | Beschreibung | Erforderlich |
|---|---|---|
marketplaceIds | Eine kommagetrennte Liste von Amazon-Marktplatzkennungen für die Anfrage. Typ: Reihe | Ja |
includedData | Eine kommagetrennte Liste von Datensätzen, die in die Antwort aufgenommen werden sollen. Typ: < Aufzählung ( IncludedData) > Reihe | Nein |
mode | Der Betriebsmodus für die Anfrage. Typ: Aufzählung ( Mode) | Nein |
issueLocale | Ein Gebietsschema für die Lokalisierung von Problemen. Wenn nicht angegeben, wird der Standardsprachcode der ersten Marketplace-Site verwendet. Typ: Schnur | Nein |
Textparameter
| Name | Beschreibung | Erforderlich |
|---|---|---|
productType | Der Amazon-Produkttyp des Angebotsartikels. Typ: Schnur | Ja |
patches | Eine oder mehrere JSON-Patch-Operationen, die für den Artikel in der Liste ausgeführt werden sollen. Typ: < PatchOperation > Reihe | Ja |
Beispiel anfordern
PATCH https://sellingpartnerapi-eu.amazon.com/listings/2021-08-01/items/XXXXXXXXXX/SKU_XXXXXX?includedData=issues&marketplaceIds=A1PA6795UKMFR9
{
"productType": "AUTO_OIL",
"patches": [
{
"op": "replace",
"path": "/attributes/vehicle_fitment",
"value": [
{
"standard": [
{
"value": "ktype",
"language_tag": "de_DE"
}
],
"code": [
{
"value": "10232, 10234, 10233",
"language_tag": "de_DE"
}
],
"note": [
{
"value": "{\"10232,10234\":[[[\"Fahrwerk\",\"für Fahrzeuge mit M-Technik\"]]],\"10233\":[[[\"Fahrwerk\",\"für Fahrzeuge mit M-Technik\"],[\"Motorcode\",\"N47 D20 C\"]]]}",
"language_tag": "de_DE"
}
],
"marketplace_id": "A1PA6795UKMFR9"
}
]
}
]
}
Antwort
Eine erfolgreiche Antwort umfasst die folgenden Eigenschaften:
| Name | Beschreibung |
|---|---|
sku | Ein Vertriebspartner hat eine Kennung für ein Amazon-Angebot bereitgestellt. Typ: Schnur |
status | Der Status der Einreichung des Angebotsartikels. Typ: Aufzählung ( Status) |
submissionId | Die eindeutige Kennung des eingereichten Angebots. Typ: Schnur |
issues | Probleme mit Angebotsartikeln im Zusammenhang mit der Einreichung von Angebotsartikeln. Typ: < Issue > Reihe |
identifiers | Identitätsattribute, die dem Artikel im Amazon-Katalog zugeordnet sind, z. B. die ASIN. Typ: ItemIdentifiers |
Beispiel für eine Antwort
{
"sku": "SKU-XXXX-XXXX",
"status": "ACCEPTED",
"submissionId": "xxxxxxxxxxxxxxxxx",
"issues": []
}
Nutzungsbedingungen
Beim Herunterladen und Verwenden der von dieser API bereitgestellten Daten die Nutzungsbedingungen finden Sie hier gelten und werden von den Nutzern akzeptiert.
Updated 5 days ago
Hat Ihnen diese Seite weitergeholfen?