Hub per sviluppatoriStato dell'APISupporto

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:

Fase 1. Recupera un elenco di veicoli e dei relativi KType

Per ottenere un elenco dei veicoli, chiama il getVehicles operazione.

Parametri di query

NomeDescrizioneObbligatorio
marketplaceIdUn identificatore del marketplace in cui opera la risorsa. Per trovare l'ID di un marketplace, consulta ID del marketplace.
Tipo: corda
vehicleTypeIl tipo di veicolo. I valori possibili sono CAR e MOTORBIKE.
Tipo: enum (VehicleType)
pageTokenUn 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
updatedAfterIncludi 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à:

NomeDescrizione
paginationLe nextToken e previousToken valori necessari per recuperare la pagina successiva o precedente dei risultati, se disponibili.
Tipo: Pagination
vehiclesUn 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

NomeDescrizioneObbligatorio
sellerIdUn identificativo del partner di vendita, ad esempio un account commerciante o un codice fornitore.
Tipo: corda
skuUn partner di vendita ha fornito l'identificativo per un'inserzione su Amazon.
Tipo: corda

Parametri di query

NomeDescrizioneObbligatorio
marketplaceIdsUn elenco delimitato da virgole di identificativi del marketplace Amazon per la richiesta.
Tipo: matrice
includedDataUn elenco delimitato da virgole di set di dati da includere nella risposta.
Tipo: < enum (IncludedData) > matrice
No
modeLa modalità di funzionamento della richiesta.
Tipo: enum (Mode)
No
issueLocaleUn 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

NomeDescrizioneObbligatorio
productTypeIl tipo di prodotto Amazon dell'articolo in offerta.
Tipo: corda
patchesUna o più operazioni di patch JSON da eseguire sull'elemento dell'inserzione.
Tipo: < PatchOperation > matrice

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à:

NomeDescrizione
skuUn partner di vendita ha fornito l'identificativo per un'inserzione su Amazon.
Tipo: corda
statusLo stato di invio degli articoli delle inserzioni.
Tipo: enum (Status)
submissionIdL'identificativo univoco dell'invio dell'articolo dell'inserzione.
Tipo: corda
issuesProblemi relativi agli articoli delle inserzioni relativi all'invio degli articoli delle inserzioni.
Tipo: < Issue > matrice
identifiersAttributi 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.


Questa pagina ti è stata utile?