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ındefault
küçük resmi genellikle 120x90 piksel,channel
kaynağı içindefault
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
veheight
ö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. |