Referencia

Esta guía es una referencia de los formatos de lista y campos compatibles que puedes usar para crear anuncios de automóviles.

Todos los campos de enumeración distinguen mayúsculas de minúsculas.

Anuncios de inventario de automóviles: formatos de lista admitidos

Proporciona tu lista en el formato correcto: CSV, TSV o XML. Una vez que hayas creado el archivo de listas, debes alojarlo en una URL para obtener actualizaciones programadas periódicas.

Formato de la lista Descripción y normas Lista de muestra

Formato de la lista	Descripción y normas	Lista de muestra
CSV	Valores separados por comas. La primera fila especifica el encabezado de la columna. Las filas siguientes contienen los valores correspondientes a cada ruta. Los campos que contengan espacios en blanco o comas deben escribirse entre comillas dobles (""). El uso de comillas dobles dentro de un campo entre comillas dobles debe escaparse con dos comillas dobles consecutivas. Los campos anidados o multivalor, como una imagen, se pueden representar usando valores codificados en JSON o con un conjunto de columnas "planas" de texto sin formato etiquetadas con sintaxis de ruta de JSON. Ejemplo: `(image[0].url`, `image[0].tag[0]`, `image[0].tag[1])`. Es posible utilizar ambas convenciones indistintamente en el mismo archivo. Consulta Ejemplo de lista en CSV/TSV, Ejemplo de dirección en CSV/TSV.	Descargar > Hacer clic con el botón derecho > Guardar enlace como
TSV	Valores separados por tabulaciones. Consulta las normas para CSV. Consulta Ejemplo de lista en CSV/TSV, Ejemplo de dirección en CSV/TSV.	Descargar > Hacer clic con el botón derecho > Guardar enlace como
XML	Este formato suele tener su origen en sistemas automáticos de proveedores de listas o en servidores web. Un conjunto de nodos XML de artículos representa una lista de productos y debe comenzar con una etiqueta de declaración `<?xml`. Consulta Ejemplo de lista XML.	Descargar > Hacer clic con el botón derecho > Guardar enlace como

CSV

Valores separados por comas.

La primera fila especifica el encabezado de la columna. Las filas siguientes contienen los valores correspondientes a cada ruta.
Los campos que contengan espacios en blanco o comas deben escribirse entre comillas dobles (""). El uso de comillas dobles dentro de un campo entre comillas dobles debe escaparse con dos comillas dobles consecutivas.
Los campos anidados o multivalor, como una imagen, se pueden representar usando valores codificados en JSON o con un conjunto de columnas "planas" de texto sin formato etiquetadas con sintaxis de ruta de JSON. Ejemplo: (image[0].url, image[0].tag[0], image[0].tag[1]).
Es posible utilizar ambas convenciones indistintamente en el mismo archivo.

Consulta Ejemplo de lista en CSV/TSV, Ejemplo de dirección en CSV/TSV.

Descargar > Hacer clic con el botón derecho > Guardar enlace como

TSV

Valores separados por tabulaciones. Consulta las normas para CSV.

Consulta Ejemplo de lista en CSV/TSV, Ejemplo de dirección en CSV/TSV.

Descargar > Hacer clic con el botón derecho > Guardar enlace como

XML

Este formato suele tener su origen en sistemas automáticos de proveedores de listas o en servidores web. Un conjunto de nodos XML de artículos representa una lista de productos y debe comenzar con una etiqueta de declaración <?xml.

Consulta Ejemplo de lista XML.

Descargar > Hacer clic con el botón derecho > Guardar enlace como

Ejemplo: archivo TSV delimitado por tabulaciones

vehicle_id title description url make model year mileage.value mileage.unit image[0].url image[0].tag[0] transmission fuel_type body_style drivetrain vin condition price address exterior_color sale_price availability date_first_on_lot state_of_vehicle latitude longitude i2 EndoHatch GE. Turbocharged! Gasoline! http://www.example.com/test g GE http://www.facebook.com/teapic.jpg Gym AUTOMATIC GASOLINE SEDAN FWD 1FADP5AU6DL536022 EXCELLENT 18000 USD {addr1: '550 Auto Center Dr', city: 'Watsonville', region: 'CA', postal_code: '96075', country: 'US'} white 16000 USD AVAILABLE 2018-02-21  NEW 52.35 42.10

Ejemplo: lista con imágenes como una matriz

auto_listing_id title description url make model year mileage.value mileage.unit image transmission fuel_type body_style drivetrain vin condition price address exterior_color sale_price availability date_first_on_lot state_of_vehicle latitude longitude
"i2" $299 per month for the EndoHatch GE. Turbocharged! Gasoline! http://www.example.com/test Endomoto "[{""url"":""https://images.trvl-media.com/hotels/3000000/2260000/2250400/2250336/2250336_1_y.jpg""}]" AUTOMATIC GASOLINE SEDAN FWD 1FADP5AU6DL536022 EXCELLENT 18000 USD {addr1: '550 Auto Center Dr', city: 'Watsonville', region: 'CA', postal_code: '96075', country: 'US'} white 16000 USD AVAILABLE 2018-09-15 NEW 52.35 42.10

Esta lista de ejemplo tiene formato XML:

<?xml version="1.0" encoding="UTF-8"?>
<listings>
    <title>Vehicles Feed</title>
    <link rel="self" href="http://www.example.com"/>
    <listing>
      <vehicle_id>SED1234</vehicle_id>
      <title>$299 per month for the EndoHatch GE</title>
      <description>EndoHatch GE. Turbocharged! Gasoline!</description>
      <url>http://www.example.com/test</url>
      <make>Endomoto</make>
      <image>
        <url>http://example.com/some.image_1.jpg</url>
        <tag>Exterior</tag>
      </image>
      <model>EndoHatch</model>
      <year>2017</year>
      <mileage>
        <value>10</value>
        <unit>MI</unit>
      </mileage>
      <drivetrain>FWD</drivetrain>
      <vin>1FADP5AU6DL536022</vin>
      <body_style>SEDAN</body_style>
      <fuel_type>GASOLINE</fuel_type>
      <transmission>AUTOMATIC</transmission>
      <condition>EXCELLENT</condition>
      <price>18000 USD</price>
      <address format="simple">
          <component name="addr1">550 Auto Center Dr</component>
          <component name="city">Watsonville</component>
          <component name="region">CA</component>
          <component name="postal_code">95076</component>
          <component name="country">US</component>
      </address>
      <latitude>52.35</latitude>
      <longitude>42.10</longitude>
      <exterior_color>white</exterior_color>
      <sale_price>16000 USD</sale_price>
      <availability>AVAILABLE</availability>
      <date_first_on_lot>2018-02-21</date_first_on_lot>
      <state_of_vehicle>NEW</state_of_vehicle>
      <dealer_id>ABC1234</dealer_id>
    </listing>
</listings>

Ejemplo: lista en CSV/TSV

"vehicle_id","vehicle_registration_plate","vin","make","model","year","transmission","body_style","fuel_type","drivetrain","description","image[0].url", "image[1].url","image[2].url","mileage.value","mileage.unit","url","title","price","state_of_vehicle","exterior_color","address","latitude","longitude","trim","interior_colour","dealer_id","dealer_name","postal_code","dealer_phone","fb_page_id","dealer_communication_channel","dealer_privacy_policy_url"
"56345636","AB12CDE","YV1DZ8256F2693747","Volvo","XC60","2014","AUTOMATIC","OTHER","DIESEL","OTHER","Volvo XC60 2.4 TD D5 R-Design Lux Geartronic 5dr (Nav)","http://website.com/images/stock/car1.jpg","http://website.com/images/stock/car2.jpg","http://website.com/images/stock/car3.jpg","12950","MI","http://www.dealership.co.uk","Volvo XC60 2.4 TD D5 R-Design Lux Geartronic 5dr (Nav)","22495.00 GBP","Used","White","{""addr1"":""Sample Road"",""city"":""London"",""region"":""Greater London"",""postal_code"":""SW31 3EW"",""country"":""United Kingdom""}","52.7445867","-2.7337375","2.4 TD D5 R-Design Lux Geartronic 5dr (Nav)","Black","436456435347346","Dealer Group","SSW31 3EW","","3562564376375","CHAT","https://www.dealership.co.uk/site/privacy-and-legal/"

Ejemplo: dirección en CSV/TSV

"{addr1: '1 Hacker Way', city: 'Menlo Park', region: 'CA', postal_code: '94025', country: 'US'}"

Ejemplo: lista en XML

<?xml version="1.0" encoding="UTF-8"?>
<listings>
  <title>Sample Vehicles Feed</title>
  <link rel="self" href="https://www.example.com/dealers/cars/1234/?r=vddn" />
  <listing>
    <vehicle_id>3456553</vehicle_id>
    <title>$299 per month for the EndoHatch GE</title>
    <description>Adjustable Steering Column, Adjustable Steering Wheel, Air Bags, Air Conditioning, Alloy Wheels, Anti Lock Brakes, Bluetooth Preparation (Phone), CD Player, CD Radio, Driver Airbag, Electric & Heated Door Mirrors, Electric Windows, Electronic Stability Programme (ESP), Front Electric Windows, Front Fog Lights, Height Adjustable Drivers Seat, Passenger Airbag, Power Assisted Steering (PAS), Power Fold &amp; Heated DoorMirrors, Rear Parking Sensor, Remote Boot Release, Remote Central Locking, Solid Paint,LOW MILEAGE WITH A FULL FORD HISTORY, SUPPLIED FROM US,</description>
    <url>https://www.example.com/car-1234>
    <make>Endomoto</make>
    <image>
      <url>https://www.example.com/1234/image_1.jpg</url>
    </image>
    <image>
      <url>https://www.example.com/1234/image_2.jpg</url>
    </image>
    <image>
      <url>https://www.example.com/1234/image_3.jpg</url>
    </image>
    <model>B-MAX</model>
    <year>2015</year>
    <mileage>
      <value>15617</value>
      <unit>MI</unit>
    </mileage>
    <drivetrain>Other</drivetrain>
    <vin>1A2BCDEF3GH456789</vin>
    <body_style>OTHER</body_style>
    <fuel_type>Gasoline</fuel_type>
    <transmission>Manual</transmission>
    <price>9490 GBP</price>
    <address format="simple">
      <component name="addr1">Sample Road</component>
      <component name="city">Carland</component>
      <component name="region">North Test</component>
      <component name="country">United States of America</component>
      <component name="postal_code">12345</component>
    </address>
    <latitude>37.484419</latitude>
    <longitude>-122.148406</longitude>
    <exterior_color>White</exterior_color>
    <state_of_vehicle>Used</state_of_vehicle>
    <dealer_id>453356</dealer_id>
    <vehicle_registration_plate>AB12CD</vehicle_registration_plate>
    <fb_page_id>5636367576574</fb_page_id>
    <dealer_communication_channel>LEAD_FORM</dealer_communication_channel>
    <dealer_privacy_policy_url>https://www.example.com/privacy/</dealer_privacy_policy_url>
  </listing>
</listings>

Anuncios de inventario de automóviles: campos compatibles (vehículo)

Los siguientes campos compatibles se diseñaron para los artículos que agregas a tu catálogo de productos.

En el caso de los catálogos localizados, consulta los campos admitidos para vehículos.

Nombre	Descripción	Usar en el contenido	Usar como un filtro del conjunto de productos
`fb_page_id` Tipo: número entero	Obligatorio en anuncios de inventario con destino en Facebook. Identificador de la página de Facebook del socio o la concesionaria. Tu representante de Facebook debe agregar el catálogo a la lista de autorizados para que puedas enviar los identificadores de tu página. La página se debe agregar a la lista de autorizados mediante el administrador comercial antes de poder procesar el catálogo. Consulta Administración de permisos.	N	N
`vehicle_id` Tipo: cadena	Obligatorio. Caracteres máximos: 100 Identificador único de un artículo. Puede ser una variante de un vehículo. Si hay varias instancias del mismo identificador, las ignoraremos a todas. También puedes usar el número de chasis en `vehicle_id` y `vin`. Ejemplo: `1FADP5AU6DL536022`.	S	S
`title` Tipo: cadena	Obligatorio. Caracteres máximos: 500. Nombre completo del vehículo. Este campo es relevante y específico de cada vehículo y debe incluir lo que se definió en los campos `year`, `make`, `model`, `trim`. Ejemplo: `$299 per month for the EndoHatch GE`.	S	S
`description` Tipo: cadena	Obligatorio. Caracteres máximos: 5.000 Texto breve que describe el vehículo. No incluyas texto promocional ni enlaces. No escribas el texto todo en mayúsculas. Usa cambios de línea para dar formato a tu descripción. Ejemplo: `Used 2017 Volvo XC90 in great condition, available now.`	S	N
`url` Tipo: URL	Obligatorio. Enlace al sitio externo donde puedes ver la lista de vehículos.	S	N
`make` Tipo: cadena	Obligatorio. Marca o fabricante del vehículo. Ejemplo: `Endomoto`.	S	S
`model` Tipo: cadena	Obligatorio. Modelo del vehículo. Ejemplo: `EndoHatch`.	S	S
`year` Tipo: número entero	Obligatorio. Año de lanzamiento del vehículo en formato `yyyy`. Ejemplo: `2015`.	S	S
`mileage.value` Tipo: número entero	Obligatorio. En el caso de los vehículos usados, la cantidad actual de kilómetros (`kms`) o millas (`MI`) del vehículo. Si se trata de vehículos nuevos, usa cero (`0`). En Marketplace, los vehículos deben tener más de 500 millas/km. Ejemplo: "1.500".	S	S
`mileage.unit` Tipo: cadena	Obligatorio. Unidades de kilometraje: `MI` (millas) o `KM` (kilómetros).	S	N
`image[0].url` Tipo: cadena	Obligatorio. Máximo de artículos: 20 URL de la imagen del vehículo. Si tienes más de una imagen del vehículo, sigue este formato de nombre: `image[1].url`, `image[2].url`, etc. Debes proporcionar al menos una imagen. Cada imagen puede tener un tamaño máximo de 4 MB. En Marketplace, se requiere una cantidad mínima de dos imágenes. Para usar anuncios por secuencia, proporciona imágenes cuadradas con una relación de aspecto de 1:1, (600 x 600 píxeles). Para mostrar anuncios de un solo vehículo, debes proporcionar imágenes con una relación de aspecto 1,91:1 (1.200 x 630 píxeles). Obtén más información sobre Prácticas recomendadas de Marketplace para las imágenes.	N	N
`image[0].tag[0]` Tipo: cadena	Opcional. Máximo de artículos: 20 Etiqueta agregada a la imagen que muestra el contenido de la imagen. Puede haber varias etiquetas asociadas con una imagen. Sigue este formato de nombre: `image[0].tag[0], image[0].tag[1]` .... `image[1].tag[0], image[1].tag[1]` .... Ejemplo: `Exterior`, `Interior`, `StockImage`.	N	S
`transmission` Tipo: enumeración	Opcional. Tipo de transmisión del vehículo: `Automatic` o `Manual`.	N	S
`body_style` Tipo: enumeración	Obligatorio. Estilo de carrocería del vehículo: `CONVERTIBLE`, `COUPE`, `HATCHBACK`, `MINIVAN`, `TRUCK`, `SUV`, `SEDAN`, `VAN`, `WAGON`, `CROSSOVER`, `SMALL_CAR` u `OTHER`.	S	S
`drivetrain` Tipo: enumeración	Opcional. Tracción del vehículo. Valores admitidos: `4X2`, `4X4`, `AWD`, `FWD`, `RWD`, `Other`.	N	S
`vin` Tipo: cadena	Obligatorio en algunos países. Caracteres máximos: 17 Número de identificación del vehículo (Vehicle ID number, VIN). También puedes usar el número de chasis en `vehicle_id` y `vin`. Nota: el VIN debe tener exactamente 17 caracteres y no es obligatorio para vehículos fabricados antes de 1983. Los barcos tienen menos dígitos y algunos vehículos (como remolques) no necesitan VIN. Ejemplo: `1FADP5AU6DL536022`.	S	S
`price` Tipo: cadena	Obligatorio. Costo y divisa del vehículo. El formato del precio debe ser el costo seguido por el código de divisa ISO, con un espacio entre el costo y la divisa. Ejemplo: `18000 USD`, `32000 USD`.	S	S
`exterior_color` Tipo: cadena	Obligatorio. Color del vehículo. Ejemplo: `Black`, `White`, `Blue`, `Red`.	S	S
`state_of_vehicle` Tipo: enumeración	Obligatorio. Estado en el que se encuentra el vehículo. Valores admitidos: `New`, `Used` o `CPO` (usado certificado).	N	S
`fuel_type` Tipo: enumeración	Opcional. Tipo de combustible del vehículo. Valores admitidos: `DIESEL`, `ELECTRIC`, `FLEX`, `GASOLINE`, `HYBRID`, `OTHER`.	N	S
`tag` (etiqueta de imagen) Tipo: cadena	Opcional. Cadena que describe la imagen. Puede haber varias etiquetas asociadas con una imagen. Ejemplo: `Exterior`, `Interior`, `StockImage`.	S	N
`chrome_id` Tipo: número entero	Opcional. Similar a `autodata_id`.	N	N
`condition` Tipo: enumeración	Opcional. Estado del vehículo. Valores admitidos: `EXCELLENT`, `GOOD`, `FAIR`, `POOR` y `OTHER`.	N	S
`sale_price` Tipo: entero	Opcional. Precio de venta o precio especial. El formato del precio debe ser el costo seguido del código de divisa ISO, con un espacio entre el costo y la divisa. Ejemplo: `16000 USD`.	S	S
`availability` Tipo: enumeración	Opcional. Disponibilidad del vehículo: `available` o `not available`. No mostraremos en el anuncio vehículos que no estén disponibles.	N	S
`vehicle_type` Tipo: cadena	Opcional. Tipo de vehículo. Valores esperados: `car_truck` (se aplica de forma predeterminada si no se proporciona), `boat`, `commercial`, `motorcycle`, `powersport`, `rv_camper`, `trailer` o `other`.	N	S
`trim` Tipo: cadena	Opcional. Caracteres máximos: 50 Versión del vehículo. Ejemplo: `5DR HB SE`.	S	S
`interior_color` Tipo: cadena	Opcional. Caracteres máximos: 50 Color del interior del vehículo.	N	S
`date_first_on_lot` Tipo: cadena	Opcional. Fecha en que llegó el vehículo por primera vez a la concesionaria. Se utiliza para indicar la antigüedad del inventario. Usa el formato `yyyy-mm-dd`. Ejemplo: `2018-09-05`.	N	S
`days_on_lot` Tipo: número entero	Opcional. Cantidad de días que estuvo el vehículo en la concesionaria. Se debería incrementar todos los días. Ejemplo: `62`.	N	S

Anuncios de inventario de automóviles: campos compatibles (concesionaria)

Existen dos formatos para proporcionar direcciones. Puedes usar uno u otro, pero no ambos. Puedes usar el formato address o puedes proporcionar cada campo de dirección de manera individual. Ten en cuenta que usar los dos formatos generará un error.

Nombre	Descripción	Usar en el contenido	Usar como filtro del conjunto de productos
`address` Tipo: cadena	Obligatorio. Dirección física completa de la concesionaria, con el siguiente formato: `{addr 1: [STREET ADDRESS], city: [CITY], region: [STATE, COUNTY, REGION OR PROVINCE], country: [COUNTRY]`. El código postal es opcional. Ejemplo: `{addr1: '550 Auto Center Dr', city: 'Watsonville', region: 'CA', postal_code: '96075', country: 'US'}`	N	N
`address.city` Tipo: cadena	Obligatorio. Ciudad en la que se encuentra la concesionaria. Ejemplo: `Palo Alto`	S	S
`address.region` Tipo: cadena	Obligatorio. Estado, condado, región o provincia donde se encuentra la concesionaria. Ejemplo: `California`	S	S
`address.country` Tipo: cadena	Obligatorio. País en el que se encuentra la concesionaria. Ejemplo: `United States`	N	S
`latitude` Tipo: valor flotante	Obligatorio. Latitud de la ubicación de la concesionaria. Ejemplo: `37.484100`	N	N
`longitude` Tipo: valor flotante	Obligatorio. Longitud de la ubicación de la concesionaria. Ejemplo: `-122.148252`	N	N
`address.postal_code` Tipo: cadena	Opcional. Código postal de la concesionaria (fuera o dentro de Estados Unidos). Ejemplo: `75008` (París, Francia) o `94025` (Menlo Park)	N	N
`dealer_id` Tipo: cadena	Opcional. Caracteres máximos: 100 Identificador alfanumérico de la concesionaria.	S	S
`dealer_name` Tipo: cadena	Opcional. Caracteres máximos: 100 Nombre de la concesionaria.	S	S
`dealer_phone` Tipo: cadena	Opcional. Número de teléfono de la concesionaria. Número de teléfono de la concesionaria. Requisitos: Debe mostrar el botón Llamar en una publicación de Marketplace. Debe ser un formato de número de teléfono válido. Debe incluir el código de país. Ejemplo: `+1 3603453333` o `001 (360)345-3333`	N	N
`dealer_communication_channel` Tipo: enumeración	Opcional. El método que utilizará el usuario para contactarse con la concesionaria. Valores disponibles: `CHAT` o `LEAD_FORM`. Nota: Si seleccionas LEAD_FORM, también debes incluir una Política de privacidad. Consulta `dealer_privacy_policy_url` para obtener más información.	N	N
`dealer_privacy_policy_url` Tipo: URL	Obligatorio si se selecciona el formulario de clientes potenciales como método de contacto. Opcional si se selecciona Messenger (chat) como método de contacto. Enlace a la URL de privacidad de la concesionaria que publica el vehículo. Esto debe coincidir con la concesionaria del identificador de la página de Facebook (`fb_page_id`).	N	N
`stock_number` Tipo: cadena	Opcional. Designación propia del vehículo por parte de la concesionaria en su lote. El número de existencia es una opción que tiene la concesionaria para incluir vehículos específicos en un inventario. Ejemplo: `94025`	S	S
`custom_label_0` Tipo: cadena	Opcional. Límite máximo de caracteres: 100 Información adicional sobre el vehículo que deseas incluir.	S	S
`custom_label_1` Tipo: cadena	Opcional. Límite máximo de caracteres: 100 Información adicional sobre el vehículo que deseas incluir.	S	S
`custom_label_2` Tipo: cadena	Opcional. Límite máximo de caracteres: 100 Información adicional sobre el vehículo que deseas incluir.	S	S

Anuncios sobre ofertas de automóviles: formatos compatibles

El formato de un feed puede ser CSV, TSV o XML.

Ejemplo: archivo TSV delimitado por tabulaciones

vehicle_offer_id    market_name     make     model    trim   year    offer_disclaimer                               offer_type    amount    amount_percentage    amount_qualifier    term_length    term_qualifier    downpayment    downpayment_qualifier    offer_description    url    image[0].url      start_date      end_date

offer34220          market1234    MakeA    ModelA    E3    2017    *Available on approved credit to very well qualified customers    lease    USD 419        a month    36    months    USD 0    due at signing.    Expires 09/05/2017. Excludes official fees, taxes and dealer charges. No security deposit required. 10,000 mile/year limit.    https://test123.com/offers1    http://www.test123.com/cm-img/facebook/offer1.jpg    2018-09-05    2018-12-31       
offer34221          market1234    MakeB    ModelB    E4    2017    *Available on approved credit to very well qualified customers    cash    USD 1500        cash                    Expires 09/05/2017.    https://test123.com/offers2    http://www.test123.com/cm-img/facebook/offer2.jpg    2018-09-05    2018-12-31

offer34222          market2345    MakeC    ModelC    E5    2017    *Available on approved credit to very well qualified customers    finance        4.9    APR    60    months            Expires 09/05/2017. Excludes official fees, taxes and dealer charges.    https://test123.com/offers3    http://www.test123.com/cm-img/facebook/offer3.jpg    2018-09-05    2018-12-31

Anuncios sobre ofertas de automóviles: archivos admitidos

Estas listas se pueden subir mediante la UI o la API. Si prefieres la UI, proporciona el identificador de usuario y de la cuenta. De esta manera, podremos agregarte a la lista de autorizados para que puedas acceder.

Nombre	Descripción	Filtro de conjunto de productos	¿Se puede usar en el contenido?
`vehicle_offer_id` Tipo: cadena	Obligatorio. Identificador único del vehículo que usarán los anunciantes para identificar una oferta. Este es el mismo valor que se pasa en el parámetro `content_id` en el píxel. Ejemplo: `offer1`.	S	S
`make` Tipo: cadena	Obligatorio. Marca o fabricante del vehículo. Ejemplo: `Endomoto`.	S	S
`model` Tipo: cadena	Obligatorio. Modelo del vehículo. Ejemplo: `EndoHatch`.	S	S
`year` Tipo: entero	Obligatorio. Año en que se lanzó el vehículo, en formato aaaa. Ejemplo: `2015`.	S	S
`offer_type` Tipo: enumeración	Obligatorio. Tipo de oferta. Valores válidos: `lease`, `finance`, `cash`.	S	N
`title` Tipo: cadena	Obligatorio. Título del anuncio o la oferta. Ejemplo: `"$299 per month for the EndoHatch GE!"`.	N	S
`offer_description` Tipo: cadena	Obligatorio. Descripción de la oferta. Ejemplo: `This offer is valid only during the month of September.`.	N	S
`url` Tipo: URL	Obligatorio. Enlace al sitio externo donde puedes ver la oferta.	N	S
`offer_disclaimer` Tipo: cadena	Obligatorio. Descargo de responsabilidad asociado con la oferta.	N	N
`image[0].url` Tipo: cadena	Obligatorio. URL de la imagen del vehículo usada en el contenido. Nota: Para usar anuncios por secuencia, proporciona imágenes cuadradas con una relación de aspecto de 1:1 y un tamaño de 600 x 600 píxeles. Para mostrar anuncios de un solo vehículo, debes proporcionar imágenes con una relación de aspecto de 1,91:1 y un tamaño de 1.200 x 630 píxeles. Si deseas obtener más información sobre la relación de aspecto de la imagen, consulta las Prácticas recomendadas de las relaciones de aspecto.	N	N
`image[0].tag[0]` Tipo: cadena	Opcional. Cadena que representa lo que se muestra en la imagen. Pueden existir varias etiquetas asociadas con la imagen, como "Lease Offer", "Financing", etc.
`image[0].tag[m]` Tipo: cadena	Opcional. Cadena que representa lo que se muestra en la imagen. Admitimos varias etiquetas. Aumenta el valor `m` para agregar más etiquetas.	N	N
`image[n].url` Tipo: cadena	Opcional. Cadena que representa lo que se muestra en la imagen. Puedes subir más de una imagen si incrementas el dígito "n" en un rango de 1 a 20. El valor de `n` debe estar en orden correlativo. Por ejemplo, si tienes 0,1,2, debes usar 3, y no puedes pasar directamente a 4.	N	N
`image[n].tag[0]` Tipo: cadena	Opcional. Cadena que representa lo que se muestra en la imagen. Admitimos varias etiquetas. Aumenta el valor `m` para agregar más etiquetas.	N	N
`image[n].tag[m]` Tipo: cadena	Opcional. Cadena que representa lo que se muestra en la imagen. Pueden existir varias etiquetas asociadas con la imagen, como "Lease Offer", "Financing", etc.	N	N
`amount_price` Tipo: cadena	Recomendado. Monto de la oferta de alquiler o en efectivo. El formato del precio debe ser el costo seguido del código de divisa ISO, con un espacio entre el costo y la divisa. Ejemplo: en caso de un alquiler de 329 USD al mes o un reembolso de 2.000 USD, los valores son `329 USD` o `2000 USD`.	N	S
`amount_percentage` Tipo: cadena	Recomendado. Valor porcentual, si está en la oferta. A veces, el valor en un porcentaje (por ejemplo, `3.9% APR`), en lugar de un monto.	N	N
`amount_qualifier` Tipo: cadena	Recomendado. Calificador del valor del "monto en dólares" o "monto en porcentaje". Los valores válidos pueden ser `per month` o `APR`. Ejemplo: `/mo` en 100 USD al mes en relación con las ofertas de alquiler y `APR` en 1,1% APR en relación con las ofertas de financiación.	N	S
`term_length` Tipo: entero	Recomendado. Vigencia de la oferta. Si la oferta es un alquiler de 329 USD al mes por tres años, el valor es `3`, y el valor correspondiente en `term_qualifier` es `years`. Ejemplo: `/mo` en 100 USD al mes en relación con las ofertas de alquiler y `APR` en 1,1% APR en relación con las ofertas de financiación.	N	S
`term_qualifier` Tipo: enumeración	Recomendado. Unidades del término de la oferta. Los valores válidos son "meses" o "años". Ejemplo: `months` en relación con una oferta de 329 USD al mes por 36 meses y `year` en relación con una oferta de 329 USD al mes por tres años.	N	S
`downpayment` Tipo: cadena	Recomendado. Valor del anticipo en el momento de la compra o del alquiler. El formato del precio debe ser el costo seguido del código de divisa ISO, con un espacio entre el costo y la divisa. Ejemplo: usa `1500 USD` como valor si las condiciones del anticipo son `$1500 due at signing + 1 month payment`.	N	S
`downpayment_qualifier` Tipo: cadena	Recomendado. Calificador del valor `downpayment`. Ejemplo: usa el valor `due at signing + 1 month payment` si las condiciones del anticipo son `$1500 due at signing + 1 month payment`.		S
`trim` Tipo: cadena	Recomendado. Versión del vehículo. Ejemplo: `GE`.	N	S
`price` Tipo: cadena	Recomendado. El precio de venta del vehículo sugerido por el fabricante y la divisa. El formato del precio debe ser el costo seguido del código de divisa ISO, con un espacio entre el costo y la divisa. Ejemplo: `13,999 USD`.	N	N
`body_style` Tipo: enumeración	Recomendado. Estilo de la carrocería de los vehículos. Valores válidos: `CONVERTIBLE`, `COUPE`, `HATCHBACK`, `MINIVAN`, `TRUCK`, `SUV`, `SEDAN`, `VAN`, `WAGON`, `CROSSOVER` o `OTHER`.	N	N
`start_date` Tipo: cadena	Opcional. Fecha de inicio a partir de la que es válida una oferta. Debe contener el formato de fecha aaaa-mm-dd. Ejemplo: `2018-09-05`.	N	N
`end_date` Tipo: cadena	Opcional. Fecha de finalización después de la que es válida una oferta. Debe contener el formato de fecha aaaa-mm-dd. Ejemplo: `2018-09-05`.	N	N
`market_name` Tipo: cadena	Opcional. Nombre del mercado o de la Designated Marketing Area (DMA).	S	N
`dma_codes` Tipo: matriz de cadenas	Obligatorio en el caso de ofertas regionales. Opcional en el caso de las ofertas nacionales. Lista de códigos de la Designated Marketing Area (DMA) del mercado específico que se incluyó con el siguiente formato ['502', '201'] ['516'...]. Nota: Se trata de un formato CSV. Consulta a continuación ejemplos de listas con el formato XML. Consulta las normas sobre los códigos de DMA. Déjalo sin completar en el caso de las ofertas nacionales.	S	N

Ejemplo: si deseas crear un catálogo de anuncios del catálogo Advantage+, consulta Catálogo, Referencia.

curl \
  -F 'name=catalog name' \
  -F 'access_token=<ACCESS TOKEN>' \
  -F 'vertical=vehicle_offers' \
  https://graph.facebook.com/<API_VERSION>/<BUSINESS ID>/product_catalogs