Champs disponibles pour les catalogues d'inventaire des annonces automobiles

Nom

Obligatoire ?

Description

Les utilisateurs peuvent-ils filtrer par cet attribut ?

vehicle_id

type : string

Oui

Nombre maximal de caractères : 100

Identifiant unique de l'élément. Peut être une variante pour un véhicule. S'il existe plusieurs instances du même identifiant, nous ignorons toutes les instances. Vous pouvez également utiliser le numéro d'identification du véhicule (NIV) tant pour vehicle_id que vin. Exemple : 1FADP5AU6DL536022

Oui

title

type : string

Oui

Nombre maximal de caractères : 500

Il est recommandé de ne pas dépasser 40 pour que le titre s'affiche complètement. Nom complet du véhicule. Il est pertinent et spécifique à chaque véhicule et doit contenir les informations relatives à l'année, à la marque, au modèle et à la finition. Exemple : 299 USD par mois pour la EndoHatch GE

Oui

description

type : string

Oui

Nombre maximal de caractères : 5000

Texte court décrivant le véhicule. N'incluez pas de texte promotionnel ni de liens. Ne saisissez pas de texte en lettres capitales. Utilisez des sauts de ligne pour mettre en forme votre description. Exemple : Volvo XC90 2017 d'occasion en excellent état, disponible dès maintenant.

Oui

url

type : url

Oui

Lien vers le site externe où vous pouvez consulter la liste des véhicules. Format HTTP requis.

Non

ios_url

type : url

Non

Lien vers la page de destination de l'application. Si ce champ est rempli et que l'utilisateur a installé l'application, nous passerons d'abord à cette URL. Dans le cas contraire, nous nous rabattrons sur l'url Web.

Non

android_url

type : url

Non

Lien vers la page de destination de l'application. Si rempli et que l'utilisateur a installé l'application, nous passerons d'abord à cette URL. Dans le cas contraire, nous nous rabattrons sur l'url Web

Non

make

type : string

Oui

Maximum 100 caractères

Marque du véhicule. Exemple : Endomoto

Oui

model

type : string

Oui

Maximum 100 caractères

Modèle du véhicule. Exemple : EndoHatch

Oui

year

type : int

Oui

Année de lancement du véhicule au format aaaa. Exemple : 2015

Oui

mileage.value

type : int

Oui

Pour les véhicules d'occasion, le kilométrage actuel du véhicule en kilomètres (km) ou en miles (MI). Pour les véhicules neufs, utiliser zéro (0). Pour Marketplace, les véhicules doivent avoir plus de 500 miles/kms. Exemple : « 1500 ». Valeur supérieure ou égale à 0.

Oui

mileage.unit

type : string

Oui

Unités de kilométrage : MI (miles) ou KM (kilomètres)

Non

image_link

type : string

Oui

Limite de taille et d'aspect de l'image : L'image doit être d'au moins 500x500px, mais nous recommandons un rapport d'aspect 4:3 pour de meilleures performances. La taille idéale de l'image est de 800x600.

Non

transmission

Type : string

Non

Type de transmission du véhicule : Automatique ou manuelle.

Oui

body_style

Type : enum

Oui

Style de carrosserie du véhicule : CONVERTIBLE, COUPE, HATCHBACK, MINIVAN, TRUCK, SUV, SEDAN, VAN, WAGON, CROSSOVER, SMALL_CAR, ou OTHER.

Oui

drivetrain

Type : enum

Non

Transmission du véhicule. Valeurs prises en charge : 4X2, 4X4, AWD, FWD, RWD, Other.

Oui

vin

Type : string

Non

Nombre maximal de caractères : 17. Numéro d'identification du véhicule (NIV). Vous pouvez également utiliser le numéro d'identification du véhicule (NIV) tant pour vehicle_id que vin. Remarque : Le numéro d'identification du véhicule (NIV) doit comporter exactement 17 caractères et n'est pas requis pour les véhicules antérieurs à 1983. Les bateaux ont moins de chiffres et certains véhicules (comme les remorques) n'ont pas besoin de numéro d'identification. Exemple : 1FADP5AU6DL536022

Oui

price

Type : string

Oui

Coût et devise du véhicule. Formattez le prix comme le coût, suivi du code de devise ISO, avec une espace entre le coût et la devise. La devise par défaut est l'USD. Exemple : 18 000 USD, 32 000 USD

Oui

exterior_color

type : string

Oui

Maximum 100 caractères

Couleur du véhicule. Exemple : noir, blanc, bleu, rouge

Oui

state_of_vehicle

type : string

Oui

État actuel du véhicule. Valeurs prises en charge : New, Used, ou CPO (certified pre-owned).

Oui

fuel_type

type : string

Non

Type de carburant du véhicule. Valeurs prises en charge : DIESEL, ELECTRIC, FLEX, GASOLINE, HYBRID, OTHER.

Oui

condition

type : string

Non

État du véhicule. Valeurs prises en charge : EXCELLENT, GOOD, FAIR, POOR, OTHER.

Oui

sale_price

type : string

Non

Prix de vente ou prix spécial. Formattez le prix comme le coût, suivi du code de devise ISO, avec une espace entre le coût et la devise. Exemple : 16 000 USD

Oui

availability

type : enum

Non

Disponibilité du véhicule : Disponible ou non disponible. Nous ne présentons pas les véhicules qui ne sont pas disponibles dans l'annonce.

Oui

vehicle_type

type : string

Non

Type de véhicule. Valeurs attendues : car_truck (valeur par défaut si non fournie), bateau, commercial, moto, sports motorisés, camping-car, remorque, ou autre.

Oui

trim

type : string

Non

Nombre maximal de caractères : 50

Finition du véhicule. Exemple : 5DR HB SE

Oui

interior_color

type : string

Non

Nombre maximal de caractères : 100

Couleur intérieure du véhicule.

Oui

date_first_on_lot

type : string

Non

Date à laquelle ce véhicule est arrivé chez le concessionnaire. Utilisé pour indiquer l'âge de l'inventaire. Utilisez le format aaaa-mm-jj. Exemple : 2018-09-05

Oui

days_on_lot

type : int

Non

Nombre de jours depuis lesquels le véhicule se trouve sur le terrain. Doit être incrémenté quotidiennement. Valeur supérieure ou égale à 0. Exemple : 62

Oui

custom_number_0

custom_number_1

custom_number_2

custom_number_3

custom_number_4

type : string

Non

Jusqu'à cinq champs personnalisés pour toute information supplémentaire liée aux numéros sur laquelle vous souhaitez filtrer les éléments lorsque vous créez des ensembles. Ce champ vous permet de filtrer par plages de nombres (est supérieur à et est inférieur à) lorsque vous créez un ensemble. Par exemple, vous pouvez utiliser ce champ pour indiquer l'année de production d'un article, puis filtrer une certaine plage d'années dans un ensemble.

Ce champ accepte les nombres entiers compris entre 0 et 4294967295. Il ne prend pas en charge les nombres négatifs, les nombres décimaux ou les virgules, tels que -2, 5,5 ou 10 000. Exemple : 2022

Oui

Nom

Description

Obligatoire ?

Style de format d'adresse 1 : Adresse complète (ne pas utiliser les deux styles)

address

type : string

Adresse physique complète du concessionnaire, formatée comme suit : {addr 1: [RUE], city: [VILLE], region: [ÉTAT, COMTÉ, RÉGION OU PROVINCE], country: [PAYS]. Le code postal est facultatif. Exemple : {addr1: '550 Auto Center Dr', city: 'Watsonville', region : 'CA', postal_code: '96075', country: 'US'}

Oui

Style de format d'adresse 2 : Adresse complète (ne pas utiliser les deux styles)

address.addr1

type : string

L'adresse de votre concessionnaire (rue et numéro). Exemple : 123 Foxglove Rd

Oui

address.city

type : string

Ville où se trouve le concessionnaire. Exemple : Palo Alto

Oui

address.region

type : string

État, comté, région ou province où la concession est située. Exemple : Californie

Oui

address.country

type : string

Pays où se trouve le concessionnaire. Exemple : États-Unis

Oui

latitude

type : float

Latitude de l'emplacement de la concession. Exemple : 37.484100

Oui

longitude

type : float

Longitude de l'emplacement de la concession. Exemple : -122.148252

Oui

address.postal_code

type : string

Code postal du concessionnaire (en dehors des États-Unis ou code postal aux États-Unis) Exemple : 75008 (Paris, France) ou 94025 (Menlo Park)

Non

Identifiants supplémentaires facultatifs pour les concessionnaires

dealer_id

type : string

Nombre maximal de caractères : 100

ID alphanumérique du concessionnaire.

Non

dealer_name

type : string

Nombre maximal de caractères : 100

Nom du concessionnaire.

Non

dealer_phone

type : string

Numéro de téléphone du concessionnaire. Exigences : Doit afficher le bouton d'appel sur une liste Marketplace et doit être un format de numéro de téléphone valide. Doit inclure le code du pays. Exemple : +1 3603453333, 001 (360)345-3333

Non

stock_number

type : string

Désignation par le concessionnaire de la voiture sur son terrain. Le numéro de stock permet au concessionnaire d'inventorier des véhicules spécifiques. Exemple : N8990

Non