Automotive Adsの在庫カタログで使用可能なフィールド

名前

必須

説明

この属性を使ったフィルタリングの可否

vehicle_id

データ型：string

はい

最大文字数：100

商品のユニークID。車両のバリエーションとして使用できます。同一IDが複数存在する場合、そのIDを割り当てられているすべての商品が無効となります。vehicle_idとvinの両方にVINを使用することも可能です。例：1FADP5AU6DL536022

はい

タイトル

データ型：string

はい

最大文字数：500

タイトルを最後まで表示したい場合は、20文字以下（2バイト文字の場合）にまとめましょう。自動車の正式名称を入力してください。また年式、メーカー、モデル、トリムなど各自動車に関する固有の情報を含めることが推奨されます。例：月299米ドルでEndoHatch GE

はい

description

データ型：string

はい

最大文字数：5,000

車両に関する短い説明文を入力してください。プロモーションテキストやリンクなどは含めないでください。テキストをすべて大文字にするのも避けましょう。適宜改行を入れることで説明文の体裁を整えられます。例：2017 Volvo 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 mi / km以上の走行距離が必要です。例：「1500」。0か、0より大きい値を入力してください。

はい

mileage.unit

データ型：string

はい

走行距離の単位には、mi（マイル）かkm（キロメートル）を使ってください。

いいえ

image_link

データ型：string

はい

商品の最大数：画像サイズについては、最低500×500 px以上である必要がありますが、パフォーマンスを最大化するのであれば、4:3のアスペクト比が推奨されます。理想的な画像サイズは800×600です。

いいえ

transmission

データ型：string

いいえ

車両のトランスミッションの種類をアルファベットで入力してください（AutomaticまたはManual）。

はい

body_style

データ型：enum

はい

車両のボティタイプをアルファベットで入力してください。CONVERTIBLE、COUPE、HATCHBACK、MINIVAN、TRUCK、SUV、SEDAN、VAN、 WAGON、CROSSOVER、SMALL_CAR、（その他のボディタイプの場合）OTHER。

はい

drivetrain

データ型：enum

いいえ

車両のドライブトレインを入力してください。対応している値は次の通りです：4×2、4×4、AWD、FWD、RWD、（その他のドライブトレインの場合）Other。

はい

vin

データ型：string

いいえ

最大文字数：17。車両識別番号（VIN）を入力してください。vehicle_idとvinの両方にVINを使用することも可能です。補足：VINはきっかり17桁です。1983年以前の車両の場合、VINは必須ではありません。ボートにはこれより短いVINが割り当てられており、また一部の車両（トレーラーなど）はVINが不要です。例：1FADP5AU6DL536022

はい

price

データ型：string

はい

車両の価格と通貨単位を入力してください。価格は、数値の後にISO通貨コードを記載し、数値と通貨コードの間にスペースを入れて表記してください。 デフォルトの通貨単位は「USD」となっています。 例：18,000 USD、32,000 USD

はい

exterior_color

データ型：string

はい

最大文字数：100

車両の色をアルファベットで入力してください。 例：Black、White、Blue、Red

はい

state_of_vehicle

データ型：string

はい

現在の車両の状態をアルファベットで入力してください。対応している値は次の通りです：New、Used、CPO（意味：新車、中古、認定中古車）

はい

fuel_type

データ型：string

いいえ

車両の燃料タイプをアルファベットで入力してください。対応している値は次の通りです：DIESEL、ELECTRIC、FLEX、GASOLINE、HYBRID、OTHER。

はい

condition

データ型：string

いいえ

車両のコンディションをアルファベットで入力してください。対応している値は次の通りです：EXCELLENT、GOOD、FAIR、POOR、OTHER。

はい

sale_price

データ型：string

いいえ

セール価格、または特別価格を入力してください。価格は、数値の後にISO通貨コードを記載し、数値と通貨コードの間にスペースを入れて表記してください。例：16,000 USD

はい

availability

データ型：enum

いいえ

車両の在庫の有無を入力してください。在庫のない車両は広告に表示されません。

はい

vehicle_type

データ型：string

いいえ

車両の種類をアルファベットで入力してください。想定される値：car_truck、boat、commercial、 motorcycle、powersport、rv_camper、trailer、other（意味：乗用車、ボート、商用車、オートバイ、ハイブリッドスポーツカー、RVキャンピングカー、トレーラー、その他。指定しない場合は乗用車がデフォルトとなります）。

はい

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か、0より大きい値を入力してください。 例：62

はい

custom_number_0

custom_number_1

custom_number_2

custom_number_3

custom_number_4

データ型：string

いいえ

上記以外で商品のフィルタリングに用いたい数字ベースの情報などがあれば、セット作成時に、最大5つのカスタムフィールドを追加可能です。セットを作成すると、これらのフィールドで一定の範囲内の数字（「xより大きい数」および「xより小さい数」）でフィルタリングができるようになります。例えば、商品の生産年で絞り込めるフィールドにしたい場合は、セットに一定範囲の年数を入力できるようにします。

このフィールドでは、0から4294967295までの整数に対応しています。「-2」、「5.5」、「10,000」などの負数、少数、カンマには対応していません。 例：2022

はい

名前

説明

必須

住所フォーマットスタイル1：全住所（両方のスタイルを併用しないでください）

address

データ型：string

販売代理店の実際の住所を以下のフォーマットで記入してください：{addr 1: 【番地】、city: 【市町村】、region: 【都道府県】、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

販売代理店が所在する市町村を入力してください。例：Palo Alto

はい

address.region

データ型：string

販売代理店が所在する都道府県を入力してください。例：California

はい

address.country

データ型：string

販売代理店が所在する国を入力してください。例：United States

はい

latitude

データ型：float

販売代理店の所在地の緯度を入力してください。例：37.484100

はい

longitude

データ型：float

販売代理店の所在地の経度を入力してください。例：-122.148252

はい

address.postal_code

データ型：string

販売代理店の郵便番号を入力してください。例：75008（Paris, France）、94025（Menlo Park）

いいえ

追加の販売代理店ID（任意）

dealer_id

データ型：string

最大文字数：100

販売代理店に割り当てられた英数字のIDを入力してください。

いいえ

dealer_name

データ型：string

最大文字数：100

販売代理店の名称を入力してください。

いいえ

dealer_phone

データ型：string

販売代理店の電話番号を入力してください。必須事項：Marketplaceのリストにある「通話」ボタンを必ず表示してください。また、有効な電話番号フォーマットを使用してください。国番号の表記も忘れずにお願いします。例：+1 3603453333、001 (360)345-3333

いいえ

stock_number

データ型：string

販売代理店によって、ロットに入っている車両に割り当てられた番号を入力してください。特定の在庫車両に付与されている、在庫番号などが一例となります。例：N8990

いいえ