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 ارتفاع الصورة