Thumbnails

thumbnail kaynağı, bir kaynakla ilişkilendirilmiş farklı küçük resim boyutlarını tanımlar. Lütfen küçük resimlerin aşağıdaki özelliklerini göz önünde bulundurun:

  • Bir kaynağın snippet.thumbnails özelliği, söz konusu kaynak için kullanılabilen küçük resim görüntülerini tanımlayan nesnedir.
  • Bir thumbnail kaynağı, bir dizi nesne içerir. Her bir nesnenin adı (default, medium, high vb.) küçük resmin boyutunu belirtir.
  • Farklı kaynak türleri, farklı küçük resim boyutlarını destekleyebilir.
  • Farklı kaynak türleri, aynı ada sahip küçük resimler için farklı boyutlar tanımlayabilir. Örneğin, bir video kaynağı için default küçük resmi genel olarak 120 piksele 90 pikseldir ve bir channel kaynağı için default küçük resmi genelde 88 x 88 pikseldir.
  • Aynı türdeki kaynaklar, orijinal resmin veya YouTube'a yüklenen içeriğin çözünürlüğüne bağlı olarak yine de belirli resimler için farklı küçük resim boyutlarına sahip olabilir. Örneğin, bir HD video, HD olmayan videolara göre daha yüksek çözünürlüklü küçük resimleri destekleyebilir.
  • Küçük resim boyutuyla ilgili bilgi içeren her nesnenin bir width ve height özelliği vardır. Ancak, söz konusu görsel için genişlik ve yükseklik özellikleri döndürülemez.
  • Yüklenen küçük resim gerekli boyutlarla eşleşmiyorsa en boy oranı değiştirilmeden resim doğru boyuta uyacak şekilde yeniden boyutlandırılır. Resim kırpılmamış, ancak boyutun doğru olması için siyah çubuklar içerebilir.

Yöntemler

API, thumbnails kaynakları için aşağıdaki yöntemleri destekler:

ayar
YouTube'a özel bir video küçük resmi yükler ve bunu bir video için ayarlar.

Kaynak temsili

Aşağıdaki JSON yapısı, thumbnails kaynağının biçimini gösterir:

{
  "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
  }
}

Özellikler

Aşağıdaki tabloda bu kaynakta görünen özellikler tanımlanmaktadır:

Özellikler
default object
Varsayılan küçük resim. Bir videonun (veya oynatma listesi öğesi ya da arama sonucu gibi bir videoya atıfta bulunan kaynağın) varsayılan küçük resmi 120 piksel genişliğinde ve 90 piksel yüksekliğindedir. Bir kanalın varsayılan küçük resmi, 88 piksel genişliğinde ve 88 piksel uzunluğundadır.
default.url string
Resmin URL'si.
default.width unsigned integer
Resmin genişliği.
default.height unsigned integer
Resmin yüksekliği.
medium object
Küçük resmin daha yüksek çözünürlüklü sürümü. Bir video (veya videoya atıfta bulunan bir kaynak) için bu resim 320 piksel genişliğinde ve 180 piksel yüksekliğindedir. Kanal için bu resim 240 piksel genişliğinde ve 240 piksel yüksekliğindedir.
medium.url string
Resmin URL'si.
medium.width unsigned integer
Resmin genişliği.
medium.height unsigned integer
Resmin yüksekliği.
high object
Küçük resmin yüksek çözünürlüklü sürümü. Bir video (veya videoya atıfta bulunan bir kaynak) için bu resim 480 piksel genişliğinde ve 360 piksel yüksekliğindedir. Kanal için bu resim 800 piksel genişliğinde ve 800 piksel uzunluğundadır.
high.url string
Resmin URL'si.
high.width unsigned integer
Resmin genişliği.
high.height unsigned integer
Resmin yüksekliği.
standard object
Küçük resmin high çözünürlüklü resimden daha da yüksek çözünürlüklü sürümü. Bu resim, bazı videolarda ve videolara atıfta bulunan diğer kaynaklarda (ör. oynatma listesi öğeleri veya arama sonuçları) kullanılabilir. Bu resim 640 piksel genişliğinde ve 480 piksel yüksekliğinde.
standard.url string
Resmin URL'si.
standard.width unsigned integer
Resmin genişliği.
standard.height unsigned integer
Resmin yüksekliği.
maxres object
Küçük resmin en yüksek çözünürlüklü sürümü. Bu resim boyutu, bazı videolarda ve videolara atıfta bulunan diğer kaynaklarda (ör. oynatma listesi öğeleri ya da arama sonuçları) kullanılabilir. Bu resim 1.280 piksel genişliğinde ve 720 piksel yüksekliğinde.
maxres.url string
Resmin URL'si.
maxres.width unsigned integer
Resmin genişliği.
maxres.height unsigned integer
Resmin yüksekliği.