汽车广告库存商品库的可用字段

名称

是否必填？

描述

用户是否可使用此属性进行筛选？

vehicle_id

类型：string

是

字符数上限：100

商品的唯一 ID。可以代表一款车型的特定版本。如果有多个实例具有相同 ID，我们会忽略所有实例。你也可以将 VIN 用于 vehicle_id 和 vin 字段。示例：1FADP5AU6DL536022

是

title

类型：string

是

字符数上限：500

建议使用不超过 40 个字符展示完整标题。车辆全名。它与每辆车相关，且是其特有的，应包含年份、生产商、车型、装饰或配置相关的详情。示例：EndoHatch GE 每月 $299

是

description

类型：string

是

字符数上限：5000

描述车辆的简短文案。请勿包含宣传文案或链接。请勿全部以大写字母输入文字。请使用换行符来调整描述的格式。示例：2017 款沃尔沃 XC90 二手车，车况良好，现车有货。

是

URL

类型：URL

是

可以查看车辆列表的外部网站链接。必须为 HTTP 格式。

否

ios_url

类型：URL

否

应用落地页链接。如果已填写，且用户已安装应用，我们将首先跳转到该 URL。否则，我们将返回到网站 URL。

否

android_url

类型：URL

否

应用落地页链接。如果已填写，且用户已安装应用，我们将首先跳转到该 URL。否则，我们将返回到网站 URL

否

make

类型：string

是

字符数上限：100

车辆的生产商或品牌。示例：Endomoto

是

model

类型：string

是

字符数上限：100

车辆型号。示例：EndoHatch

是

year

类型： int

是

车辆投放市场的年份，格式为 yyyy。示例：2015

是

mileage.value

类型：int

是

对于二手车辆，输入以公里 (KM) 或英里 (MI) 为单位的车辆当前里程。对于新车，输入零 (0)。对于要在 Marketplace 平台上列出的车辆，车辆里程必须超过 500 英里/公里。示例：'1500'。值大于或等于 0。

是

mileage.unit

类型：string

是

里程单位：MI（英里）或 KM（公里）

否

image_link

类型：string

是

项目上限：图片像素不得低于 500x500 像素。我们建议使用 4:3 的视频比例，以实现最佳效果。理想的图片尺寸是 800x600。

否

transmission

类型：string

否

车辆的变速箱类型：自动或手动。

是

body_style

类型：enum

是

车身样式：敞篷车、双门轿跑车、掀背车、小型货车、卡车、运动型多用途车、轿车、货车、旅行车、跨界车、小型汽车或其他。

是

drivetrain

类型：enum

否

车辆传动系统。支持的值：四轮两驱、四轮四驱、全轮驱动、前轮驱动、后轮驱动、其他。

是

vin

类型：string

否

字符数上限：17。车辆识别码 (VIN)。你也可以将 VIN 用于 vehicle_id 和 vin 字段。注意：VIN 必须正好是 17 个字符，1983 年以前的车辆不需要填写。船舶识别号的位数相对较少。有些车辆（例如拖车）不需要填写 VIN。示例：1FADP5AU6DL536022

是

price

类型：string

是

车辆的费用金额和币种。价格应表示为费用金额后面加上 ISO 货币代码，两者之间留一个空格。 默认币种为 USD。 示例：18000 USD，32000 USD

是

exterior_color

类型：string

是

字符数上限：100

车辆颜色。 示例：黑色、白色、蓝色、红色

是

state_of_vehicle

类型：string

是

车辆当前状态。支持的值：新车、二手或 CPO（认证二手车）。

是

fuel_type

类型：string

否

车辆燃料类型。支持的值：柴油、电动、灵活燃料、汽油、混合动力、其他。

是

condition

类型：string

否

车辆状况。支持的值：出色、良好、一般、较差、其他。

是

sale_price

类型：string

否

促销价或特价。价格应表示为费用金额后面加上 ISO 货币代码，两者之间留一个空格。示例：16000 USD

是

availability

类型：enum

否

车辆库存情况：有货或无货。我们不会在广告中展示无货车辆。

是

vehicle_type

类型：string

否

交通工具类型。预计值：汽车_卡车（如未提供，则为默认值）、船只、商用车、摩托车、动力运动车、旅居车_露营车、拖车或其他。

是

trim

类型：string

否

字符数上限：50

车辆内饰。示例：5DR HB SE

是

interior_color

类型：string

否

字符数上限：100

车辆内饰颜色。

是

date_first_on_lot

类型：string

否

车辆首次抵达经销商处的日期。用于说明库龄。使用 yyyy-mm-dd 格式。示例：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

否

最多 5 个自定义字段，用于在创建商品系列时按基于数字的附加信息来筛选商品。你可以通过此字段在创建商品系列时按数字范围（大于或小于某个数）筛选商品。例如，你可以使用此字段说明商品制造年份，然后根据特定年份范围的筛选条件创建商品系列。

此字段支持 0 到 4294967295 之间的整数。它不支持负数、小数或带逗号的数字，例如 -2、5.5 或 10,000。 示例：2022

是

名称

描述

是否必填？

地址格式 1：完整地址（请勿同时使用两种格式）

address

类型：string

完整的经销商实际地址，格式为：{addr 1: [STREET ADDRESS], city: [CITY], region: [STATE, COUNTY, REGION OR PROVINCE], country: [COUNTRY]}。邮编为选填项。示例：{addr1: '550 Auto Center Dr', city: 'Watsonville', region: 'CA', postal_code: '96075', country: 'US'}

是

地址格式 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

经销商电话号码。要求：必须在 Marketplace 商品列表页上显示“致电”按钮。必须是有效的电话号码格式。必须包含国家/地区代码。示例：+1 3603453333，001 (360)345-3333

否

stock_number

类型：string

经销商自身对车辆的命名方式。库存编号是经销商清点特定车辆的一种方式。示例：N8990

否