الحقول المُتوفِّرة لكتالوجات مخزون إعلانات السيارات

الاسم

مطلوب؟

الوصف

هل يمكن للمُستخدِمين الفلترة بحسب هذه السمة؟

vehicle_id

النوع: string

نعم

الحد الأقصى لعدد الرموز: 100

يُمثِّل المُعرِّف الفريد للعنصر. وقد يُمثِّل أحد مُتغيِّرات السيارة. وفي حال وجود مثيلات مُتعدِّدة للمُعرِّف نفسه، فإننا نتجاهل كل المثيلات. يمكنك أيضًا استخدام رقم تعريف المركبة (VIN) لكل من vehicle_id وvin. مثال: 1FADP5AU6DL536022

نعم

العنوان

النوع: string

نعم

الحد الأقصى لعدد الرموز: 500

يُوصَى باستخدام 40 رمزًا أو أقل لعرض العنوان بالكامل. الاسم الكامل للسيارة. وهذا ملائم وخاص لكل سيارة ويجب أن يتضمَّن ما تمَّ تعيينه في حقول "السنة" و"الماركة" و"الموديل" و"كماليات الهيكل". مثال: 299 دولارًا شهريًا لـ EndoHatch GE

نعم

الوصف

النوع: string

نعم

الحد الأقصى لعدد الرموز: 5000

نص موجز يصِف السيارة. لا تقُم بتضمين أيّ نصٍ ترويجي أو أيّ روابط. ولا تُدخِل أيّ نصٍ بأحرفٍ كبيرة بالكامل. واستخدِم فاصل الأسطر لتنسيق الوصف. مثال: سيارة Volvo XC90 موديل 2017 مُستعمَلة بحالة ممتازة، مُتوفِّرة الآن.

نعم

url

النوع: url

نعم

رابط إلى الموقع الخارجي يمكنك من خلاله عرض قائمة السيارات. تنسيق HTTP مطلوب.

لا

ios_url

النوع: url

لا

رابط إلى الصفحة المقصودة للتطبيق. وفي حال ملئه وقيام المُستخدِم بتثبيت التطبيق، فسننتقل إلى عنوان URL هذا أولًا. وإلّا، فإننا سنعود إلى عنوان URL الخاص بالويب.

لا

android_url

النوع: url

لا

رابط إلى الصفحة المقصودة للتطبيق. وفي حال ملئه وقيام المُستخدِم بتثبيت التطبيق، فسننتقل إلى عنوان URL هذا أولًا. وإلّا، فإننا سنعود إلى عنوان URL الخاص بالويب

لا

الماركة

النوع: string

نعم

الحد الأقصى لعدد الرموز 100

الماركة أو العلامة التجارية للسيارة. مثال: Endomoto

نعم

الموديل

النوع: string

نعم

الحد الأقصى لعدد الرموز 100

موديل السيارة. مثال: EndoHatch

نعم

year

النوع: int

نعم

سنة إطلاق السيارة بتنسيق السنة yyyy. مثال: 2015

نعم

mileage.value

النوع: int

نعم

بالنسبة إلى السيارات المُستعمَلة، تكون المسافة الحالية التي قطعَتها السيارة بالكيلومتر (كم) أو بالميل (ميل). وبالنسبة إلى السيارات الجديدة، استخدِم الصفر (0). بالنسبة إلى المركز، يجب أن تكون السيارات قد قطعَت أكثر من 500 ميل \ كم. مثال: "1500". القيمة أكبر من أو تساوي 0.

نعم

mileage.unit

النوع: string

نعم

وحدات قياس المسافة المقطوعة: ميل أو كم

لا

image_link

النوع: string

نعم

الحد الأقصى لعدد العناصر: يجب أن تكون الصورة 500 × 500 بكسل على الأقل، ولكننا نُوصي بنسبة الأبعاد 4:3 لتحقيق أفضل أداء. حجم الصورة المثالي هو 800 × 600.

لا

transmission

النوع: string

لا

يُمثِّل نوع ناقل الحركة في السيارة: أوتوماتيكي أو يدوي

نعم

body_style

النوع: enum

نعم

يُمثِّل نوع هيكل السيارة: CONVERTIBLE، أو COUPE، أو HATCHBACK، أو MINIVAN، أو TRUCK، أو SUV، أو SEDAN، أو VAN، أو WAGON، أو CROSSOVER، أو SMALL_CAR، أو OTHER.

نعم

drivetrain

النوع: enum

لا

نظام الدفع في السيارة. القيم المدعومة: 4X2، و4X4، وAWD، وFWD، وRWD، وOther.

نعم

vin

النوع: string

لا

الحد الأقصى لعدد الرموز: 17. رقم تعريف المركبة (VIN) الخاص بالسيارة. يمكنك أيضًا استخدام رقم تعريف المركبة (VIN) لكل من vehicle_id وvin. ملاحظة: يجب أن يتكوَّن رقم تعريف المركبة (VIN) من 17 رمزًا بالضبط، وهو غير مطلوب لسيارات ما قبل عام 1983. تتضمّن أرقام تعريف القوارب أرقامًا أقل، بينما لا تحتاج بعض السيارات (مثل المقطورات) إلى أيّ أرقام تعريف. مثال: 1FADP5AU6DL536022

نعم

price

النوع: string

نعم

تكلفة السيارة والعملة المُحدَّدة لشرائها. أدخِل السعر بالتنسيق التالي: التكلفة، متبوعةً بكود العملة حسب معيار ISO، مع وضع مسافة بين التكلفة والعملة. العملة الافتراضية هي الدولار الأمريكي. مثال: 18000 دولار أمريكي، 32000 دولار أمريكي

نعم

exterior_color

النوع: string

نعم

الحد الأقصى لعدد الرموز 100

لون السيارة. مثال: أسود، أبيض، أزرق، أحمر

نعم

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، مع وضع مسافة بين التكلفة والعملة. مثال: 16000 دولار أمريكي

نعم

availability

النوع: enum

لا

توفُّر السيارة من خلال القيمة: available أو not available. ولا نعرِض السيارات غير المتوفِّرة في الإعلان.

نعم

vehicle_type

النوع: string

لا

نوع السيارة. وتكون القيم المُتوقَّعة هي: car_truck (قيمة افتراضية إذا لم يتمّ توفير قيمة)، أو boat، أو commercial، أو motorcycle، أو powersport، أو rv_camper، أو trailer، أو other.

نعم

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. مثال: 62

نعم

custom_number_0

custom_number_1

custom_number_2

custom_number_3

custom_number_4

النوع: string

لا

ما يصِل إلى خمسة حقول مُخصَّصة لأيّ معلومات إضافية مُتعلِّقة بالأرقام تريد فلترة العناصر بحسبها عند إنشاء مجموعات. ويتيح لك هذا الحقل الفلترة بحسب نطاقات الأرقام (أكبر من وأقل من) عند إنشاء مجموعة. على سبيل المثال، يمكنك استخدام هذا الحقل للإشارة إلى سنة إنتاج أحد العناصر، ثمّ الفلترة بحسب نطاق سنة مُعيَّن في أيّ مجموعة.

ويدعم هذا الحقل الأعداد الصحيحة بين 0 و4294967295. وهو لا يدعم الأرقام السالبة أو الأرقام العشرية أو الفواصل، مثل -2 أو 5.5 أو 10000. مثال: 2022

نعم

الاسم

الوصف

مطلوب؟

نمط تنسيق العنوان 1: العنوان الكامل (لا تستخدِم كلا النمطين)

address

النوع: string

العنوان الفعلي للوكالة بالكامل، بالتنسيق:{addr 1: [STREET ADDRESS], city: [CITY], region: [STATE, COUNTY, REGION OR PROVINCE], country: [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

المدينة التي تُوجَد فيها الوكالة. مثال: بالو ألتو

نعم

address.region

النوع: string

الولاية أو المقاطعة أو المنطقة أو الإقليم الذي تُوجَد فيه الوكالة. مثال: كاليفورنيا

نعم

address.country

النوع: string

البلد الذي تُوجَد فيه الوكالة. مثال: الولايات المتحدة

نعم

latitude

النوع: float

خط العرض لموقع الوكالة. مثال: 37.484100

نعم

longitude

النوع: float

خط الطول لموقع الوكالة. مثال: -122.148252

نعم

address.postal_code

النوع: string

الرمز البريدي للوكالة (خارج الولايات المتحدة أو الرمز البريدي داخل الولايات المتحدة). مثال: 75008 (باريس، فرنسا) أو 94025 (مينلو بارك)

لا

مُعرِّفات الوكالة الاختيارية الإضافية

dealer_id

النوع: string

الحد الأقصى لعدد الرموز: 100

مُعرِّف أبجدي رقمي للوكالة.

لا

dealer_name

النوع: string

الحد الأقصى لعدد الرموز: 100

اسم الوكالة.

لا

dealer_phone

النوع: string

رقم هاتف الوكالة. المُتطلَّبات: يجب عرض زر "الاتصال" في قائمة المركز. ويجب أن يكون تنسيق رقم الهاتف صالحًا. يجب أن يتضمَّن رمز البلد. مثال: ‎+1 3603453333, 001 (360)345-3333

لا

stock_number

النوع: string

التسمية الخاصة التي أطلقَتها الوكالة على السيارة في ساحتها. علمًا بأن عدد المخزون هو طريقة تتوفَّر لدى الوكيل لتسجيل سيارات مُعيَّنة كمخزون. مثال: N8990

لا