Thumbnails

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