Resource thumbnail
mengidentifikasi berbagai ukuran gambar thumbnail yang terkait dengan 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.) mengacu pada ukuran gambar thumbnail. - Jenis resource yang berbeda mungkin mendukung ukuran gambar thumbnail yang berbeda.
- Jenis resource yang berbeda dapat menentukan ukuran yang berbeda untuk gambar thumbnail dengan nama yang sama. Misalnya, gambar thumbnail
default
untuk resourcevideo
biasanya berukuran 120x90 piksel, dan gambar thumbnaildefault
untuk resourcechannel
biasanya berukuran 88x88 piksel. - Aset dengan 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 mungkin mendukung thumbnail beresolusi 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 ditampilkan untuk gambar tersebut. - Jika gambar thumbnail yang diupload tidak sesuai dengan dimensi yang diperlukan, gambar akan diubah ukurannya agar sesuai dengan ukuran yang benar tanpa mengubah rasio aspeknya. Gambar tidak dipangkas, namun mungkin terdapat kotak hitam agar ukurannya benar.
Metode
API ini mendukung metode berikut untuk resource thumbnails
:
- kumpulan
- Mengupload thumbnail video kustom ke YouTube dan menyetelnya untuk video.
Representasi resource
Struktur JSON berikut menampilkan 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 mendefinisikan properti yang muncul di resource ini:
Properti | |
---|---|
default |
object Gambar thumbnail default. Thumbnail default untuk video – atau referensi yang merujuk ke video, seperti item playlist atau hasil penelusuran – adalah lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk saluran adalah lebar 88px dan tinggi 88px. |
default.url |
string URL gambar. |
default.width |
unsigned integer Lebar gambar. |
default.height |
unsigned integer Tinggi gambar. |
medium |
object Versi gambar thumbnail beresolusi lebih tinggi. Untuk video (atau sumber daya yang merujuk pada 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 gambar thumbnail beresolusi tinggi. Untuk video (atau sumber daya 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 gambar thumbnail beresolusi lebih tinggi daripada gambar beresolusi high . Gambar ini tersedia untuk beberapa video dan referensi lain yang merujuk ke video, seperti item playlist atau hasil penelusuran. Gambar ini memiliki lebar 640px dan tinggi 480px. |
standard.url |
string URL gambar. |
standard.width |
unsigned integer Lebar gambar. |
standard.height |
unsigned integer Tinggi gambar. |
maxres |
object Versi gambar thumbnail beresolusi 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 1280px dan tinggi 720px. |
maxres.url |
string URL gambar. |
maxres.width |
unsigned integer Lebar gambar. |
maxres.height |
unsigned integer Tinggi gambar. |