Playlists

Resource playlist mewakili playlist YouTube. Playlist adalah kumpulan video yang dapat ditonton secara berurutan dan dibagikan kepada pengguna lain. Secara default, playlist dapat dilihat oleh pengguna lain, tetapi playlist dapat disetel untuk publik atau pribadi.

YouTube juga menggunakan playlist untuk mengidentifikasi koleksi video khusus untuk channel, seperti:

  • video yang diupload
  • video dengan rating positif (disukai)
Untuk lebih spesifiknya, daftar ini terkait dengan channel, yang merupakan kumpulan video orang, grup, atau perusahaan, playlist, dan informasi YouTube lainnya. Anda dapat mengambil ID playlist untuk setiap daftar ini dari channel resource untuk saluran tertentu.

Anda kemudian dapat menggunakan metode playlistItems.list untuk mengambil salah satu dari daftar tersebut. Anda juga dapat menambahkan atau menghapus item dari daftar tersebut dengan memanggil metode playlistItems.insert dan playlistItems.delete.

Metode

API mendukung metode berikut untuk resource playlists:

list
Menampilkan koleksi playlist yang cocok dengan parameter permintaan API. Misalnya, Anda dapat mengambil semua playlist yang dimiliki pengguna terautentikasi, atau Anda dapat mengambil satu atau beberapa playlist menurut ID uniknya. Coba sekarang.
masukkan
Membuat playlist. Coba sekarang.
perbarui
Memodifikasi playlist. Misalnya, Anda dapat mengubah judul, deskripsi, atau status privasi playlist. Coba sekarang.
hapus
Menghapus playlist. Coba sekarang.

Representasi resource

Struktur JSON berikut menunjukkan format resource playlists:

{
  "kind": "youtube#playlist",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    }
  },
  "status": {
    "privacyStatus": string
  },
  "contentDetails": {
    "itemCount": unsigned integer
  },
  "player": {
    "embedHtml": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Properti

Tabel berikut menentukan properti yang muncul di resource ini:

Properti
kind string
Mengidentifikasi jenis resource API. Nilainya adalah youtube#playlist.
etag etag
Etag resource ini.
id string
ID yang digunakan YouTube untuk mengidentifikasi playlist secara unik.
snippet object
Objek snippet berisi detail dasar tentang playlist, seperti judul dan deskripsinya.
snippet.publishedAt datetime
Tanggal dan waktu playlist dibuat. Nilai ditetapkan dalam format ISO 8601.
snippet.channelId string
ID yang digunakan YouTube untuk mengidentifikasi channel yang memublikasikan playlist secara unik.
snippet.title string
Judul playlist.
snippet.description string
Deskripsi playlist.
snippet.thumbnails object
Peta gambar thumbnail yang terkait dengan playlist. Untuk setiap objek di peta, kuncinya adalah nama gambar thumbnail, dan nilainya adalah objek yang berisi informasi lain tentang thumbnail.
snippet.thumbnails.(key) object
Nilai kunci yang valid adalah:
  • default – 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.
  • medium – Versi gambar 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.
  • high – Versi thumbnail dengan resolusi 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.
  • standard – Versi gambar thumbnail 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.
  • maxres – Versi gambar thumbnail 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.
snippet.thumbnails.(key).url string
URL gambar.
snippet.thumbnails.(key).width unsigned integer
Lebar gambar.
snippet.thumbnails.(key).height unsigned integer
Tinggi gambar.
snippet.channelTitle string
Judul channel yang mencakup video tersebut.
snippet.tags[] list
Properti ini tidak digunakan lagi.

Tag kata kunci yang terkait dengan playlist.
snippet.defaultLanguage string
Bahasa teks di properti snippet.title dan snippet.description resource playlist.
snippet.localized object
Objek snippet.localized berisi judul dan deskripsi yang dilokalkan untuk playlist atau judul dalam bahasa default untuk metadata playlist.
  • Teks yang dilokalkan ditampilkan dalam cuplikan resource jika permintaan playlists.list menggunakan parameter hl untuk menentukan bahasa yang teksnya harus dilokalkan dan teks yang dilokalkan tersedia dalam bahasa itu.
  • Metadata untuk bahasa default ditampilkan jika nilai parameter hl tidak ditentukan atau nilai ditentukan, tetapi metadata yang dilokalkan tidak tersedia untuk bahasa yang ditentukan.
Properti ini berisi nilai hanya baca. Gunakan objek localizations untuk menambahkan, memperbarui, atau menghapus judul yang dilokalkan.
snippet.localized.title string
Judul playlist yang dilokalkan.
snippet.localized.description string
Deskripsi playlist yang dilokalkan.
status object
Objek status berisi informasi status untuk playlist.
status.privacyStatus string
Status privasi playlist.

Nilai yang valid untuk properti ini adalah:
  • private
  • public
  • unlisted
contentDetails object
Objek contentDetails berisi informasi tentang konten playlist, termasuk jumlah video dalam playlist.
contentDetails.itemCount unsigned integer
Jumlah video dalam playlist.
player object
Objek player berisi informasi yang akan Anda gunakan untuk memutar playlist di pemutar tersemat.
player.embedHtml string
Tag <iframe> yang menyematkan pemutar yang akan memutar playlist.
localizations object
Objek localizations mengenkapsulasi terjemahan metadata playlist.
localizations.(key) object
Bahasa teks yang dilokalkan yang terkait dengan nilai kunci. Nilainya adalah string yang berisi kode bahasa BCP-47.
localizations.(key).title string
Judul playlist yang dilokalkan.
localizations.(key).description string
Deskripsi playlist yang dilokalkan.