Thumbnails

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 resource video biasanya berukuran 120 x 90 piksel, dan gambar thumbnail default untuk resource channel 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 properti height. 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.