Guida ai casi d'uso dell'API per veicoli v2024-11-01
Come usare l'API Vehicles.
Versione API: 2020-11-01
Cos'è l'API Vehicles?
Con la Selling Partner API for Vehicles (Vehicles API), puoi recuperare informazioni sui veicoli, inclusi i loro identificatori univoci. Puoi utilizzare queste informazioni per fornire informazioni sulla compatibilità degli ASIN elencati con l'API Listings.
Gli articoli che richiedono informazioni sul montaggio del veicolo richiedono un elenco di KType di veicoli. Questa API fornisce un elenco di veicoli e i relativi KTYPE, che puoi usare per mappare in modo indipendente ogni articolo del tuo catalogo a un elenco di KType. Questa mappatura può quindi essere fornita ad Amazon utilizzando l'API Listings.
Cosa contiene questa guida?
Questa guida descrive come:
- Usa l'API Vehicles per ottenere l'elenco più recente dei veicoli.
- Aggiorna le informazioni sulla compatibilità di un ASIN utilizzando l'API Listings.
Terminologia
- ASIN: numero identificativo standard Amazon che identifica un articolo nel catalogo Amazon.
- TIPO K: Un identificatore numerico associato alla definizione di un veicolo (marca, modello, tipo, anno) e utilizzato da vari marchi per collegare i propri prodotti.
Tutorial 1: Fornisci informazioni sulla compatibilità degli ASIN
Fornisci informazioni sulla compatibilità per gli articoli del tuo catalogo.
Prerequisiti
Per completare questo tutorial, devi avere:
- Autorizzazione del partner di vendita per il quale stai effettuando chiamate. Fai riferimento a Autorizzazione delle applicazioni API per i partner di vendita per ulteriori informazioni.
- Approvazione per Elenco dei prodotti ruolo nel tuo profilo di sviluppatore.
- Il ruolo Offerte di prodotti selezionato nella pagina di registrazione dell'app per la tua applicazione.
Fase 1. Recupera un elenco di veicoli e dei relativi KType
Per ottenere un elenco dei veicoli, chiama il getVehicles
operazione.
Parametri di query
Nome | Descrizione | Obbligatorio |
---|---|---|
marketplaceId | Un identificatore del marketplace in cui opera la risorsa. Per trovare l'ID di un marketplace, consulta ID del marketplace. Tipo: corda | Sì |
vehicleType | Il tipo di veicolo. I valori possibili sono CAR e MOTORBIKE .Tipo: enum ( VehicleType ) | Sì |
pageToken | Un token che puoi utilizzare per recuperare la pagina successiva o la pagina precedente dei risultati. La risposta include pagination quando il numero di risultati supera le dimensioni della pagina. Per visualizzare la pagina successiva dei risultati, chiama l'operazione con nextToken e includono gli stessi argomenti della chiamata che ha prodotto il token. Per ottenere un elenco completo, chiama questa operazione finché non ce n'è nextToken nella risposta. Nota che questa operazione può restituire pagine vuote.Tipo: corda | No |
updatedAfter | Includi questo campo per recuperare solo i veicoli che sono stati modificati o aggiunti al catalogo Amazon dopo la data fornita. Deve essere presente ISO 8601 formato data-ora. Tipo: corda | No |
Esempio di richiesta
GET https://sellingpartnerapi-eu.amazon.com/catalog/2024-11-01/automotive/vehicles?marketplaceId=A1F83G8C2ARO7P&updatedAfter=2024-11-01T01:00:00+01:00&vehicleType=CAR
Risposta
Una risposta con esito positivo include la seguente proprietà:
Nome | Descrizione |
---|---|
pagination | Le nextToken e previousToken valori necessari per recuperare la pagina successiva o precedente dei risultati, se disponibili.Tipo: Pagination |
vehicles | Un elenco di veicoli dal catalogo di Amazon. Tipo: < Vehicle > matrice |
Esempio di risposta
{
"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"
}
]
}
Fase 2 Mappa i tuoi articoli su KTypes
Usa la risposta del passaggio precedente per selezionare i veicoli adatti ai tuoi articoli. Per ogni articolo, registra il KTYPE dei veicoli che lo montano. Fornisci questo elenco di KType nel passaggio successivo.
Fase 3. Aggiorna la compatibilità con l'API Listings
Per aggiornare le informazioni di compatibilità su un ASIN, chiama il patchListingsItem
operazione. Le patches
il parametro nel corpo della richiesta deve avere il path
pari a /attributes/vehicle_fitment
e contengono l'elenco dei KType in value
.
Parametri del percorso
Nome | Descrizione | Obbligatorio |
---|---|---|
sellerId | Un identificativo del partner di vendita, ad esempio un account commerciante o un codice fornitore. Tipo: corda | Sì |
sku | Un partner di vendita ha fornito l'identificativo per un'inserzione su Amazon. Tipo: corda | Sì |
Parametri di query
Nome | Descrizione | Obbligatorio |
---|---|---|
marketplaceIds | Un elenco delimitato da virgole di identificativi del marketplace Amazon per la richiesta. Tipo: matrice | Sì |
includedData | Un elenco delimitato da virgole di set di dati da includere nella risposta. Tipo: < enum ( IncludedData ) > matrice | No |
mode | La modalità di funzionamento della richiesta. Tipo: enum ( Mode ) | No |
issueLocale | Un locale per la localizzazione dei problemi. Se non viene fornito, viene utilizzato il codice della lingua predefinito del primo marketplace. Tipo: corda | No |
Parametri del corpo
Nome | Descrizione | Obbligatorio |
---|---|---|
productType | Il tipo di prodotto Amazon dell'articolo in offerta. Tipo: corda | Sì |
patches | Una o più operazioni di patch JSON da eseguire sull'elemento dell'inserzione. Tipo: < PatchOperation > matrice | Sì |
Esempio di richiesta
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"
}
]
}
]
}
Risposta
Una risposta con esito positivo include la seguente proprietà:
Nome | Descrizione |
---|---|
sku | Un partner di vendita ha fornito l'identificativo per un'inserzione su Amazon. Tipo: corda |
status | Lo stato di invio degli articoli delle inserzioni. Tipo: enum ( Status ) |
submissionId | L'identificativo univoco dell'invio dell'articolo dell'inserzione. Tipo: corda |
issues | Problemi relativi agli articoli delle inserzioni relativi all'invio degli articoli delle inserzioni. Tipo: < Issue > matrice |
identifiers | Attributi di identità associati all'articolo nel catalogo Amazon, come l'ASIN. Tipo: ItemIdentifiers |
Esempio di risposta
{
"sku": "SKU-XXXX-XXXX",
"status": "ACCEPTED",
"submissionId": "xxxxxxxxxxxxxxxxx",
"issues": []
}
Condizioni d'uso
Quando si scaricano e si utilizzano i dati forniti da questa API, le condizioni d'uso trovate qui si applicano e sono accettati dagli utenti.
Updated 5 days ago