Vehicle ads Merchant API guidelines

This article outlines Merchant API specifications and guidelines for vehicle ads. When you set up your Merchant Center account, you can upload your data sources using the Merchant API .

On this page

• Migration
• API specifications

Migration

If you are already using the Content API and are now migrating to the Merchant API, follow the guide to migrate from Content API for Shopping to Merchant API and to migrate your products .

API specifications

Account management

There are several Merhchant API endpoints that can be used in conjunction with Merchant Center advanced accounts :

• accounts.list will return a list of accounts or sub-accounts of the current authenticated user.
• accounts.homepage.claim can be used to claim websites of Merchant Center sub-accounts.

For a full list of endpoints, refer to the Account REST Resource page.

Creating a new API Data source

Use the accounts.dataSources.create method to create a new API data source. The table below lists vehicle ads-specific fields and attributes that need to be added when creating a new API data data source.

    "displayName": string,
   "primaryProductDataSource": {
     "legacyLocal": true,
     "feedLabel": string,
     "contentLanguage": string,
     "countries": [string],
     "destinations":[{
       "destination": "VEHICLE_ADS",
       "status": ENABLED
     }] 
  

Use an existing API data source

Use the accounts.dataSources.list method to extract existing API dataSourceId . The dataSourceId has to be provided when adding or editing your vehicles.

Uploading offers

The table below lists vehicle ads-specific attributes that need to be added using the customAttributes field.

 { 
    "id": string, 
    "offerId": string, 
    "googleProductCategory": string, 
    "title": string, 
    "description": string, 
    "channel": "local", 
    "includedDestinations": ["VEHICLE_ADS"],
    "price": {
      "amountMicros": string,
      "currency": string
    }, 
    "brand": string, 
    "color": string, 
    "condition": string, 
    "imageLink": string, 
    "contentLanguage": string, 
    "targetCountry": string, 
    "vin" = string
    "model" = string
    "trim" = string
    "bodyStyle" = enum
    "year" = string
    "mileage" = {
      "value" = string
      "unit" = string
    },
     "customAttributes": [
  {
      “name”: “vehicle_fulfillment”,
      “groupValues”: [{
        “name”: “option”,
        “value”: string
      }]
 
... 
 }  
 us": ENABLED
     }]