Data API'yi, YouTube'un Shorts görüntülemelerini sayma şekliyle eşleşecek şekilde güncelliyoruz.
Daha fazla bilgi
Thumbnails
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
thumbnail kaynağı, bir kaynakla ilişkili farklı küçük resim boyutlarını tanımlar. Lütfen küçük resimlerin aşağıdaki özelliklerine dikkat edin:
- Bir kaynağın
snippet.thumbnails özelliği, söz konusu kaynak için kullanılabilen küçük resimleri tanımlayan bir nesnedir. thumbnail kaynağı bir dizi nesne içerir. Her nesnenin adı (default, medium, high vb.) küçük resim boyutunu ifade eder.- 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,
video kaynağının default küçük resim boyutu genellikle 120 piksel x 90 piksel, channel kaynağının default küçük resim boyutu ise genellikle 88 piksel x 88 pikseldir. - Aynı türdeki kaynaklar, YouTube'a yüklenen orijinal resmin veya içeriğin çözünürlüğüne bağlı olarak belirli resimler için farklı küçük resim boyutlarına sahip olabilir. Örneğin, HD videolar, HD olmayan videolara kıyasla daha yüksek çözünürlüklü küçük resimleri destekleyebilir.
- Küçük resim boyutuyla ilgili bilgileri içeren her nesnenin
width ve height özelliği vardır. Ancak genişlik ve yükseklik özellikleri bu resim için döndürülmeyebilir. - Yüklenen küçük resim, gerekli boyutlara uymuyorsa en boy oranı değiştirilmeden doğru boyuta göre yeniden boyutlandırılır. Resim kırpılmaz ancak boyutun doğru olması için siyah çubuklar içerebilir.
Yöntemler
API, thumbnails kaynakları için aşağıdaki yöntemleri destekler:
- set
- 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ında, thumbnails kaynağının biçimi gösterilmektedir:
{
"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 video veya videoya referans veren bir kaynak (ör. oynatma listesi öğesi ya da arama sonucu) için varsayılan küçük resim 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ü. Video (veya videoya atıfta bulunan bir kaynak) için bu resim 320 piksel genişliğinde ve 180 piksel yüksekliğindedir. Kanallar 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ü bir 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. Kanallar 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üklü resimden daha da yüksek çözünürlüklü bir sürümü. Bu resim, bazı videolar ve oynatma listesi öğeleri ya da arama sonuçları gibi videolara atıfta bulunan diğer kaynaklar için 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 ve videolara referans veren diğer kaynaklar (ör. oynatma listesi öğeleri veya arama sonuçları) için kullanılabilir. Bu resim 1.280 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. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-21 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-21 UTC."],[[["\u003cp\u003eA resource's \u003ccode\u003esnippet.thumbnails\u003c/code\u003e property contains an object, and each of these objects has properties such as \u003ccode\u003edefault\u003c/code\u003e, \u003ccode\u003emedium\u003c/code\u003e, and \u003ccode\u003ehigh\u003c/code\u003e, which identify the different available thumbnail image sizes for that specific resource.\u003c/p\u003e\n"],["\u003cp\u003eThumbnail image sizes can vary significantly between different resource types (e.g., videos vs. channels), and even among resources of the same type, based on the resolution of the original uploaded content.\u003c/p\u003e\n"],["\u003cp\u003eEach thumbnail image size object contains a \u003ccode\u003eurl\u003c/code\u003e, \u003ccode\u003ewidth\u003c/code\u003e, and \u003ccode\u003eheight\u003c/code\u003e property, but the width and height may not always be returned.\u003c/p\u003e\n"],["\u003cp\u003eWhen a custom thumbnail image is uploaded, it's resized to match the required dimensions without changing its aspect ratio, which may result in black bars being added.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ethumbnails\u003c/code\u003e resource offers various image size options, such as \u003ccode\u003edefault\u003c/code\u003e, \u003ccode\u003emedium\u003c/code\u003e, \u003ccode\u003ehigh\u003c/code\u003e, \u003ccode\u003estandard\u003c/code\u003e, and \u003ccode\u003emaxres\u003c/code\u003e, each with distinct resolutions to accommodate different display needs.\u003c/p\u003e\n"]]],["Thumbnail resources define various image sizes (`default`, `medium`, `high`, etc.) for different resource types. Image dimensions vary by resource type and resolution. The `thumbnails` resource is an object within `snippet.thumbnails` that holds size-specific objects, each with `url`, `width`, and `height` properties. The `set` method allows uploading a custom video thumbnail. When the dimensions don't match, the image is resized, maintaining its aspect ratio, with possible added black bars.\n"],null,["# Thumbnails\n\nA **thumbnail** resource identifies different thumbnail image sizes associated with a resource. Please note the following characteristics of thumbnail images:\n\n- A resource's `snippet.thumbnails` property is an object that identifies the thumbnail images available for that resource.\n- A `thumbnail` resource contains a series of objects. The name of each object (`default`, `medium`, `high`, etc.) refers to the thumbnail image size.\n- Different types of resources may support different thumbnail image sizes.\n- Different types of resources may define different sizes for thumbnail images with the same name. For example, the `default` thumbnail image for a `video` resource is typically 120px by 90px, and the `default` thumbnail image for a `channel` resource is typically 88px by 88px.\n- Resources of the same type may still have different thumbnail image sizes for certain images depending on the resolution of the original image or content uploaded to YouTube. For example, an HD video may support higher resolution thumbnails than non-HD videos.\n- Each object that contains information about a thumbnail image size has a `width` property and a `height` property. However, the width and height properties may not be returned for that image.\n- If an uploaded thumbnail image does not match the required dimensions, the image is resized to match the correct size without changing its aspect ratio. The image is not cropped, but may include black bars so that the size is correct.\n\n\u003cbr /\u003e\n\nMethods\n-------\n\nThe API supports the following methods for `thumbnails` resources:\n\n[set](/youtube/v3/docs/thumbnails/set)\n: Uploads a custom video thumbnail to YouTube and sets it for a video.\n\nResource representation\n-----------------------\n\nThe following JSON structure shows the format of a `thumbnails` resource: \n\n```text\n{\n \"default\": {\n \"url\": string,\n \"width\": unsigned integer,\n \"height\": unsigned integer\n },\n \"medium\": {\n \"url\": string,\n \"width\": unsigned integer,\n \"height\": unsigned integer\n },\n \"high\": {\n \"url\": string,\n \"width\": unsigned integer,\n \"height\": unsigned integer\n },\n \"standard\": {\n \"url\": string,\n \"width\": unsigned integer,\n \"height\": unsigned integer\n },\n \"maxres\": {\n \"url\": string,\n \"width\": unsigned integer,\n \"height\": unsigned integer\n }\n}\n```\n\n### Properties\n\nThe following table defines the properties that appear in this resource:\n\n| Properties ||\n|-------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `default` | `object` The default thumbnail image. The default thumbnail for a video -- or a resource that refers to a video, such as a playlist item or search result -- is 120px wide and 90px tall. The default thumbnail for a channel is 88px wide and 88px tall. |\n| default.`url` | `string` The image's URL. |\n| default.`width` | `unsigned integer` The image's width. |\n| default.`height` | `unsigned integer` The image's height. |\n| `medium` | `object` A higher resolution version of the thumbnail image. For a video (or a resource that refers to a video), this image is 320px wide and 180px tall. For a channel, this image is 240px wide and 240px tall. |\n| medium.`url` | `string` The image's URL. |\n| medium.`width` | `unsigned integer` The image's width. |\n| medium.`height` | `unsigned integer` The image's height. |\n| `high` | `object` A high resolution version of the thumbnail image. For a video (or a resource that refers to a video), this image is 480px wide and 360px tall. For a channel, this image is 800px wide and 800px tall. |\n| high.`url` | `string` The image's URL. |\n| high.`width` | `unsigned integer` The image's width. |\n| high.`height` | `unsigned integer` The image's height. |\n| `standard` | `object` An even higher resolution version of the thumbnail image than the `high` resolution image. This image is available for some videos and other resources that refer to videos, like playlist items or search results. This image is 640px wide and 480px tall. |\n| standard.`url` | `string` The image's URL. |\n| standard.`width` | `unsigned integer` The image's width. |\n| standard.`height` | `unsigned integer` The image's height. |\n| `maxres` | `object` The highest resolution version of the thumbnail image. This image size is available for some videos and other resources that refer to videos, like playlist items or search results. This image is 1280px wide and 720px tall. |\n| maxres.`url` | `string` The image's URL. |\n| maxres.`width` | `unsigned integer` The image's width. |\n| maxres.`height` | `unsigned integer` The image's height. |"]]
