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 secara publik oleh pengguna lain, tetapi playlist dapat disetel ke publik atau pribadi.

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

  • video yang diupload
  • video yang diberi rating positif (disukai)
Lebih spesifiknya, daftar ini dikaitkan dengan channel, yang merupakan kumpulan video, playlist, dan informasi YouTube lainnya dari seseorang, grup, atau perusahaan. Anda dapat mengambil ID playlist untuk setiap daftar ini dari channel resource untuk channel tertentu.

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

Metode

API ini mendukung metode berikut untuk resource playlists:

list
Menampilkan kumpulan 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 berdasarkan ID uniknya. Coba sekarang.
insert
Membuat playlist. Coba sekarang.
update
Mengubah 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,
    "podcastStatus": enum
  },
  "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 daftar putar secara unik.
snippet object
Objek snippet berisi detail dasar tentang playlist, seperti judul dan deskripsinya.
snippet.publishedAt datetime
Tanggal dan waktu playlist dibuat. Nilai ditentukan dalam format ISO 8601.
snippet.channelId string
ID yang digunakan YouTube untuk mengidentifikasi secara unik channel yang memublikasikan playlist.
snippet.title string
Judul playlist.
snippet.description string
Deskripsi playlist.
snippet.thumbnails object
Peta gambar thumbnail yang terkait dengan playlist. Untuk setiap objek dalam 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 ke video, seperti item playlist atau hasil penelusuran – memiliki lebar 120 piksel dan tinggi 90 piksel. Thumbnail default untuk channel memiliki lebar 88 px dan tinggi 88 px.
  • medium – Versi gambar thumbnail dengan resolusi lebih tinggi. Untuk video (atau resource yang merujuk ke video), gambar ini memiliki lebar 320 px dan tinggi 180 px. Untuk channel, gambar ini berukuran lebar 240 piksel dan tinggi 240 piksel.
  • high – Versi gambar thumbnail beresolusi tinggi. Untuk video (atau resource yang merujuk ke video), gambar ini memiliki lebar 480 px dan tinggi 360 px. Untuk channel, gambar ini memiliki lebar 800 piksel dan tinggi 800 piksel.
  • standard – Versi gambar thumbnail dengan resolusi yang lebih tinggi daripada gambar resolusi high. Gambar ini tersedia untuk beberapa video dan resource lain yang merujuk ke video, seperti item playlist atau hasil penelusuran. Gambar ini memiliki lebar 640 piksel dan tinggi 480 piksel.
  • maxres – Versi gambar thumbnail 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.
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 memiliki video tersebut.
snippet.tags[] list
Properti ini tidak digunakan lagi.

Tag kata kunci yang terkait dengan playlist.
snippet.defaultLanguage string
Bahasa teks dalam 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 tersebut.
  • 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 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 daftar putar.

Nilai yang valid untuk properti ini adalah:
  • private
  • public
  • unlisted
status.podcastStatus string
Status podcast playlist. Jika nilainya adalah enabled, playlist akan ditandai sebagai acara podcast. Untuk menyetel status podcast playlist ke enabled, playlist harus memiliki gambar playlist.

Nilai yang valid untuk properti ini adalah:
  • enabled
  • disabled
  • unspecified
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 yang disematkan.
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.