Resource thumbnail
mengidentifikasi berbagai ukuran gambar thumbnail yang terkait dengan satu resource. Harap perhatikan karakteristik gambar thumbnail berikut:
- Properti
snippet.thumbnails
resource adalah objek yang mengidentifikasi gambar thumbnail yang tersedia untuk resource tersebut. - Resource
thumbnail
berisi serangkaian objek. Nama setiap objek (default
,medium
,high
, dll.) merujuk pada ukuran gambar thumbnail. - Berbagai jenis resource mungkin mendukung ukuran gambar thumbnail yang berbeda-beda.
- Berbagai jenis resource dapat mendefinisikan ukuran yang berbeda untuk gambar thumbnail dengan nama yang sama. Misalnya, gambar thumbnail
default
untuk resourcevideo
biasanya berukuran 120 x 90 piksel, dan gambar thumbnaildefault
untuk resourcechannel
biasanya berukuran 88 x 88 piksel. - Resource dari jenis yang sama mungkin masih memiliki ukuran gambar thumbnail yang berbeda untuk gambar tertentu, bergantung pada resolusi gambar asli atau konten yang diupload ke YouTube. Misalnya, video HD dapat mendukung thumbnail dengan resolusi yang lebih tinggi daripada video non-HD.
- Setiap objek yang berisi informasi tentang ukuran gambar thumbnail memiliki properti
width
dan propertiheight
. Namun, properti lebar dan tinggi mungkin tidak dikembalikan untuk gambar tersebut. - Jika gambar thumbnail yang diupload tidak sesuai dengan dimensi yang diperlukan, gambar akan diubah ukurannya agar sesuai dengan ukuran yang tepat tanpa mengubah rasio lebar tingginya. Gambar tidak dipangkas, tetapi dapat menyertakan batang hitam sehingga ukurannya benar.
Metode
API mendukung metode berikut untuk resource thumbnails
:
- setel
- Mengupload thumbnail video kustom ke YouTube dan menyetelnya untuk video.
Representasi resource
Struktur JSON berikut menunjukkan format resource 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 } }
Properti
Tabel berikut menentukan properti yang muncul di resource ini:
Properti | |
---|---|
default |
object Gambar thumbnail default. Thumbnail default untuk video – atau resource yang merujuk pada video, seperti item playlist atau hasil penelusuran – memiliki lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk channel adalah lebar 88 piksel dan tinggi 88 piksel. |
default.url |
string URL gambar. |
default.width |
unsigned integer Lebar gambar. |
default.height |
unsigned integer Tinggi gambar. |
medium |
object Versi thumbnail yang beresolusi lebih tinggi. Untuk video (atau resource yang merujuk ke video), gambar ini memiliki lebar 320px dan tinggi 180px. Untuk channel, gambar ini memiliki lebar 240px dan tinggi 240px. |
medium.url |
string URL gambar. |
medium.width |
unsigned integer Lebar gambar. |
medium.height |
unsigned integer Tinggi gambar. |
high |
object Versi thumbnail gambar beresolusi tinggi. Untuk video (atau resource yang merujuk pada video), gambar ini memiliki lebar 480px dan tinggi 360px. Untuk channel, gambar ini memiliki lebar 800 piksel dan tinggi 800 piksel. |
high.url |
string URL gambar. |
high.width |
unsigned integer Lebar gambar. |
high.height |
unsigned integer Tinggi gambar. |
standard |
object Versi thumbnail gambar beresolusi lebih tinggi daripada gambar resolusi high . Gambar ini tersedia untuk beberapa video dan resource lain yang mengacu pada video, seperti item playlist atau hasil penelusuran. Gambar ini memiliki lebar 640 piksel dan tinggi 480 piksel. |
standard.url |
string URL gambar. |
standard.width |
unsigned integer Lebar gambar. |
standard.height |
unsigned integer Tinggi gambar. |
maxres |
object Versi thumbnail gambar dengan resolusi tertinggi. Ukuran gambar ini tersedia untuk beberapa video dan resource lain yang merujuk ke video, seperti item playlist atau hasil penelusuran. Gambar ini memiliki lebar 1280 piksel dan tinggi 720 piksel. |
maxres.url |
string URL gambar. |
maxres.width |
unsigned integer Lebar gambar. |
maxres.height |
unsigned integer Tinggi gambar. |