Thumbnails

يحدّد مورد thumbnail أحجامًا مختلفة للصور المصغّرة المرتبطة بمورد. يُرجى مراعاة الخصائص التالية للصور المصغّرة:

  • السمة snippet.thumbnails الخاصة بأحد المراجع هي عنصر يعرّف الصور المصغّرة المتاحة لهذا المرجع.
  • يحتوي مرجع thumbnail على سلسلة من العناصر. يشير اسم كل عنصر (default وmedium وhigh وما إلى ذلك) إلى حجم صورة مصغّرة.
  • قد تتوافق أنواع مختلفة من المراجع مع أحجام مختلفة للصور المصغّرة.
  • قد تحدّد أنواع مختلفة من المراجع أحجامًا مختلفة للصور المصغّرة التي تحمل الاسم نفسه. على سبيل المثال، يبلغ حجم الصورة المصغّرة default الخاصة بمورد video عادةً 120 بكسل × 90 بكسل، ويبلغ حجم الصورة المصغّرة default الخاصة بمورد channel عادةً 88 بكسل × 88 بكسل.
  • قد تظل أحجام الصور المصغّرة مختلفة للموارد من النوع نفسه بالنسبة إلى صور معيّنة، وذلك استنادًا إلى دقة الصورة الأصلية أو المحتوى الذي تم تحميله إلى YouTube. على سبيل المثال، قد يتيح فيديو عالي الدقة صورًا مصغّرة بدرجة دقة أعلى من الفيديوهات غير العالية الدقة.
  • يحتوي كل عنصر يتضمّن معلومات عن حجم الصورة المصغّرة على السمتَين width وheight. ومع ذلك، قد لا يتم عرض خصائص العرض والارتفاع لهذه الصورة.
  • إذا كانت الصورة المصغّرة التي تم تحميلها لا تتطابق مع الأبعاد المطلوبة، سيتم تغيير حجم الصورة لتتطابق مع الحجم الصحيح بدون تغيير نسبة العرض إلى الارتفاع. لا يتم قص الصورة، ولكن قد تتضمّن أشرطة سوداء ليكون الحجم صحيحًا.

الطُرق

تتيح واجهة برمجة التطبيقات الطرق التالية لموارد thumbnails:

set
تحميل صورة مصغّرة مخصّصة للفيديو إلى YouTube وضبطها كصورة مصغّرة للفيديو

تمثيل الموارد

تعرض بنية JSON التالية تنسيق مورد thumbnails:

{
  "default": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  },
  "medium": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  },
  "high": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  },
  "standard": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  },
  "maxres": {
    "url": string,
    "width": unsigned integer,
    "height": unsigned integer
  }
}

الخصائص

يحدّد الجدول التالي السمات التي تظهر في هذا المرجع:

الخصائص
default object
الصورة المصغّرة التلقائية يبلغ حجم الصورة المصغّرة التلقائية لفيديو أو مرجع يشير إلى فيديو، مثل عنصر في قائمة تشغيل أو نتيجة بحث، 120 بكسل عرضًا و90 بكسل ارتفاعًا. يبلغ حجم الصورة المصغّرة التلقائية للقناة 88 بكسل عرضًا و88 بكسل ارتفاعًا.
default.url string
تمثّل عنوان URL الخاص بالصورة.
default.width unsigned integer
تمثّل هذه السمة عرض الصورة.
default.height unsigned integer
تمثّل هذه السمة ارتفاع الصورة.
medium object
تمثّل هذه السمة نسخة أعلى دقة من الصورة المصغّرة. بالنسبة إلى فيديو (أو مرجع يشير إلى فيديو)، يبلغ عرض هذه الصورة 320 بكسل وارتفاعها 180 بكسل. بالنسبة إلى قناة، يبلغ عرض هذه الصورة 240 بكسل وطولها 240 بكسل.
medium.url string
تمثّل عنوان URL الخاص بالصورة.
medium.width unsigned integer
تمثّل هذه السمة عرض الصورة.
medium.height unsigned integer
تمثّل هذه السمة ارتفاع الصورة.
high object
تمثّل هذه السمة نسخة عالية الدقة من الصورة المصغّرة. بالنسبة إلى فيديو (أو مرجع يشير إلى فيديو)، يبلغ عرض هذه الصورة 480 بكسل وارتفاعها 360 بكسل. بالنسبة إلى القناة، يبلغ عرض هذه الصورة 800 بكسل وارتفاعها 800 بكسل.
high.url string
تمثّل عنوان URL الخاص بالصورة.
high.width unsigned integer
تمثّل هذه السمة عرض الصورة.
high.height unsigned integer
تمثّل هذه السمة ارتفاع الصورة.
standard object
نسخة من الصورة المصغّرة بدقة أعلى من دقة الصورة high. تتوفّر هذه الصورة لبعض الفيديوهات والمراجع الأخرى التي تشير إلى الفيديوهات، مثل عناصر قائمة التشغيل أو نتائج البحث. يبلغ عرض هذه الصورة 640 بكسل وارتفاعها 480 بكسل.
standard.url string
تمثّل عنوان URL الخاص بالصورة.
standard.width unsigned integer
تمثّل هذه السمة عرض الصورة.
standard.height unsigned integer
تمثّل هذه السمة ارتفاع الصورة.
maxres object
تمثّل هذه السمة أعلى دقة للصورة المصغّرة. يتوفّر حجم الصورة هذا لبعض الفيديوهات والمراجع الأخرى التي تشير إلى الفيديوهات، مثل عناصر قائمة التشغيل أو نتائج البحث. يبلغ عرض هذه الصورة 1280 بكسل وارتفاعها 720 بكسل.
maxres.url string
تمثّل عنوان URL الخاص بالصورة.
maxres.width unsigned integer
تمثّل هذه السمة عرض الصورة.
maxres.height unsigned integer
تمثّل هذه السمة ارتفاع الصورة.