Also see the general (non-data-format-specific) description of the Upload-Interface.
The file name extension of the vehicle-file must be .xml. Example: fooBar.xml
Note: This refers to the vehicle-file, not the surrounding ZIP file. The ZIP file (if there is any) always ends with .zip.
Some basic data types used by almost all other schemas | types-1.0.xsd |
The ad | seller-ad-1.1.xsd |
Price data (included in ads) | price-1.0.xsd |
Vehicle data (included in ads) | vehicle-1.0.xsd |
Some country specific properties (included in vehicle) | site-specifics-1.0.xsd |
For stating the customer number (included in ads) | seller-3.0.xsd |
When you are acting as a transfer service provider (TSP) with an API-Account and upload ads on behalf of various vehicle sellers, then you have to state the mobile.de customer number for every record (<ad> element).
Put it into the <seller:customerNumber> element which you
find here:
//ads/ad/seller:seller/seller:customerNumber
.
Also see the below example.
For identifying the vehicle ads, put the inventory-key (a.k.a. internal number a.k.a. internal ID) to the <seller-inventory-key> element.
Also see the below example.
For adding images to your ads, throw the image files into your
ZIP file and state the names of the files within in the ads in
the XML file. Each image gets an <image> element within
the <images> element. The file name goes to the
ref
attribute.
Here is the XPath:
//ads/ad/images/image/@ref
.
Also see the below example.
<?xml version="1.0" encoding="UTF-8"?/>
<ads
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns="http://services.mobile.de/schema/seller/seller-ad-1.1"
xmlns:vehicle="http://services.mobile.de/schema/seller/vehicle-1.0"
xmlns:seller="http://services.mobile.de/schema/common/seller-3.0"
xmlns:site-specifics="http://services.mobile.de/schema/seller/site-specifics-1.0"
xmlns:price="http://services.mobile.de/schema/seller/price-1.0"
xsi:schemaLocation="http://services.mobile.de/schema/seller/seller-ad-1.1 http://services.mobile.de/schema/seller/seller-ad-1.1.xsd">
<ad> <!-- first ad -->
<!-- ...ad other stuff here... -->
<seller-inventory-key value="car1" ></seller-inventory-key>
<!-- ...ad other stuff here... -->
<images>
<image ref="image-one.jpg"/>
<image ref="ford-from-behind.jpg"/>
</images>
<!-- ...ad other stuff here... -->
<seller:seller> <!-- only for TSP upload on behalf of a vehicle dealer -->
<seller:customerNumber>123456</seller:customerNumber>
</seller:seller>
</ad>
<ad> <!-- second ad -->
<!-- ...ad other stuff here... -->
<seller-inventory-key value="car2"></seller-inventory-key>
<!-- ...ad other stuff here... -->
<images>
<image ref="interior.jpg"/>
<image ref="myOldHonda1.jpg"/>
<image ref="image-two.jpg"/>
</images>
<!-- ...ad other stuff here... -->
<seller:seller> <!-- only for TSP upload on behalf of a vehicle dealer -->
<seller:customerNumber>123456</seller:customerNumber>
</seller:seller>
</ad>
<ad> <!-- third ad -->
<!-- ...ad other stuff here... -->
<seller-inventory-key>number-one</seller-inventory-key>
<!-- ...ad other stuff here... -->
<images>
<image ref="fiatFromLeft.jpg"/>
<image ref="fiatFromRight.jpg"/>
</images>
<!-- ...ad other stuff here... -->
<seller:seller> <!-- only for TSP upload on behalf of a vehicle dealer -->
<seller:customerNumber>456789</seller:customerNumber>
</seller:seller>
</ad>
</ads>