The following table defines the attributes that you can include in a feed.
Attributes | |
---|---|
vin |
Required String Vehicle Identification Number, a unique alphanumeric identifier for each vehicle. Shown on Google. |
id |
Optional String An internal stock number that's unique for each vehicle. Not shown on Google, but may be used to improve data quality. |
store_code |
Required String An internal identifier that's unique for each dealership. Store codes can be any kind of identifier, such as internal account numbers. Not shown on Google, but may be used to improve data quality. |
place_id |
Optional String The Place ID of the dealership's Business Profile. Not shown on Google, but may be used to improve data quality. |
maps_url |
Optional URL Google Maps URL of the dealership's Business Profile Not shown on Google, but may be used to improve data quality. For more details, see Match with Google Maps URLs. |
dealership_name |
Required String Full dealership name (business name), such as Shown on Google. |
dealership_address |
Required String Full dealership address, which includes the city, postal code, and
country. For example, Shown on Google. |
tracking_phone_number |
Optional Telephone number Phone number used for the vehicle listings experience. If not specified, Google uses the phone number from the dealer's Business Profile. Shown on Google. |
image_link |
Recommended URL The main image for the vehicle. Shown on Google. |
additional_image_link |
Recommended URL, repeated Additional images for the vehicle Shown on Google. |
link |
Recommended URL, UTM/tracking parameters are permitted Link to the dealer's Vehicle Details Page (VDP). Google doesn't add or remove any UTM parameters from the URL provided in the feed, or otherwise modify it. However, UTM parameters are permitted and can be included in the VDP by the provider or dealership. Shown on Google. |
date_in_stock |
Optional Date The date when the vehicle was first available for sale. Give the date in
ISO 8601 format. For example,
Not shown on Google, but may be used to improve data quality. |
price |
Required Price The final sale price for the vehicle. Give the price in
ISO 4217 format. For example,
Shown on Google. |
vehicle_msrp |
Recommended for new vehicles Price MSRP for a vehicle in its current configuration. This attribute only
applies to vehicles with a Give the price in
ISO 4217 format. For example,
Shown on Google. |
condition |
Required String The condition of the vehicle, either new or used. We accept the following values:
Shown on Google. |
certified_pre_owned |
Optional Boolean Indicates whether the vehicle is OEM certified pre-owned. We accept the following values:
Shown on Google. |
make |
Required String Make of the vehicle, such as Shown on Google. |
model |
Required String Model of the vehicle, such as Shown on Google. |
trim |
Required where available String Trim of the model, such as Shown on Google. |
year |
Required Int Model year in the format Shown on Google. |
mileage |
Required for used vehicles Int + Unit Number of miles on the vehicle. For example, Shown on Google. |
exterior_color |
Recommended String OEM-specified exterior color, such as Shown on Google. |
exterior_color_generic |
Optional String Generic exterior color, such as Shown on Google. |
interior_color |
Optional String OEM-specified interior color, such as Shown on Google. |
interior_color_generic |
Optional String Generic interior color, such as Shown on Google. |
body_style |
Optional String The body style of the vehicle, such as Sedan, SUV, or Crossover. The following are some example values:
Shown on Google. |
vehicle_option |
Recommended String, repeated Separated list of the vehicle's standard equipment, along with its
installed options and packages. For example, Shown on Google. |
drive_train |
Optional String Drivetrain specification of the vehicle For example, Shown on Google. |
engine |
Optional String Engine specification of the vehicle For example, Shown on Google. |
fuel |
Optional String Fuel type of the vehicle For example, Shown on Google. |
fuel_efficiency |
Optional String Highway MPG, City MPG, and Combined MPG. For EVs, this attribute can also be used for the EPA's MPG-equivalent rating. For example, Shown on Google. |
ev_battery |
Optional String Battery specification for an EV. For example, Not shown on Google, but may be used to improve data quality. |
ev_range |
Optional String Range for an EV Not shown on Google, but may be used to improve data quality. |
transmission |
Optional String Transmission specification For example, Shown on Google. |
num_doors |
Optional Int Number of doors Shown on Google. |
legal_disclaimer |
Optional String, maximum 3k characters Recommended or legally required disclosures, such as additional taxes or fees. This helps users make informed decisions when they make a purchase. Keep in mind that it's your responsibility to comply with all applicable laws and regulations, and to ensure that all information you provide is accurate. Shown on Google. |
seating_capacity |
Optional Int Number of seats Shown on Google. |
seating_rows |
Optional Int Number of seating rows Not shown on Google, but may be used to improve data quality. |
co2_emission |
Optional String CO2 emission Not shown on Google, but may be used to improve data quality. |
description |
Optional String Free text field for additional information about the vehicle, such as whether it's single owner, has no accidents, or similar. Not shown on Google, but may be used to improve data quality. |
vehicle_fulfillment |
Optional Enum The vehicle's status. Use one of the following values:
Not shown on Google, but may be used to improve data quality. |
vehicle_location |
Optional String The actual location of the car, if different from the dealer
location. For example, Not shown on Google, but may be used to improve data quality. |
vehicle_history_report_link |
Optional URL Link to a vehicle's history report, such as CARFAX Shown on Google. |
monroney_sticker |
Optional URL Link to the Monroney sticker for this vehicle Not shown on Google, but may be used to improve data quality. |