Доступные поля в каталогах товаров для рекламы в категории «Автомобили»

Название

Это обязательное поле?

Описание

Может ли пользователь фильтровать результаты по этому атрибуту?

vehicle_id

Тип: string

Да

Макс. количество знаков: 100

Уникальный идентификатор товара. Может быть модификацией автомобиля. При наличии нескольких одинаковых идентификаторов все они будут игнорироваться. В качестве vehicle_id также можно использовать VIN-код, указанный в поле vin. Пример: 1FADP5AU6DL536022.

Да

title

Тип: string

Да

Макс. количество знаков: 500

Рекомендуется не более 40 знаков, чтобы заголовок отображался полностью. Полное название автомобиля. Здесь можно указать год, марку, модель или модификацию автомобиля, как указано в соответствующих полях. Пример: 299 долл. США в мес. за EndoHatch GE.

Да

description

Тип: string

Да

Макс. количество знаков: 5000

Краткое описание автомобиля. Не включайте рекламный текст или ссылки. Не вводите текст в верхнем регистре. Отформатируйте описание с помощью разрывов строки. Пример: «Подержанный Volvo XC90 2017 г. в отличном состоянии, в наличии».

Да

url

Тип: url

Да

Ссылка на внешний сайт, где можно посмотреть объявление о продаже автомобиля, в формате HTTP.

Нет

URL-адрес iOS [ios_url]

Тип: url

Нет

Ссылка на целевую страницу в приложении. Если это поле заполнено и у пользователя установлено приложение, сначала он будет перенаправлен по этому URL-адресу. В противном случае он перейдет на веб-сайт.

Нет

URL-адрес Android [android_url]

Тип: url

Нет

Ссылка на целевую страницу в приложении. Если это поле заполнено и у пользователя установлено приложение, сначала он будет перенаправлен по этому URL-адресу. В противном случае он перейдет на веб-сайт.

Нет

make

Тип: string

Да

Макс. количество знаков: 100

Марка или бренд автомобиля. Пример: Endomoto.

Да

model

Тип: string

Да

Макс. количество знаков: 100.

Модель автомобиля. Пример: EndoHatch.

Да

year

Тип: int

Да

Год выпуска автомобиля в формате гггг. Пример: 2015.

Да

mileage.value

Тип: int

Да

Для подержанного автомобиля укажите пробег в километрах или милях. Для нового автомобиля укажите 0. На маркетплейсе пробег должен превышать 500 миль или км. Пример: 1500. Значение не меньше 0.

Да

mileage.unit

Тип: string

Да

Единицы измерения пробега: MI (мили) или KM (километры)

Нет

ссылка на изображение [image_link]

Тип: string

Да

Ограничения: допускаются изображения размером не менее 500 x 500 пикселей, но для максимальной эффективности рекомендуется выбрать изображение с соотношением сторон 4 : 3. Идеальный размер изображения: 800 x 600.

Нет

transmission

Тип: string

Нет

Тип коробки передач: автоматическая или ручная.

Да

body_style

Тип: enum

Да

Тип кузова: CONVERTIBLE (С откидным верхом), COUPE (Купе), HATCHBACK (Хетчбэк), MINIVAN (Минивэн), TRUCK (Грузовик), SUV (Внедорожник), SEDAN (Седан), VAN (Фургон), WAGON (Универсал), CROSSOVER (Кроссовер), SMALL_CAR (Мини-автомобиль) или OTHER (Другое).

Да

drivetrain

Тип: enum

Нет

Привод автомобиля. Возможные значения: 4X2, 4X4, AWD (Автоматический полный), FWD (Передний), RWD (Задний), Other (Другое).

Да

vin

Тип: string

Нет

Макс. количество знаков: 17. VIN ― идентификационный номер транспортного средства. VIN-код также можно использовать и для both vehicle_id, и для vin. Примечание. Длина VIN составляет ровно 17 знаков. Для автомобилей, выпущенных до 1983 г., можно не указывать. У идентификаторов судов меньше символов, а некоторым транспортным средствам (например, прицепам) не требуются VIN. Пример: 1FADP5AU6DL536022.

Да

price

Тип: string

Да

Стоимость и валюта. Укажите цену в следующем формате: стоимость, затем через пробел код валюты по ISO. Валюта по умолчанию: USD. Пример: 18000 USD, 32000 USD.

Да

exterior_color

Тип: string

Да

Макс. количество знаков: 100.

Цвет автомобиля. Пример: черный, белый, синий, красный

Да

state_of_vehicle

Тип: string

Да

Новый автомобиль или подержанный. Возможные значения: New (Новый), Used (Подержанный) или CPO (Сертифицированный подержанный).

Да

fuel_type

Тип: string

Нет

Тип топлива. Возможные значения: DIESEL (Дизель), ELECTRIC (Электричество), FLEX (Гибкий выбор топлива), GASOLINE (Бензин), HYBRID (Гибрид), OTHER (Другое).

Да

condition

Тип: string

Нет

Состояние автомобиля. Возможные значения: EXCELLENT (Превосходное), GOOD (Хорошее), FAIR (Среднее), POOR (Плохое), OTHER (Другое).

Да

sale_price

Тип: string

Нет

Цена со скидкой или специальная цена. Укажите цену в следующем формате: стоимость, затем через пробел код валюты по ISO. Пример: 16000 USD

Да

availability

Тип: enum

Нет

Доступность автомобиля: в наличии или нет. В рекламных объявлениях не отображаются автомобили, которых нет в наличии.

Да

vehicle_type

Тип: string

Нет

Тип транспортного средства. Возможные значения: car_truck (легковой/грузовой автомобиль ― по умолчанию), boat (судно), commercial (коммерческое ТС), motorcycle (мотоцикл), powersport (автоспорт), rv_camper (жилой фургон), trailer (прицеп) или other (иное).

Да

trim

Тип: string

Нет

Макс. количество знаков: 50

Комплектация автомобиля. Пример: пятидверный спортивный хетчбэк.

Да

interior_color

Тип: string

Нет

Макс. количество знаков: 100.

Цвет салона.

Да

date_first_on_lot

Тип: string

Нет

Дата первого прибытия на стоянку дилера. Используется для расчета возраста автомобиля. Формат: гггг-мм-дд. Пример: 2018-09-05.

Да

days_on_lot

Тип: int

Нет

Сколько дней автомобиль провел на стоянке. Значение увеличивается каждый день. Значение должно быть не меньше 0. Пример: 62.

Да

custom_number_0

custom_number_1

custom_number_2

custom_number_3

custom_number_4

Тип: string

Нет

До пяти пользовательских полей для дополнительной числовой информации, по которой можно будет фильтровать товары при создании наборов. Это поле используется для фильтрации по диапазонам (больше/меньше указанного значения) для создания набора. Например, в этом поле можно указать год выпуска, а затем создать набор, отфильтровав значения по диапазону лет.

Это поле поддерживает целые числа от 0 до 4294967295. Не поддерживаются отрицательные числа, десятичные дроби, а также числа с пробелами: -2, 5,5 или 10 000. Пример: 2022

Да

Название

Описание

Это обязательное поле?

Формат адреса 1: полный адрес (можно использовать только один из двух форматов).

address

Тип: string

Полный фактический адрес дилера в следующем формате: {addr 1: [УЛИЦА И НОМЕР ДОМА], city: [ГОРОД], region: [ШТАТ, ОКРУГ, РЕГИОН ИЛИ ПРОВИНЦИЯ], country: [СТРАНА]}. Указывать почтовый индекс необязательно. Пример: {addr1: '550 Auto Center Dr', city: 'Уотсонвилл', region: 'Калифорния', postal_code: '96075', country: 'США'}

Да

Формат адреса 2: несколько заголовков (можно использовать только один из двух форматов).

address.addr1

Тип: string

Адрес дилера (улица и номер дома). Пример: 123 Foxglove Rd

Да

address.city

Тип: string

Город, где находится дилер. Пример: Пало-Альто.

Да

address.region

Тип: string

Штат, округ, регион или провинция, где находится дилер. Пример: Калифорния.

Да

address.country

Тип: string

Страна, где находится дилер. Пример: США

Да

latitude

Тип: float

Широта, на которой находится дилер. Пример: 37.484100.

Да

longitude

Тип: float

Долгота, на которой находится дилер. Пример: -122.148252

Да

address.postal_code

Тип: string

Почтовый индекс дилера. Пример: 75008 (Париж, Франция) или 94025 (Менло-Парк, Калифорния)

Нет

Дополнительные необязательные идентификаторы дилера.

dealer_id

Тип: string

Макс. количество знаков: 100.

Буквенно-цифровой идентификатор.

Нет

dealer_name

Тип: string

Макс. количество знаков: 100.

Название дилера.

Нет

dealer_phone

Тип: string

дилера. Примечание. В объявлении на маркетплейсе должна отображаться кнопка вызова. Укажите номер телефона в допустимом формате с кодом страны. Например: +1 3603453333, 001 (360)345-3333

Нет

stock_number

Тип: string

Обозначение, используемое дилером для этого автомобиля. Это учетный номер, назначаемый дилером для целей внутреннего учета. Пример: N8990.

Нет