Thumbnails

thumbnail kaynağı, bir kaynakla ilişkili farklı küçük resim boyutlarını tanımlar. Küçük resim görsellerinin aşağıdaki özelliklerine lütfen dikkat edin:

  • Bir kaynağın snippet.thumbnails özelliği, söz konusu kaynak için kullanılabilen küçük resim resimlerini tanımlayan bir nesnedir.
  • thumbnail kaynağı, bir dizi nesne içerir. Her bir nesnenin adı (default, medium, high vb.) küçük resmin boyutunu ifade eder.
  • Farklı kaynak türleri, farklı küçük resim boyutlarını destekleyebilir.
  • Farklı kaynak türleri, aynı ada sahip küçük resim görselleri için farklı boyutlar tanımlayabilir. Örneğin, bir video kaynağının default küçük resmi genellikle 120x90 piksel, channel kaynağı için default küçük resim resmi ise 88 piksele 88 pikseldir.
  • YouTube'a yüklenen orijinal resmin veya içeriğin çözünürlüğüne bağlı olarak, aynı türdeki kaynaklar belirli resimler için farklı küçük resim boyutlarına sahip olabilir. Örneğin, bir HD video, HD olmayan videolardan daha yüksek çözünürlüklü küçük resimleri destekleyebilir.
  • Küçük resim boyutu hakkında bilgi içeren her nesne, bir width ve height özelliğine sahiptir. Ancak genişlik ve yükseklik özellikleri söz konusu resim için döndürülmeyebilir.
  • Yüklenen bir küçük resim gerekli boyutlarla eşleşmezse resim, en boy oranı değişmeden 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:

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

Kaynak temsili

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

{
  "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 yüksekliğindedir.
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ü bir sürümü. Bir video (veya bir videoya atıfta bulunan kaynaklar) için bu resim 320 piksel genişliğinde ve 180 piksel yüksekliğinde. Bir 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 bir videoya referans veren 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 yüksekliğindedir.
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ük resminden bile daha yüksek çözünürlüklü bir 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ğindedir.
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ı videoların yanı sıra oynatma listeleri veya arama sonuçları gibi videolara atıfta bulunan diğer kaynaklar için kullanılabilir. Bu resim 1280 piksel genişliğinde ve 720 piksel yüksekliğindedir.
maxres.url string
Resmin URL'si.
maxres.width unsigned integer
Resmin genişliği.
maxres.height unsigned integer
Resmin yüksekliği.