تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Thumbnails

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

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

الطُرق

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

ضبط: يحمِّل صورة مصغّرة مخصّصة للفيديو إلى 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` ارتفاع الصورة.